NotifyIcon.ShowBalloonTip メソッド

定義

名前空間:
System.Windows.Forms
アセンブリ:
System.Windows.Forms.dll

タスク バーに吹き出しのヒントを表示します。

オーバーロード

名前 説明
ShowBalloonTip(Int32)

指定した期間のバルーン ヒントをタスク バーに表示します。
ShowBalloonTip(Int32, String, String, ToolTipIcon)

指定した期間、タスク バーに指定したタイトル、テキスト、アイコンを含む吹き出しのヒントを表示します。

ShowBalloonTip(Int32)

ソース:
NotifyIcon.cs
ソース:
NotifyIcon.cs
ソース:
NotifyIcon.cs
ソース:
NotifyIcon.cs
ソース:
NotifyIcon.cs

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

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 メソッドの使用方法を示しています。 この例を実行するには、NotifyIconnotifyIcon1 という名前の Windows フォームにサンプル コードを貼り付けます。 フォームのコンストラクターまたはイベント処理メソッドからSetBalloonTipLoad呼び出します。

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 番目のバルーン ヒントが別のアプリケーションからの場合は、 timeoutの値に関係なく、2 番目のバルーン ヒントが表示される前の最小タイムアウト値が表示されます。 ほとんどの場合、バルーン ヒントが同じアプリケーションからの場合、 ShowBalloonTip メソッドへの別の呼び出しが行われると、最初のバルーン ヒントがすぐに閉じます。 場合によっては、2 番目のバルーンが最初のバルーンの上に開きます。

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

適用対象

ShowBalloonTip(Int32, String, String, ToolTipIcon)

ソース:
NotifyIcon.cs
ソース:
NotifyIcon.cs
ソース:
NotifyIcon.cs
ソース:
NotifyIcon.cs
ソース:
NotifyIcon.cs

指定した期間、タスク バーに指定したタイトル、テキスト、アイコンを含む吹き出しのヒントを表示します。

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 メソッドの使用方法を示しています。 この例を実行するには、NotifyIconnotifyIcon1 という名前の Windows フォームにサンプル コードを貼り付けます。 この例の 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 番目のバルーン ヒントが別のアプリケーションからの場合は、 timeoutの値に関係なく、2 番目のバルーン ヒントが表示される前の最小タイムアウト値が表示されます。 ほとんどの場合、バルーン ヒントが同じアプリケーションからの場合、 ShowBalloonTip メソッドへの別の呼び出しが行われると、最初のバルーン ヒントがすぐに閉じます。 場合によっては、2 番目のバルーンが最初のバルーンの上に開きます。

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

適用対象