NotifyIcon.ShowBalloonTip メソッド (Int32) (System.Windows.Forms)

.NET Framework クラスライブラリ

NotifyIcon.ShowBalloonTip メソッド (Int32)

メモ : このメソッドは、.NET Framework version 2.0 で新しく追加されたものです。

タスクバーにバルーンヒントを指定された時間だけ表示します。

名前空間: System.Windows.Forms
アセンブリ: System.Windows.Forms (system.windows.forms.dll 内)

構文

Visual Basic (宣言)

Public Sub ShowBalloonTip ( _
    timeout As Integer _
)

Visual Basic (使用法)

Dim instance As NotifyIcon
Dim timeout As Integer

instance.ShowBalloonTip(timeout)

public void ShowBalloonTip (
    int timeout
)

C++

public:
void ShowBalloonTip (
    int timeout
)

public void ShowBalloonTip (
    int timeout
)

JScript

public function ShowBalloonTip (
    timeout : int
)

パラメータ

timeout: バルーンヒントを表示する時間 (ミリ秒単位)。

解説

オペレーティングシステムによって適用される最小タイムアウト値は 10 秒、最大タイムアウト値は 30 秒です。ただし、この値はオペレーティングシステムによって異なる場合があります。タイムアウト値が大きすぎる、または小さすぎる場合、適切な最小値または最大値に修正されます。また、ユーザーがコンピュータを使用していないと思われる場合 (つまり、キーボードイベントもマウスイベントも発生しない場合)、この時間がタイムアウトにカウントされることはありません。

タスクバーで一度に表示できるバルーンヒントは 1 つのみです。タスクバーにバルーンヒントが表示されているときに、さらにバルーンヒントを表示しようとすると、timeout 値が無視されます。この動作は、別のアプリケーションによるバルーンヒントの場合と、同じアプリケーションによるバルーンヒントの場合で少し変わります。2 番目のバルーンヒントが別のアプリケーションによるものである場合、1 番目のバルーンヒントが最小タイムアウト値の間表示された後、2 番目のバルーンヒントが表示されます。timeout. の値は関係ありません。どちらのバルーンヒントも同じアプリケーションによるものである場合、ShowBalloonTip メソッドが呼び出されると、1 番目のバルーンヒントがすぐに閉じられます。

タイトルテキストは、バルーンの上部に太字フォントで表示されます。

使用例

ShowBalloonTip メソッドを使用する方法を次のコード例に示します。この例を実行するには、notifyIcon1 という名前の NotifyIcon が配置されている Windows フォームに、次のコード例を貼り付けます。次に、フォームのコンストラクタまたは Load のイベント処理メソッドで SetBalloonTip を呼び出します。

Visual Basic

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(30)

End Sub

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(30);

}

プラットフォーム

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework

サポート対象 : 2.0

参照

パラメータ

.NET Framework

関連項目