Prise en charge des info-bulles pour les utilisateurs de Visual Basic 6.0

Mise à jour : novembre 2007

Les méthodes d'affichage d'info-bulles de Visual Basic 6.0 et de Visual Basic 2008 sont complètement différentes.

Différences conceptuelles

Dans Visual Basic 6.0, la propriété ToolTipText d'un contrôle est utilisée pour afficher une info-bulle au moment de l'exécution.

Dans Visual Basic 2008, un seul composant ToolTip peut être utilisé pour contrôler les info-bulles de tous les contrôles sur un formulaire. Le composant ToolTip peut être ajouté dans un formulaire à partir de la boîte à outils. La méthode SetToolTip est utilisée pour définir le texte de chaque info-bulle en fonction du nom du contrôle.

Masquage d'info-bulles

Dans Visual Basic 6.0, si la propriété ToolTipText contient du texte, l'info-bulle s'affiche ; si elle est vide, l'info-bulle ne s'affiche pas. Pour effacer le texte de plusieurs Info-bulles, vous devez exécuter une boucle sur la collection Controls et définir la propriété ToolTipText avec la valeur d'une chaîne vide.

Dans Visual Basic 2008, vous pouvez empêcher l'affichage de l'info-bulle en passant une chaîne vide à la méthode SetToolTip. Vous pouvez effacer le texte de toutes les info-bulles associées à un composant ToolTip en attribuant à la propriété Active la valeur false.

Personnalisation des info-bulles

Dans Visual Basic 6.0, il n'est pas possible de personnaliser une info-bulle sans avoir recours à des appels d'API Windows.

Dans Visual Basic 2008, plusieurs propriétés totalement nouvelles vous permettent de personnaliser l'apparence ou le comportement d'une info-bulle, par exemple en changeant les couleurs, en définissant un délai avant l'affichage de l'info-bulle ou en créant des info-bulles multilignes.

Modifications du code des info-bulles

Les exemples de code ci-dessous illustrent les différences entre les techniques de codage dans Visual Basic 6.0 et dans Visual Basic 2008.

Modifications du code pour afficher une info-bulle

L'exemple suivant illustre la définition d'une info-bulle pour un contrôle Button dans Visual Basic 6.0 et Visual Basic 2008. L'exemple Visual Basic 2008 suppose qu'un composant ToolTip a été ajouté au formulaire au moment du design.

' Visual Basic 6.0
Button1.ToolTipText = "Save changes"

' Visual Basic
ToolTip1.SetToolTip(Button1, "Save changes")

Modifications du code pour masquer une info-bulle

L'exemple suivant montre comment masquer une info-bulle pour un contrôle Button dans Visual Basic 6.0 et dans Visual Basic 2008. L'exemple Visual Basic 2008 suppose qu'un composant ToolTip a été ajouté au formulaire au moment du design.

Remarque :
Le composant Visual Basic 2008ToolTip possède également une propriété Active ; l'affectation de la valeur false à cette propriété masquera les info-bulles pour tous les contrôles associés à ce composant ToolTip.

' Visual Basic 6.0
' Hide a single ToolTip.
Button1.ToolTipText = ""
' Hide all ToolTips.
For Each Control in Me.Controls
    Control.ToolTipText = ""
Next

' Visual Basic
' Hide a single ToolTip.
ToolTip1.SetToolTip(Button1, "")
' Hide all ToolTips.
ToolTip1.Active = False

Mettre à niveau des remarques

Lorsque Visual Basic 6.0 est mis à niveau vers Visual Basic 2008, les références à la propriété ToolTipText ne sont pas mises à niveau et les commentaires sont insérés dans votre code au moment du design ou au moment de l'exécution. Un composant ToolTip nommé ToolTip1 est ajouté à votre formulaire. Vous devrez traiter vos info-bulles soit en définissant la propriété ToolTip on ToolTip1 au moment du design ou en appelant la méthode SetToolTip au moment de l'exécution.

Si l'application Visual Basic 6.0 utilise des appels d'API Windows pour personnaliser des info-bulles, vous devez modifier votre code pour tirer parti des fonctionnalités de personnalisation du composant ToolTip.

Voir aussi

Référence

Vue d'ensemble du composant ToolTip (Windows Forms)

Autres ressources

Contrôles Windows Forms pour les utilisateurs de Visual Basic 6.0