NotifyIcon.ShowBalloonTip メソッド
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
タスクバーにバルーン ヒントを表示します。
オーバーロード
| ShowBalloonTip(Int32) |
指定した期間、タスクバーにバルーン ヒントを表示します。 |
| ShowBalloonTip(Int32, String, String, ToolTipIcon) |
指定したタイトル、テキスト、およびアイコンのバルーン ヒントが、指定した時間、タスク バーに表示されます。 |
ShowBalloonTip(Int32)
指定した期間、タスクバーにバルーン ヒントを表示します。
public:
void ShowBalloonTip(int timeout);public void ShowBalloonTip (int timeout);member this.ShowBalloonTip : int -> unitPublic Sub ShowBalloonTip (timeout As Integer)パラメーター
- timeout
- Int32
バルーン ヒントを表示する時間 (ミリ秒単位)。 このパラメーターは非推奨となりました。 現在、通知の表示時間は、システムのアクセシビリティ設定に基づいています。
例外
timeout が 0 未満です。
例
次のコード例は、ShowBalloonTip メソッドの使用方法を示します。 この例を実行するには、 という名前notifyIcon1の を含む Windows フォームにサンプル コードをNotifyIcon貼り付けます。 フォームのコンストラクターまたはLoadイベント処理メソッドから を呼び出SetBalloonTipします。
private void SetBalloonTip()
{
notifyIcon1.Icon = SystemIcons.Exclamation;
notifyIcon1.BalloonTipTitle = "Balloon Tip Title";
notifyIcon1.BalloonTipText = "Balloon Tip Text.";
notifyIcon1.BalloonTipIcon = ToolTipIcon.Error;
this.Click += new EventHandler(Form1_Click);
}
void Form1_Click(object sender, EventArgs e)
{
notifyIcon1.Visible = true;
notifyIcon1.ShowBalloonTip(30000);
}
Private Sub SetBalloonTip()
notifyIcon1.Icon = SystemIcons.Exclamation
notifyIcon1.BalloonTipTitle = "Balloon Tip Title"
notifyIcon1.BalloonTipText = "Balloon Tip Text."
notifyIcon1.BalloonTipIcon = ToolTipIcon.Error
End Sub
Sub Form1_Click(ByVal sender As Object, ByVal e As EventArgs) _
Handles Me.Click
notifyIcon1.Visible = True
notifyIcon1.ShowBalloonTip(30000)
End Sub
注釈
最小タイムアウト値と最大タイムアウト値はオペレーティング システムによって適用され、通常は 10 秒と 30 秒ですが、これはオペレーティング システムによって異なる場合があります。 タイムアウト値が大きすぎるか小さすぎる場合は、適切な最小値または最大値に調整されます。 さらに、ユーザーがコンピューターを使用していない (キーボードまたはマウスイベントが発生していない) 場合、システムはこの時間をタイムアウトにカウントしません。
タスク バーに一度に表示できるバルーン ヒントは 1 つだけです。 現在タスク バーにバルーン ヒントが表示されている場合にバルーン ヒントを表示しようとすると、値が timeout 無視されます。 動作は、オペレーティング システムと、バルーン ヒントが別のアプリケーションからのものか、同じアプリケーションからのものかによって若干異なります。 2 番目のバルーン ヒントが別のアプリケーションからの場合、 の値に関係なく、2 番目のバルーン ヒントが表示される前の最小タイムアウト値に対して最初の timeoutバルーン ヒントが表示されます。 ほとんどの場合、バルーンヒントが同じアプリケーションからの場合、メソッドの別の呼び出し ShowBalloonTip が行われると、最初のバルーンヒントはすぐに閉じます。 場合によっては、2 番目のバルーンが最初のバルーンの上に開きます。
タイトル テキストは、吹き出しの上部付近に太字で表示されます。
適用対象
ShowBalloonTip(Int32, String, String, ToolTipIcon)
指定したタイトル、テキスト、およびアイコンのバルーン ヒントが、指定した時間、タスク バーに表示されます。
public:
void ShowBalloonTip(int timeout, System::String ^ tipTitle, System::String ^ tipText, System::Windows::Forms::ToolTipIcon tipIcon);public void ShowBalloonTip (int timeout, string tipTitle, string tipText, System.Windows.Forms.ToolTipIcon tipIcon);member this.ShowBalloonTip : int * string * string * System.Windows.Forms.ToolTipIcon -> unitPublic Sub ShowBalloonTip (timeout As Integer, tipTitle As String, tipText As String, tipIcon As ToolTipIcon)パラメーター
- timeout
- Int32
バルーン ヒントを表示する時間 (ミリ秒単位)。 このパラメーターは非推奨となりました。 現在、通知の表示時間は、システムのアクセシビリティ設定に基づいています。
- tipTitle
- String
バルーン ヒントに表示するタイトル。
- tipText
- String
バルーン ヒントに表示するテキスト。
- tipIcon
- ToolTipIcon
ToolTipIcon 値のいずれか 1 つ。
例外
timeout が 0 未満です。
tipText が null または空の文字列です。
tipIcon が ToolTipIcon のメンバーではありません。
例
次のコード例は、ShowBalloonTip メソッドの使用方法を示します。 この例を実行するには、 という名前notifyIcon1の を含む Windows フォームにサンプル コードをNotifyIcon貼り付けます。 この例の Form1_DoubleClick メソッドをフォームの DoubleClick イベントに関連付けます。
void Form1_DoubleClick(object sender, EventArgs e)
{
notifyIcon1.Visible = true;
notifyIcon1.ShowBalloonTip(20000, "Information", "This is the text",
ToolTipIcon.Info );
}
Sub Form1_DoubleClick(ByVal sender As Object, ByVal e As EventArgs) _
Handles Me.DoubleClick
notifyIcon1.Visible = True
notifyIcon1.ShowBalloonTip(20000, "Information", "This is the text", _
ToolTipIcon.Info)
End Sub
注釈
最小タイムアウト値と最大タイムアウト値はオペレーティング システムによって適用され、通常は 10 秒と 30 秒ですが、これはオペレーティング システムによって異なる場合があります。 タイムアウト値が大きすぎるか小さすぎる場合は、適切な最小値または最大値に調整されます。 さらに、ユーザーがコンピューターを使用していない (キーボードまたはマウスイベントが発生していない) 場合、システムはこの時間をタイムアウトにカウントしません。
タスク バーに一度に表示できるバルーン ヒントは 1 つだけです。 現在タスク バーにバルーン ヒントが表示されている場合にバルーン ヒントを表示しようとすると、値が timeout 無視されます。 動作は、オペレーティング システムと、バルーン ヒントが別のアプリケーションからのものか、同じアプリケーションからのものかによって若干異なります。 2 番目のバルーン ヒントが別のアプリケーションからの場合、 の値に関係なく、2 番目のバルーン ヒントが表示される前の最小タイムアウト値に対して最初の timeoutバルーン ヒントが表示されます。 ほとんどの場合、バルーンヒントが同じアプリケーションからの場合、メソッドの別の呼び出し ShowBalloonTip が行われると、最初のバルーンヒントはすぐに閉じます。 場合によっては、2 番目のバルーンが最初のバルーンの上に開きます。
タイトル テキストは、吹き出しの上部付近に太字で表示されます。
適用対象
.NET