Sdílet prostřednictvím

NotifyIcon.ShowBalloonTip Metoda

  • Reference

Definice

Obor názvů:
System.Windows.Forms
Sestavení:
System.Windows.Forms.dll

Zobrazí bublinový tip na hlavním panelu.

Přetížení

ShowBalloonTip(Int32)

Zobrazí bublinový tip na hlavním panelu pro zadané časové období.
ShowBalloonTip(Int32, String, String, ToolTipIcon)

Zobrazí bublinový tip se zadaným názvem, textem a ikonou na hlavním panelu pro zadané časové období.

ShowBalloonTip(Int32)

Zobrazí bublinový tip na hlavním panelu pro zadané časové období.

public:
 void ShowBalloonTip(int timeout);
public void ShowBalloonTip (int timeout);
member this.ShowBalloonTip : int -> unit
Public Sub ShowBalloonTip (timeout As Integer)

Parametry

timeout
Int32

Časové období v milisekundách by se měla zobrazit bublinová špička. Tento parametr je zastaralý. Časy zobrazení oznámení jsou teď založené na nastavení přístupnosti systému.

Výjimky

ArgumentOutOfRangeException

timeout je menší než 0.

Příklady

Následující příklad kódu ukazuje, jak použít metodu ShowBalloonTip . Chcete-li spustit tento příklad, vložte ukázkový kód do formuláře Windows, který obsahuje pojmenovaný NotifyIconnotifyIcon1. Volání SetBalloonTip z konstruktoru formuláře nebo Load metody zpracování událostí

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

Poznámky

Minimální a maximální hodnoty časového limitu jsou vynuceny operačním systémem a obvykle jsou 10 a 30 sekund, ale může se lišit v závislosti na operačním systému. Hodnoty časového limitu, které jsou příliš velké nebo příliš malé, se upraví na odpovídající minimální nebo maximální hodnotu. Pokud se navíc zdá, že uživatel počítač nepoužívá (nedochází k žádným událostem klávesnice nebo myši), systém tento čas do vypršení časového limitu nezapočítá.

Na hlavním panelu se může najednou zobrazovat jenom jeden bublinový tip. Pokus o zobrazení bublinového tipu, když je aktuálně zobrazen na hlavním panelu, způsobí ignorování timeout hodnoty. Chování se mírně liší v závislosti na operačním systému a na tom, jestli je bublinová špička z jiné nebo stejné aplikace. Pokud je druhý bublinový tip z jiné aplikace, zobrazí se první bublinový tip s minimální hodnotou časového limitu před tím, než se zobrazí druhý, bez ohledu na hodnotu timeout. Ve většině případů, pokud jsou bublinové hroty ze stejné aplikace, první bublinový tip se okamžitě zavře, když se provede další volání ShowBalloonTip metody. V některých případech se druhá bublina otevře nad první bublinou.

Text nadpisu se zobrazí tučným písmem v horní části bubliny.

Platí pro

ShowBalloonTip(Int32, String, String, ToolTipIcon)

Zobrazí bublinový tip se zadaným názvem, textem a ikonou na hlavním panelu pro zadané časové období.

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)

Parametry

timeout
Int32

Časové období v milisekundách by se měla zobrazit bublinová špička. Tento parametr je zastaralý. Časy zobrazení oznámení jsou teď založené na nastavení přístupnosti systému.

tipTitle
String

Název, který se zobrazí na bublině.

tipText
String

Text, který se má zobrazit na bublinovém tipu.

tipIcon
ToolTipIcon

Jedna z ToolTipIcon hodnot.

Výjimky

ArgumentOutOfRangeException

timeout je menší než 0.

ArgumentException

tipText je null nebo prázdný řetězec.

InvalidEnumArgumentException

tipIconnení členem .ToolTipIcon

Příklady

Následující příklad kódu ukazuje, jak použít metodu ShowBalloonTip . Chcete-li spustit tento příklad, vložte ukázkový kód do formuláře Windows, který obsahuje pojmenovaný NotifyIconnotifyIcon1. Přidružte metodu Form1_DoubleClick v tomto příkladu k události formuláře 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

Poznámky

Minimální a maximální hodnoty časového limitu jsou vynuceny operačním systémem a obvykle jsou 10 a 30 sekund, ale může se lišit v závislosti na operačním systému. Hodnoty časového limitu, které jsou příliš velké nebo příliš malé, se upraví na odpovídající minimální nebo maximální hodnotu. Pokud se navíc zdá, že uživatel počítač nepoužívá (nedochází k žádným událostem klávesnice nebo myši), systém tento čas do vypršení časového limitu nezapočítá.

Na hlavním panelu se může najednou zobrazovat jenom jeden bublinový tip. Pokus o zobrazení bublinového tipu, když je aktuálně zobrazen na hlavním panelu, způsobí ignorování timeout hodnoty. Chování se mírně liší v závislosti na operačním systému a na tom, jestli je bublinová špička z jiné nebo stejné aplikace. Pokud je druhý bublinový tip z jiné aplikace, zobrazí se první bublinový tip s minimální hodnotou časového limitu před tím, než se zobrazí druhý, bez ohledu na hodnotu timeout. Ve většině případů, pokud jsou bublinové hroty ze stejné aplikace, první bublinový tip se okamžitě zavře, když se provede další volání ShowBalloonTip metody. V některých případech se druhá bublina otevře nad první bublinou.

Text nadpisu se zobrazí tučným písmem v horní části bubliny.

Platí pro