NotifyIcon.ShowBalloonTip メソッド

定義

名前空間:

System.Windows.Forms

アセンブリ:

System.Windows.Forms.dll

タスクバーにバルーン ヒントを表示します。

オーバーロード

ShowBalloonTip(Int32)	指定した期間、タスクバーにバルーン ヒントを表示します。
ShowBalloonTip(Int32, String, String, ToolTipIcon)	指定したタイトル、テキスト、およびアイコンのバルーン ヒントが、指定した時間、タスク バーに表示されます。

ShowBalloonTip(Int32)

指定した期間、タスクバーにバルーン ヒントを表示します。

public:
 void ShowBalloonTip(int timeout);

public void ShowBalloonTip (int timeout);

member this.ShowBalloonTip : int -> unit

Public Sub ShowBalloonTip (timeout As Integer)

パラメーター

timeout

Int32

バルーン ヒントを表示する時間 (ミリ秒単位)。 このパラメーターは非推奨となりました。 現在、通知の表示時間は、システムのアクセシビリティ設定に基づいています。

例外

ArgumentOutOfRangeException

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 -> unit

Public Sub ShowBalloonTip (timeout As Integer, tipTitle As String, tipText As String, tipIcon As ToolTipIcon)

パラメーター

timeout

Int32

バルーン ヒントを表示する時間 (ミリ秒単位)。 このパラメーターは非推奨となりました。 現在、通知の表示時間は、システムのアクセシビリティ設定に基づいています。

tipTitle

String

バルーン ヒントに表示するタイトル。

tipText

String

バルーン ヒントに表示するテキスト。

tipIcon

ToolTipIcon

ToolTipIcon 値のいずれか 1 つ。

例外

ArgumentOutOfRangeException

timeout が 0 未満です。

ArgumentException

tipText が null または空の文字列です。

InvalidEnumArgumentException

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 番目のバルーンが最初のバルーンの上に開きます。

タイトル テキストは、吹き出しの上部付近に太字で表示されます。