Cet article a fait l’objet d’une traduction automatique. Pour afficher l’article en anglais, activez la case d’option Anglais. Vous pouvez également afficher le texte anglais dans une fenêtre contextuelle en faisant glisser le pointeur de la souris sur le texte traduit.
Traduction
Anglais

NotifyIcon.ShowBalloonTip méthode (Int32, String, String, ToolTipIcon)

 

Date de publication : novembre 2016

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.

Espace de noms:   System.Windows.Forms
Assembly:  System.Windows.Forms (dans System.Windows.Forms.dll)

public void ShowBalloonTip(
	int timeout,
	string tipTitle,
	string tipText,
	ToolTipIcon tipIcon
)

Paramètres

timeout
Type: System.Int32

Durée d’affichage de l’info-bulle, exprimée en millisecondes.

System_CAPS_noteRemarque

Ce paramètre est déconseillé à partir de Windows Vista. Temps d’affichage de notification sont désormais basés sur les paramètres d’accessibilité du système.

tipTitle
Type: System.String

Titre à afficher dans l’info-bulle.

tipText
Type: System.String

Texte à afficher dans l’info-bulle.

tipIcon
Type: System.Windows.Forms.ToolTipIcon

Une des valeurs de ToolTipIcon.

Exception Condition
ArgumentOutOfRangeException

timeout est inférieur à 0.

ArgumentException

tipText est soit null soit une chaîne vide.

InvalidEnumArgumentException

tipIcon n’est pas un membre de ToolTipIcon.

Valeurs minimale et maximale de délai d’attente sont appliquées par le système d’exploitation et sont généralement 10 et 30 secondes, respectivement, mais cela peut varier selon le système d’exploitation. Les valeurs de délai d’attente qui sont trop grand ou trop petit sont ajustées à la valeur minimale ou maximale appropriée. En outre, si l’utilisateur ne semble pas être à l’aide de l’ordinateur (aucun événement de clavier ou de souris ne se produisent) le système ne compte pas cette fois vers le délai d’attente.

Qu’une info-bulle peut afficher la barre des tâches à la fois. Tente d’afficher une info-bulle lorsqu’une est affichée sur les causes de la barre des tâches du timeout valeur doivent être ignorés. Le comportement est légèrement différent selon le système d’exploitation et si l’info-bulle provient d’une autre, ou la même application. Lorsque la deuxième info-bulle provient d’une autre application, la première info-bulle affiche la valeur de délai d’attente minimum avant que la seconde n’apparaisse, quelle que soit la valeur de timeout. Dans la plupart des cas, si l’info-bulle bulles proviennent de la même application, la première info-bulle immédiatement se ferme lorsqu’un autre appel à la ShowBalloonTip méthode est effectuée. Dans certains cas, la deuxième bulle s’ouvre par-dessus la première bulle.

Affiche le texte du titre en caractères gras en haut de l’info-bulle.

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. Associer le Form1_DoubleClick méthode dans cet exemple, le formulaire DoubleClick événement.

void Form1_DoubleClick(object sender, EventArgs e)
{
    notifyIcon1.Visible = true;
    notifyIcon1.ShowBalloonTip(20000, "Information", "This is the text",
        ToolTipIcon.Info );
}

UIPermission

for access to application windows. Related enumeration: F:System.Security.Permissions.UIPermissionWindow.AllWindows

.NET Framework
Disponible depuis 2.0
Retour au début
Afficher: