ToolBar-Steuerelement für Visual Basic 6.0-Benutzer
Aktualisiert: November 2007
Das ToolBar-Steuerelement von Visual Basic 6.0 wird in Visual Basic 2008 durch das ToolStrip-Steuerelement ersetzt. Die Namen einiger Eigenschaften, Methoden, Ereignisse und Konstanten wurden geändert, und in einigen Fällen weicht auch ihr Verhalten ab.
Konzeptionelle Unterschiede
Das ToolBar-Steuerelement von Visual Basic 6.0 ist ein ActiveX-Steuerelement, mit dem einfache Symbolleisten mit Schaltflächen und Kombinationsfeldern erstellt werden können.
Mit dem ToolStrip-Steuerelement von Visual Basic 2008 können Sie benutzerdefinierte oder dem Verhalten und dem Aussehen von Microsoft Windows XP, Microsoft Office oder Microsoft Internet Explorer angepasste Symbolleisten und Benutzeroberflächenelemente erstellen. Diese Elemente der Benutzeroberfläche unterstützen Überlauf und Neuanordnung von Elementen zur Laufzeit. ToolStrip-Steuerelemente bieten eine umfangfreiche Entwurfszeiterfahrung, zu der die direkte Aktivierung und Bearbeitung, benutzerdefinierte Layouts und Rafting, d. h. die gemeinsame Verwendung von horizontalen und vertikalen Bereichen durch Symbolleisten, zählen.
.gif "Hinweis") Hinweis: |
|---|
Visual Basic 2008 verfügt außerdem über ein ToolBar-Steuerelement, das aus früheren Versionen übernommen wurde. Allerdings wird die Verwendung des ToolStrip-Steuerelements aufgrund seiner erweiterten Möglichkeiten empfohlen. |
AllowCustomize-Eigenschaft, Customize-Methode, Change-Ereignis
In Visual Basic 6.0 kann mit der AllowCustomize-Eigenschaft eines ToolBar-Steuerelements das Standarddialogfeld Symbolleiste anpassen angezeigt werden, mit dem Sie die Schaltflächen der Symbolleiste ausblenden, anzeigen oder neu anordnen können. Mit der Customize-Methode kann das Dialogfeld programmgesteuert aufgerufen werden. Das Change-Ereignis wird ausgelöst, wenn der Benutzer das Dialogfeld Symbolleiste anpassen schließt.
Das ToolStrip-Steuerelement von Visual Basic 2008 verfügt über keine entsprechende Eigenschaft oder Methode. Es muss ein eigenes Dialogfeld erstellt werden, das mithilfe der ShowDialog-Methode angezeigt wird. Weitere Informationen finden Sie unter Beispiel für das Anpassen von "ToolStrip".
Eigenschaften DisabledImageList, HotImageList, ImageList
In Visual Basic 6.0 wird mit den Eigenschaften DisabledImageList, HotImageList und ImageList eines ToolBar-Steuerelements dieses den ImageList-Steuerelementen zugeordnet. Separate Bilder können unterschiedlichen Zuständen zugeordnet werden: normal (ImageList), deaktiviert (DisabledImageList) und ausgewählt (HotImageList).
Das ToolStrip-Steuerelement von Visual Basic 2008 verfügt über keine entsprechenden Eigenschaften. Das ToolStripButton-Objekt weist eine einzelne Image-Eigenschaft auf. Wenn die Enabled-Eigenschaft von ToolStripButton auf False festgelegt wird, wird das Bild automatisch deaktiviert. Um das "ausgewählte" Zustandsverhalten von Visual Basic 6.0 zu emulieren, können Sie entweder ein anderes Bild zuweisen oder die BackColor-Eigenschaft von ToolStripButton zur Laufzeit ändern.
Style-Eigenschaft
In Visual Basic 6.0 bestimmt die Style-Eigenschaft eines ToolBar-Steuerelements, wo die Bilder im Verhältnis zum Text angezeigt werden. Durch das Festlegen auf tbrTransparent wird auch Hot Track aktiviert.
Das ToolStrip-Steuerelement von Visual Basic 2008 verfügt über keine entsprechende Eigenschaft. Das Text-Bild-Verhältnis wird durch Festlegen der TextImageAlign-Eigenschaft von ToolStripItem gesteuert, im Gegensatz zu Visual Basic 6.0 kann jedes Element anders ausgerichtet sein. Hot Track wird nicht direkt unterstützt, aber Sie können dieses Verhalten emulieren, indem Sie die Image-Eigenschaft im MouseEnter-Ereignis sowie im MouseLeave-Ereignis ändern.
Wrappable-Eigenschaft
In Visual Basic 6.0 bestimmt die Wrappable-Eigenschaft eines ToolBar-Steuerelements, ob die Schaltflächen der Symbolleiste beim Ändern der Fenstergröße automatisch eingebunden wird.
Das ToolStrip-Steuerelement von Visual Basic 2008 hat keine direkte Entsprechung, es unterstützt stattdessen die Verwendung eines Überlauf-Dropdownmenüs. Wenn Sie ToolStripItem-Elemente hinzufügen, die mehr Platz benötigen als ToolStrip anhand der aktuellen Größe des Formulars zugewiesen wurde, wird automatisch ToolStripOverflowButton auf dem ToolStrip angezeigt. Der ToolStripOverflowButton wird angezeigt, und es werden Elemente, für die der Überlauf aktiviert wurde, in das Überlauf-Dropdownmenü verschoben. Sie können dieses Verhalten deaktivieren, indem Sie für die CanOverflow-Eigenschaft False festlegen.
Zusätzlich können Sie das Überlaufverhalten für ein einzelnes ToolStripItem-Element angeben, indem Sie seine Overflow-Eigenschaft festlegen. Weitere Informationen finden Sie unter Gewusst wie: Umgang mit dem ToolStrip-Überlauf in Windows Forms.
RestoreToolBar-Methode, SaveToolBar-Methode
In Visual Basic 6.0 wird mithilfe der RestoreToolBar-Methode und der SaveToolBar-Methode die ToolBar-Konfiguration verwaltet. SaveToolBar speichert die Konfiguration in eine Initialisierungsdatei (INI-Datei), und RestoreToolBar stellt den Ursprungszustand der Konfiguration nach der benutzerdefinierten Anpassung wieder her.
Das ToolStrip-Steuerelement von Visual Basic 2008 verfügt über keine entsprechenden Methoden. Mit dem Einstellungs-Designer können Sie Konfigurationen für das ToolStrip-Steuerelement verwalten. Weitere Informationen finden Sie unter Verwalten von Anwendungseinstellungen.
Entsprechungen für Eigenschaften und Methoden des ToolBar-Steuerelements
In den folgenden Tabellen werden Visual Basic 6.0-Eigenschaften und -Methoden zusammen mit ihren Visual Basic 2008-Entsprechungen aufgeführt. Die Eigenschaften und Methoden, die über den gleichen Namen und das gleiche Verhalten verfügen, werden dabei nicht berücksichtigt. Alle Visual Basic 2008-Enumerationen werden, sofern nicht anders angegeben, dem System.Windows.Forms-Namespace zugeordnet.
In dieser Tabelle werden Links zu Themen bereitgestellt, in denen Unterschiede im Verhalten erläutert werden. Wenn in Visual Basic 2008 keine direkte Entsprechung vorhanden ist, werden Links zu Themen bereitgestellt, die Alternativen behandeln.
Eigenschaften
Visual Basic 6.0 |
Visual Basic 2008-Entsprechung |
|---|---|
Align |
|
AllowCustomize |
Neue Implementierung. Sie müssen ein eigenes Dialogfeld bereitstellen. |
Appearance BorderStyle |
Neue Implementierung. Weitere Informationen finden Sie unter Appearance-Eigenschaft und BorderStyle-Eigenschaft für Visual Basic 6.0-Benutzer. |
ButtonHeight |
|
Buttons |
|
ButtonWidth |
|
Container |
|
Controls |
|
DataBindings |
Neue Implementierung. Weitere Informationen finden Sie unter Datenzugriff für Visual Basic 6.0-Benutzer. |
DisabledImageList |
Neue Implementierung. Verwenden Sie die Image-Eigenschaft des ToolStripButton-Objekts. |
DragIcon DragMode |
Neue Implementierung. Weitere Informationen finden Sie unter Drag & Drop für Visual Basic 6.0-Benutzer. |
Height |
Hinweis:
Koordinaten werden in Visual Basic 2008 anders behandelt. Weitere Informationen finden Sie unter Koordinatensystem für Visual Basic 6.0-Benutzer.
|
HelpContextID HelpFile |
Neue Implementierung. Weitere Informationen finden Sie unter Hilfeunterstützung für Visual Basic 6.0-Benutzer. |
HotImageList |
Neue Implementierung. Verwenden Sie die Image-Eigenschaft des ToolStripButton-Objekts. |
HWnd |
Handle |
ImageList |
Neue Implementierung. Verwenden Sie die Image-Eigenschaft des ToolStripButton-Objekts. |
Index |
Neue Implementierung. Weitere Informationen finden Sie unter Steuerelementarrays für Visual Basic 6.0-Benutzer. |
Left |
Hinweis Koordinaten werden in Visual Basic 2008 anders behandelt. Weitere Informationen finden Sie unter Koordinatensystem für Visual Basic 6.0-Benutzer |
MouseIcon |
Neue Implementierung. Weitere Informationen finden Sie unter Es kann kein benutzerdefinierter MousePointer festgelegt werden. |
MousePointer |
Eine Liste mit Konstanten finden Sie unter MousePointer für Visual Basic 6.0-Benutzer. |
OLEDropMode |
Neue Implementierung. Weitere Informationen finden Sie unter Drag & Drop für Visual Basic 6.0-Benutzer. |
Parent |
|
ShowTips |
|
Style |
Neue Implementierung. Verwenden Sie die TextImageAlign-Eigenschaft von ToolStripItem. |
TextAlignment |
TextAlign (ToolStripItem) |
ToolTipText |
ToolTip-Komponente Weitere Informationen finden Sie unter QuickInfo-Unterstützung für Visual Basic 6.0-Benutzer. |
Value |
Hinweis:
Wenn in Visual Basic 6.0 die Value-Eigenschaft geändert wird, wird das Change-Ereignis ausgelöst. In Visual Basic 2008 wird das Change-Ereignis nicht ausgelöst. Verwenden Sie stattdessen das ValueChanged-Ereignis.
|
WhatsThisHelpID |
Neue Implementierung. Weitere Informationen finden Sie unter Hilfeunterstützung für Visual Basic 6.0-Benutzer. |
Width |
Hinweis Koordinaten werden in Visual Basic 2008 anders behandelt. Weitere Informationen finden Sie unter Koordinatensystem für Visual Basic 6.0-Benutzer. |
Wrappable |
Methoden
Visual Basic 6.0 |
Visual Basic 2008-Entsprechung |
|---|---|
Customize |
Neue Implementierung. Sie müssen ein eigenes Dialogfeld bereitstellen. |
Drag |
Neue Implementierung. Weitere Informationen finden Sie unter Drag & Drop für Visual Basic 6.0-Benutzer. |
Move |
Hinweis:
Koordinaten werden in Visual Basic 2008 anders behandelt. Weitere Informationen finden Sie unter Koordinatensystem für Visual Basic 6.0-Benutzer.
|
OLEDrag |
Neue Implementierung. Weitere Informationen finden Sie unter Drag & Drop für Visual Basic 6.0-Benutzer. |
RestoreToolbar SaveToolbar |
Neue Implementierung. Verwenden Sie das Feature für Anwendungseinstellungen. |
ShowWhatsThis |
Neue Implementierung. Weitere Informationen finden Sie unter Hilfeunterstützung für Visual Basic 6.0-Benutzer. |
ZOrder: |
Die BringToFront-Funktion oder die SendToBack-Funktion. |
Ereignisse
Visual Basic 6.0 |
Visual Basic 2008-Entsprechung |
|---|---|
Change |
Neue Implementierung. Das Dialogfeld Toolbox anpassen ist nicht mehr vorhanden. |
DblClick |
|
DragDrop DragOver |
Neue Implementierung. Weitere Informationen finden Sie unter Drag & Drop für Visual Basic 6.0-Benutzer. |
OLECompleteDrag OLEDragDrop OLEDragOver OLEGiveFeedback OLESetData OLEStartDrag |
Neue Implementierung. Weitere Informationen finden Sie unter Drag & Drop für Visual Basic 6.0-Benutzer. |
Hinweise zum Durchführen eines Updates
Beim Durchführen einer Aktualisierung eines Visual Basic 6.0-Projekts auf Visual Basic 2008 erfolgt eine Aktualisierung aller ToolBar-Steuerelemente zu ToolStrip-Steuerelementen von Windows Forms. Wenn Eigenschaften, Methoden und Ereignisse über keine Entsprechung verfügen oder ein abweichendes Verhalten aufweisen, werden dem Code Updatehinweise oder Warnungen hinzugefügt.
Siehe auch
Referenz
Übersicht über das ToolStrip-Steuerelement (Windows Forms)