NotifyIcon.ShowBalloonTip Methode

Definitie

Naamruimte:
System.Windows.Forms
Assembly:
System.Windows.Forms.dll

Geeft de ballontip weer op de taakbalk.

Overloads

Name Description
ShowBalloonTip(Int32)

Geeft een ballontip weer op de taakbalk voor de opgegeven periode.
ShowBalloonTip(Int32, String, String, ToolTipIcon)

Geeft een ballontip weer met de opgegeven titel, tekst en pictogram op de taakbalk voor de opgegeven periode.

ShowBalloonTip(Int32)

Bron:
NotifyIcon.cs
Bron:
NotifyIcon.cs
Bron:
NotifyIcon.cs
Bron:
NotifyIcon.cs
Bron:
NotifyIcon.cs

Geeft een ballontip weer op de taakbalk voor de opgegeven periode.

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

Parameters

timeout
Int32

De tijdsperiode, in milliseconden, moet de ballontip worden weergegeven. Deze parameter is afgeschaft. De weergavetijden voor meldingen zijn nu gebaseerd op de toegankelijkheidsinstellingen van het systeem.

Uitzonderingen

ArgumentOutOfRangeException

timeout is kleiner dan 0.

Voorbeelden

In het volgende codevoorbeeld ziet u hoe u de ShowBalloonTip methode gebruikt. Als u dit voorbeeld wilt uitvoeren, plakt u de voorbeeldcode in een Windows formulier met een NotifyIcon met de naam notifyIcon1. Aanroepen SetBalloonTip vanuit de constructor- of Load gebeurtenisafhandelingsmethode van het formulier.

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

Opmerkingen

Minimum- en maximumtime-outwaarden worden afgedwongen door het besturingssysteem en zijn doorgaans 10 en 30 seconden, maar dit kan variëren afhankelijk van het besturingssysteem. Time-outwaarden die te groot of te klein zijn, worden aangepast aan de juiste minimum- of maximumwaarde. Als de gebruiker niet de computer gebruikt (er treden geen toetsenbord- of muisgebeurtenissen op), telt het systeem deze keer niet mee naar de time-out.

Slechts één ballontip kan tegelijk op de taakbalk worden weergegeven. Als u een ballontip probeert weer te geven wanneer er momenteel op de taakbalk een balloninfo wordt weergegeven, wordt de timeout waarde genegeerd. Het gedrag verschilt enigszins, afhankelijk van het besturingssysteem en of de ballontip afkomstig is van een andere, of dezelfde toepassing. Wanneer de tweede ballontip afkomstig is van een andere toepassing, wordt de eerste ballontip weergegeven voor de minimale time-outwaarde voordat de tweede wordt weergegeven, ongeacht de waarde van timeout. In de meeste gevallen, als de ballontips afkomstig zijn van dezelfde toepassing, wordt de eerste ballontip onmiddellijk gesloten wanneer er een andere aanroep naar de ShowBalloonTip methode wordt gedaan. In sommige gevallen wordt de tweede ballon boven op de eerste ballon geopend.

De titeltekst wordt weergegeven in een vet lettertype boven aan de ballon.

Van toepassing op

ShowBalloonTip(Int32, String, String, ToolTipIcon)

Bron:
NotifyIcon.cs
Bron:
NotifyIcon.cs
Bron:
NotifyIcon.cs
Bron:
NotifyIcon.cs
Bron:
NotifyIcon.cs

Geeft een ballontip weer met de opgegeven titel, tekst en pictogram op de taakbalk voor de opgegeven periode.

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)

Parameters

timeout
Int32

De tijdsperiode, in milliseconden, moet de ballontip worden weergegeven. Deze parameter is afgeschaft. De weergavetijden voor meldingen zijn nu gebaseerd op de toegankelijkheidsinstellingen van het systeem.

tipTitle
String

De titel die moet worden weergegeven op de ballontip.

tipText
String

De tekst die moet worden weergegeven op de ballontip.

tipIcon
ToolTipIcon

Een van de ToolTipIcon waarden.

Uitzonderingen

ArgumentOutOfRangeException

timeout is kleiner dan 0.

ArgumentException

tipText is null of een lege tekenreeks.

InvalidEnumArgumentException

tipIcon is geen lid van ToolTipIcon.

Voorbeelden

In het volgende codevoorbeeld ziet u hoe u de ShowBalloonTip methode gebruikt. Als u dit voorbeeld wilt uitvoeren, plakt u de voorbeeldcode in een Windows formulier met een NotifyIcon met de naam notifyIcon1. Koppel de Form1_DoubleClick methode in dit voorbeeld aan de gebeurtenis van DoubleClick het formulier.

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

Opmerkingen

Minimum- en maximumtime-outwaarden worden afgedwongen door het besturingssysteem en zijn doorgaans 10 en 30 seconden, maar dit kan variëren afhankelijk van het besturingssysteem. Time-outwaarden die te groot of te klein zijn, worden aangepast aan de juiste minimum- of maximumwaarde. Als de gebruiker niet de computer gebruikt (er treden geen toetsenbord- of muisgebeurtenissen op), telt het systeem deze keer niet mee naar de time-out.

Slechts één ballontip kan tegelijk op de taakbalk worden weergegeven. Als u een ballontip probeert weer te geven wanneer er momenteel op de taakbalk een balloninfo wordt weergegeven, wordt de timeout waarde genegeerd. Het gedrag verschilt enigszins, afhankelijk van het besturingssysteem en of de ballontip afkomstig is van een andere, of dezelfde toepassing. Wanneer de tweede ballontip afkomstig is van een andere toepassing, wordt de eerste ballontip weergegeven voor de minimale time-outwaarde voordat de tweede wordt weergegeven, ongeacht de waarde van timeout. In de meeste gevallen, als de ballontips afkomstig zijn van dezelfde toepassing, wordt de eerste ballontip onmiddellijk gesloten wanneer er een andere aanroep naar de ShowBalloonTip methode wordt gedaan. In sommige gevallen wordt de tweede ballon boven op de eerste ballon geopend.

De titeltekst wordt weergegeven in een vet lettertype boven aan de ballon.

Van toepassing op