NotifyIcon.ShowBalloonTip Méthode

  • Référence

Définition

Espace de noms:
System.Windows.Forms
Assembly:
System.Windows.Forms.dll

Affiche l’info-bulle dans la barre des tâches.

Surcharges

ShowBalloonTip(Int32)

Affiche une info-bulle dans la barre des tâches pour la période spécifiée.
ShowBalloonTip(Int32, String, String, ToolTipIcon)

Affiche une info-bulle avec le titre, le texte et l’icône spécifiés dans la barre des tâches pendant la durée spécifiée.

ShowBalloonTip(Int32)

Affiche une info-bulle dans la barre des tâches pour la période spécifiée.

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

Paramètres

timeout
Int32

Durée d’affichage de l’info-bulle, exprimée en millisecondes. Ce paramètre est déconseillé. Les heures d’affichage des notifications sont désormais basées sur les paramètres d’accessibilité du système.

Exceptions

ArgumentOutOfRangeException

timeout est inférieur à 0.

Exemples

L'exemple de code suivant illustre l'utilisation de la méthode ShowBalloonTip. Pour exécuter cet exemple, collez l’exemple de code dans un Windows Form qui contient un NotifyIcon nommé notifyIcon1. Appel SetBalloonTip à partir du constructeur du formulaire ou Load de la méthode de gestion des événements.

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

Remarques

Les valeurs de délai d’expiration minimale et maximale sont appliquées par le système d’exploitation et sont généralement de 10 et 30 secondes, respectivement, mais cela peut varier en fonction du système d’exploitation. Les valeurs de délai d’expiration qui sont trop grandes ou trop petites sont ajustées à la valeur minimale ou maximale appropriée. En outre, si l’utilisateur ne semble pas utiliser l’ordinateur (aucun événement de clavier ou de souris ne se produit), le système ne compte pas cette fois dans le délai d’expiration.

Une seule bulle peut s’afficher sur la barre des tâches à la fois. La tentative d’affichage d’une bulle alors qu’une bulle est actuellement affichée dans la barre des tâches entraîne l’échec de la timeout valeur. Le comportement est légèrement différent selon le système d’exploitation et si la bulle provient d’une autre application ou de la même application. Lorsque la deuxième bulle provient d’une autre application, la première bulle affiche la valeur de délai d’expiration minimale avant que la seconde apparaisse, quelle que soit la valeur de timeout. Dans la plupart des cas, si les pointes de ballon proviennent de la même application, la première bulle se ferme immédiatement lorsqu’un autre appel à la ShowBalloonTip méthode est effectué. Dans certains cas, le deuxième ballon s’ouvre au-dessus du premier ballon.

Le texte de titre s’affiche dans une police en gras en haut de la bulle.

S’applique à

ShowBalloonTip(Int32, String, String, ToolTipIcon)

Affiche une info-bulle avec le titre, le texte et l’icône spécifiés dans la barre des tâches pendant la durée spécifiée.

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)

Paramètres

timeout
Int32

Durée d’affichage de l’info-bulle, exprimée en millisecondes. Ce paramètre est déconseillé. Les heures d’affichage des notifications sont désormais basées sur les paramètres d’accessibilité du système.

tipTitle
String

Titre à afficher dans l’info-bulle.

tipText
String

Texte à afficher dans l’info-bulle.

tipIcon
ToolTipIcon

Une des valeurs de l'objet ToolTipIcon.

Exceptions

ArgumentOutOfRangeException

timeout est inférieur à 0.

ArgumentException

tipText est soit null soit une chaîne vide.

InvalidEnumArgumentException

tipIcon n’est pas membre de ToolTipIcon

Exemples

L'exemple de code suivant illustre l'utilisation de la méthode ShowBalloonTip. Pour exécuter cet exemple, collez l’exemple de code dans un Windows Form qui contient un NotifyIcon nommé notifyIcon1. Associez la Form1_DoubleClick méthode dans cet exemple à l’événement du DoubleClick formulaire.

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

Remarques

Les valeurs de délai d’expiration minimale et maximale sont appliquées par le système d’exploitation et sont généralement de 10 et 30 secondes, respectivement, mais cela peut varier en fonction du système d’exploitation. Les valeurs de délai d’expiration qui sont trop grandes ou trop petites sont ajustées à la valeur minimale ou maximale appropriée. En outre, si l’utilisateur ne semble pas utiliser l’ordinateur (aucun événement de clavier ou de souris ne se produit), le système ne compte pas cette fois dans le délai d’expiration.

Une seule bulle peut s’afficher sur la barre des tâches à la fois. La tentative d’affichage d’une bulle alors qu’une bulle est actuellement affichée dans la barre des tâches entraîne l’échec de la timeout valeur. Le comportement est légèrement différent selon le système d’exploitation et si la bulle provient d’une autre application ou de la même application. Lorsque la deuxième bulle provient d’une autre application, la première bulle affiche la valeur de délai d’expiration minimale avant que la seconde apparaisse, quelle que soit la valeur de timeout. Dans la plupart des cas, si les pointes de ballon proviennent de la même application, la première bulle se ferme immédiatement lorsqu’un autre appel à la ShowBalloonTip méthode est effectué. Dans certains cas, le deuxième ballon s’ouvre au-dessus du premier ballon.

Le texte de titre s’affiche dans une police en gras en haut de la bulle.

S’applique à