Contrôle ToolBar pour les utilisateurs de Visual Basic 6.0
Mise à jour : novembre 2007
Le contrôle ToolBar dans Visual Basic 6.0 est remplacé par le contrôle ToolStrip dans Visual Basic 2008. Les noms de certains événements, propriétés, méthodes et constantes ont changé. En outre, dans certains cas, leur comportement est également différent.
Différences conceptuelles
Le contrôle de Visual Basic 6.0 ToolBar est un contrôle ActiveX qui est utilisé pour créer des barres d'outils simples avec des boutons et des zones de liste déroulante.
Vous pouvez utiliser le contrôle Visual Basic 2008ToolStrip pour créer des barres d'outils personnalisées et des éléments d'interface utilisateur ou créer des barres d'outils et des éléments d'interface utilisateur ayant l'apparence et le comportement de Microsoft Windows XP, Microsoft Office ou Microsoft Internet Explorer. Ces éléments d'interface utilisateur prennent en charge le dépassement de capacité et la réorganisation des éléments au moment de l'exécution. Les contrôles ToolStrip offrent une expérience de design qui inclut l'activation et la modification sur place, la disposition personnalisée et le rafting, qui correspond à la capacité des barres d'outils de partager l'espace horizontal ou vertical.
Remarque : |
---|
Visual Basic 2008 possède également un contrôle ToolBar qui provient des versions antérieures. Toutefois, le contrôle ToolStrip est le choix recommandé en raison de ses fonctions avancées. |
Propriété AllowCustomize, méthode Customize, événement Change
Dans Visual Basic 6.0, la propriété AllowCustomize d'un contrôle ToolBar peut être utilisée pour afficher une boîte de dialogue Personnaliser la barre d'outils standard, qui permet à l'utilisateur de masquer, d'afficher ou de réorganiser des boutons de barre d'outils. La méthode Customize peut être utilisée pour appeler la boîte de dialogue par programme. L'événement Change est déclenché lorsque l'utilisateur ferme la boîte de dialogue Personnaliser la boîte à outils.
Le contrôle Visual Basic 2008ToolStrip ne possède aucune propriété ou méthode équivalente. Vous devez créer votre propre boîte de dialogue et l'afficher à l'aide de la méthode ShowDialog. Pour plus d'informations, consultez Personnalisation de ToolStrip, exemple.
Propriétés DisabledImageList, HotImageList, ImageList
Dans Visual Basic 6.0, les propriétés DisabledImageList, HotImageList et ImageList d'un contrôle ToolBar sont utilisées pour associer le contrôle aux contrôles ImageList. Différentes images peuvent être associées pour différents états : normal (ImageList), désactivé (DisabledImageList) et sélectionné (HotImageList).
Le contrôle Visual Basic 2008ToolStrip n'a pas de propriétés équivalentes. L'objet ToolStripButton a une seule propriété Image. Attribuer à la propriété Enabled du ToolStripButton la valeur False restitue automatiquement l'image désactivée. Pour émuler le comportement d'état "sélectionné" de Visual Basic 6.0, vous pouvez soit assigner une image différente, soit modifier la propriété BackColor du ToolStripButton au moment de l'exécution.
Propriété de style
Dans Visual Basic 6.0, la propriété Style d'un contrôle ToolBar détermine l'endroit où les images sont affichées dans la relation au texte. Lui attribuer la valeur tbrTransparent active également la sélection réactive.
Le contrôle Visual Basic 2008ToolStrip n'a pas de propriété équivalente. La relation entre l'image et le texte est contrôlée en définissant la propriété TextImageAlign du ToolStripItem. Contrairement à Visual Basic 6.0, chaque élément peut avoir un alignement différent. La sélection réactive n'est pas directement prise en charge, mais vous pouvez émuler le comportement en modifiant la propriété Image dans les événements MouseEnter et MouseLeave.
Propriété Wrappable
Dans Visual Basic 6.0, la propriété Wrappable d'un contrôle ToolBar détermine si les boutons de barre d'outils se positionneront automatiquement en cas de redimensionnement de la fenêtre.
Le contrôle Visual Basic 2008ToolStrip n'a aucun équivalent direct. À la place, il prend en charge l'utilisation d'un menu de dépassement de capacité déroulant. Lorsque vous ajoutez des éléments ToolStripItem qui requièrent plus d'espace que l'espace alloué à ToolStrip, vu la taille actuelle du formulaire, un ToolStripOverflowButton apparaît automatiquement sur le ToolStrip. ToolStripOverflowButton apparaît et les éléments pour lesquels le dépassement de capacité est activé sont déplacés dans le menu déroulant de dépassement de capacité. Vous pouvez désactiver ce comportement en attribuant à la propriété CanOverflow la valeur False.
De plus, vous pouvez spécifier le comportement de dépassement de capacité d'un élément ToolStripItem individuel en définissant sa propriété Overflow. Pour plus d'informations, consultez Comment : Gérer le dépassement de capacité de contrôles ToolStrip dans les Windows Forms.
Méthodes RestoreToolBar, SaveToolBar
Dans Visual Basic 6.0, les méthodes RestoreToolBar et SaveToolBar sont utilisées pour gérer la configuration ToolBar. SaveToolBar enregistre la configuration dans un fichier d'initialisation (.ini) ; RestoreToolBar le retourne à son état d'origine après avoir été personnalisé.
Le contrôle Visual Basic 2008ToolStrip n'a pas de méthodes équivalentes. Vous pouvez utiliser le Concepteur de paramètres pour gérer des configurations pour le contrôle ToolStrip. Pour plus d'informations, consultez Gestion des paramètres de l'application.
Équivalences des propriétés et des méthodes du contrôle ToolBar
Les tableaux ci-dessous répertorient les propriétés et les méthodes de Visual Basic 6.0, ainsi que leurs équivalents dans Visual Basic 2008. Les propriétés et les méthodes, qui ont des noms et des comportements identiques, ne sont pas répertoriées. Sauf indication contraire, toutes les énumérations Visual Basic 2008 sont mappées à l'espace de noms System.Windows.Forms.
Ce tableau fournit des liens vers les rubriques qui expliquent des différences de comportement. Lorsqu'il n'existe pas d'équivalent direct dans Visual Basic 2008, des liens vous renvoient vers des rubriques proposant des alternatives.
Propriétés
Visual Basic 6.0 |
Équivalent Visual Basic 2008 |
||
---|---|---|---|
Align |
|||
AllowCustomize |
Nouvelle implémentation. Vous devez fournir votre propre boîte de dialogue. |
||
Appearance BorderStyle |
Nouvelle implémentation. Pour plus d'informations, consultez Propriétés Appearance et BorderStyle pour les utilisateurs de Visual Basic 6.0. |
||
ButtonHeight |
|||
Buttons |
|||
ButtonWidth |
|||
Container |
|||
Controls |
|||
DataBindings |
Nouvelle implémentation. Pour plus d'informations, consultez Accès aux données pour les utilisateurs de Visual Basic 6.0. |
||
DisabledImageList |
Nouvelle implémentation. Utilisez la propriété Image de l'objet ToolStripButton. |
||
DragIcon DragMode |
Nouvelle implémentation. Pour plus d'informations, consultez Fonction de glisser-déplacer pour les utilisateurs de Visual Basic 6.0. |
||
Height |
|
||
HelpContextID HelpFile |
Nouvelle implémentation. Pour plus d'informations, consultez Prise en charge de l'aide pour les utilisateurs de Visual Basic 6.0. |
||
HotImageList |
Nouvelle implémentation. Utilisez la propriété Image de l'objet ToolStripButton. |
||
HWnd |
Handle |
||
ImageList |
Nouvelle implémentation. Utilisez la propriété Image de l'objet ToolStripButton. |
||
Index |
Nouvelle implémentation. Pour plus d'informations, consultez Tableaux de contrôles pour les utilisateurs de Visual Basic 6.0. |
||
Left |
Remarque Les coordonnées sont gérées différemment dans Visual Basic 2008. Pour plus d'informations, consultez Système de coordonnées pour les utilisateurs de Visual Basic 6.0 |
||
MouseIcon |
Nouvelle implémentation. Pour plus d'informations, consultez Impossible de définir un pointeur de souris personnalisé. |
||
MousePointer |
Pour obtenir la liste des constantes, consultez MousePointer pour les utilisateurs de Visual Basic 6.0. |
||
OLEDropMode |
Nouvelle implémentation. Pour plus d'informations, consultez Fonction de glisser-déplacer pour les utilisateurs de Visual Basic 6.0. |
||
Parent |
|||
ShowTips |
|||
Style |
Nouvelle implémentation. Utilisez la propriété TextImageAlign de ToolStripItem. |
||
TextAlignment |
TextAlign (ToolStripItem) |
||
ToolTipText |
Composant ToolTip Pour plus d'informations, consultez Prise en charge des info-bulles pour les utilisateurs de Visual Basic 6.0. |
||
Value |
|
||
WhatsThisHelpID |
Nouvelle implémentation. Pour plus d'informations, consultez Prise en charge de l'aide pour les utilisateurs de Visual Basic 6.0. |
||
Width |
Remarque Les coordonnées sont gérées différemment dans Visual Basic 2008. Pour plus d'informations, consultez Système de coordonnées pour les utilisateurs de Visual Basic 6.0. |
||
Wrappable |
Méthodes
Visual Basic 6.0 |
Équivalent Visual Basic 2008 |
||
---|---|---|---|
Customize |
Nouvelle implémentation. Vous devez fournir votre propre boîte de dialogue. |
||
Drag |
Nouvelle implémentation. Pour plus d'informations, consultez Fonction de glisser-déplacer pour les utilisateurs de Visual Basic 6.0. |
||
Move |
|
||
OLEDrag |
Nouvelle implémentation. Pour plus d'informations, consultez Fonction de glisser-déplacer pour les utilisateurs de Visual Basic 6.0. |
||
RestoreToolbar SaveToolbar |
Nouvelle implémentation. Utilisez la fonctionnalité Paramètres de l'application. |
||
ShowWhatsThis |
Nouvelle implémentation. Pour plus d'informations, consultez Prise en charge de l'aide pour les utilisateurs de Visual Basic 6.0. |
||
ZOrder: |
Fonction BringToFront ou SendToBack |
Événements
Visual Basic 6.0 |
Équivalent Visual Basic 2008 |
---|---|
Change |
Nouvelle implémentation. La boîte de dialogue Personnaliser la boîte à outils n'existe plus. |
DblClick |
|
DragDrop DragOver |
Nouvelle implémentation. Pour plus d'informations, consultez Fonction de glisser-déplacer pour les utilisateurs de Visual Basic 6.0. |
OLECompleteDrag OLEDragDrop OLEDragOver OLEGiveFeedback OLESetData OLEStartDrag |
Nouvelle implémentation. Pour plus d'informations, consultez Fonction de glisser-déplacer pour les utilisateurs de Visual Basic 6.0. |
Mettre à niveau des remarques
Lorsqu'un projet Visual Basic 6.0 est mis à niveau vers Visual Basic 2008, tous les contrôles ToolBar sont mis à niveau vers des contrôles ToolStrip Windows Forms. Lorsque les propriétés, méthodes et événements n'ont aucun équivalent ou présentent des différences de comportement, des remarques ou avertissements de mise à niveau sont ajoutés à votre code.
Voir aussi
Référence
Vue d'ensemble du contrôle ToolStrip (Windows Forms)