CommandButton-Steuerelement für Visual Basic 6.0-Benutzer
Aktualisiert: November 2007
Das CommandButton-Steuerelement von Visual Basic 6.0 wird in Visual Basic 2008 durch das Button-Steuerelement von Windows Forms ersetzt. Die Namen einiger Eigenschaften, Methoden, Ereignisse und Konstanten wurden geändert, und in einigen Fällen weicht auch ihr Verhalten ab.
Konzeptionelle Unterschiede
Default-Eigenschaft und Cancel-Eigenschaft
In Visual Basic 6.0 bestimmen die Boolesche Default-Eigenschaft und die Boolesche Cancel-Eigenschaft eines CommandButton-Steuerelements, ob das Steuerelement auf das Drücken der EINGABETASTE bzw. der ESC-TASTE reagiert.
In Visual Basic 2008 besitzt das Button-Steuerelement nicht mehr die Eigenschaften Default und Cancel. Das Form-Objekt verfügt über die AcceptButton-Eigenschaft und die CancelButton-Eigenschaft, die die gleichen Funktionen bieten. Diese Eigenschaften nehmen den Namen eines Button-Steuerelements als Argument an.
Value-Eigenschaft
In Visual Basic 6.0 gibt die Boolesche Value-Eigenschaft eines CommandButton-Steuerelements an, ob das Steuerelement ausgewählt wurde. Wenn die Eigenschaft auf True festgelegt wird, wird das Click-Ereignis der Schaltfläche aufgerufen.
In Visual Basic 2008 besitzt das Button-Steuerelement nicht mehr die Value-Eigenschaft. Mithilfe des GotFocus-Ereignisses können Sie feststellen, ob das Steuerelement ausgewählt ist. Die PerformClick-Methode kann zum Aufrufen des Click-Ereignisses verwendet werden.
Die Eigenschaften Style, Picture, DownPicture and DisabledPicture
Wenn Sie in Visual Basic 6.0 die Style-Eigenschaft eines CommandButton-Steuerelements auf 1 – Graphical festlegen, werden auf dem Steuerelement Bilder angezeigt. Mit den Eigenschaften Picture, DownPicture und DisabledPicture werden Bilder zugewiesen, die bei Zustandsänderungen angezeigt werden sollen. Beim Klicken auf ein CommandButton-Steuerelement wird z. B. das DownPicture-Bild angezeigt. Wenn das Steuerelement deaktiviert ist, wird das DisabledPicture-Bild angezeigt.
In Visual Basic 2008 werden die Eigenschaften Style, Picture, DownPicture und DisabledPicture nicht mehr unterstützt. Die Style-Eigenschaft wird nicht mehr benötigt; die Zuweisung eines Bilds zur Image-Eigenschaft hat den gleichen Effekt wie das Festlegen der Style-Eigenschaft auf Graphical. Die Picture-Eigenschaft wird durch die Image-Eigenschaft ersetzt. Die Funktionen der DownPicture-Eigenschaft und der DisabledPicture-Eigenschaft können mit einem ImageList-Steuerelement emuliert werden, das mehrere Bilder enthält.
MaskColor-Eigenschaft
In Visual Basic 6.0 wird die MaskColor-Eigenschaft eines CommandButton-Steuerelements dazu verwendet, eine Farbe als transparent zu definieren, sodass ein Hintergrundbild sichtbar wird. Zur Verwendung dieser Eigenschaft muss die Style-Eigenschaft auf Graphical festgelegt werden, die UseMaskColor-Eigenschaft muss auf True festgelegt werden, und der Picture-Eigenschaft muss eine Bitmap zugewiesen werden.
In Visual Basic 2008 gibt es keine direkte Entsprechung für die MaskColor-Eigenschaft. Sie können die Transparenz eines Steuerelements jedoch mit der MakeTransparent-Methode eines Bitmap-Objekts festlegen.
Weitere Unterschiede
Außerdem gibt es zahlreiche konzeptionelle Unterschiede, die für alle Steuerelemente gelten, einschließlich von Unterschieden bei Datenbindung, Schriftartbehandlung, Drag & Drop, Hilfeunterstützung usw. Weitere Informationen finden Sie unter Windows Forms-Steuerelemente für Visual Basic 6.0-Benutzer.
Änderungen am Code des CommandButton-Steuerelements
Im folgenden Codebeispiel werden die Unterschiede in den Codierungstechniken von Visual Basic 6.0 und Visual Basic 2008 aufgezeigt.
Codeänderungen zum Festlegen der Standardschaltfläche und der Schaltfläche zum Abbrechen
Das folgende Beispiel veranschaulicht das Festlegen von zwei Schaltflächen als Standardschaltfläche und als Schaltfläche zum Abbrechen für ein Formular.
' Visual Basic 6.0
' Set the first button to respond to the Enter key.
Command1.Default = True
' Set the second button to respond to the Esc key.
Command2.Cancel = True
' Visual Basic
' Set the first button to respond to the Enter key.
Me.AcceptButton = Button1
' Set the second button to respond to the Esc key.
Me.CancelButton = Button2
Codeänderungen zum Hinzufügen von Transparenz zu einer Schaltfläche
Im folgenden Beispiel werden Methoden dargestellt, mit denen auf einer Schaltfläche ein transparenter Bereich definiert wird, der ein Bild enthält. Alle weißen Bildbereiche werden transparent.
' Visual Basic 6.0
' Assumes a picture has been assigned to the Picture property
' and that the Style property has been set to Graphical.
Command1.UseMaskColor = True
Command1.MaskColor = vbWhite
' Visual Basic
' Assumes a picture has been assigned to the BackgroundImage property.
Dim ButtonBitmap As New System.Drawing.Bitmap(Button1.BackgroundImage)
ButtonBitmap.MakeTransparent(System.Drawing.Color.White)
Button1.BackgroundImage = ButtonBitmap
Entsprechungen zu Eigenschaften, Methoden und Ereignissen des CommandButton-Steuerelements
In den folgenden Tabellen werden Eigenschaften, Methoden und Ereignisse von Visual Basic 6.0 zusammen mit ihren Visual Basic 2008-Entsprechungen aufgeführt. Die Eigenschaften, Methoden und Ereignisse, die den gleichen Namen und das gleiche Verhalten haben, werden nicht aufgeführt. Sofern vorhanden, wurden Konstanten unter der Eigenschaft oder Methode eingerückt aufgelistet. Alle Visual Basic 2008-Enumerationen werden, sofern nicht anders angegeben, dem System.Windows.Forms-Namespace zugeordnet.
In diesen Tabellen 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 Alternativen angegeben.
Eigenschaften
Visual Basic 6.0 |
Visual Basic 2008-Entsprechung |
|---|---|
Appearance |
Neue Implementierung. Weitere Informationen finden Sie unter Appearance-Eigenschaft und BorderStyle-Eigenschaft für Visual Basic 6.0-Benutzer. |
BackColor |
.gif "Hinweis") Hinweis:
Farben werden in Visual Basic 2008 anders behandelt. Weitere Informationen finden Sie unter Behandeln von Farben für Visual Basic 6.0-Benutzer.
|
Cancel |
CancelButton (Form-Objekt) |
Caption |
|
Container |
|
Default |
AcceptButton (Form-Objekt) |
DisabledPicture DownPicture |
Neue Implementierung. Weitere Informationen finden Sie unter Style-Eigenschaft für Visual Basic 6.0-Benutzer. |
DragIcon DragMode |
Neue Implementierung. Weitere Informationen finden Sie unter Drag & Drop für Visual Basic 6.0-Benutzer. |
Font FontBold FontItalic FontName FontSize FontStrikethrough FontUnderline |
Hinweis:
Schriftarten werden in Visual Basic 2008 anders behandelt. Weitere Informationen finden Sie unter Font-Objekt 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 |
Neue Implementierung. Weitere Informationen finden Sie unter Hilfeunterstützung für Visual Basic 6.0-Benutzer. |
HWnd |
|
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.
|
MaskColor |
Neue Implementierung. Weitere Informationen finden Sie unter MaskColor 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 |
FindForm-Methode |
Picture |
|
RightToLeft |
|
Style |
Neue Implementierung. Weitere Informationen finden Sie unter Style-Eigenschaft für Visual Basic 6.0-Benutzer. |
ToolTipText |
ToolTip-Komponente Weitere Informationen finden Sie unter QuickInfo-Unterstützung für Visual Basic 6.0-Benutzer. |
Top |
Hinweis:
Koordinaten werden in Visual Basic 2008 anders behandelt. Weitere Informationen finden Sie unter Koordinatensystem für Visual Basic 6.0-Benutzer.
|
UseMaskColor |
Neue Implementierung. Weitere Informationen finden Sie unter MaskColor für Visual Basic 6.0-Benutzer. |
Value |
Neue Implementierung. Die PerformClick-Methode hat die gleiche Wirkung wie das Festlegen der Value-Eigenschaft auf True. Für andere Verwendungen der Value-Eigenschaft gibt es keine Entsprechung. |
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.
|
Methoden
Visual Basic 6.0 |
Visual Basic 2008-Entsprechung |
|---|---|
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. |
SetFocus |
|
ShowWhatsThis |
Neue Implementierung. Weitere Informationen finden Sie unter Hilfeunterstützung für Visual Basic 6.0-Benutzer. |
ZOrder |
BringToFront-Funktion oder SendToBack-Funktion |
Ereignisse
Visual Basic 6.0 |
Visual Basic 2008-Entsprechung |
|---|---|
DragDrop DragOver |
Neue Implementierung. Weitere Informationen finden Sie unter Drag & Drop für Visual Basic 6.0-Benutzer. |
GotFocus |
|
LostFocus |
|
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 einer Aktualisierung
Bei der Aktualisierung einer Visual Basic 6.0-Anwendung mit dem Aktualisierungs-Assistenten werden CommandButton-Steuerelemente auf Button-Steuerelemente von Windows Forms aktualisiert. Der Code wird so aktualisiert, dass die entsprechenden Eigenschaften, Methoden und Ereignisse verwendet werden. Wenn es keine Entsprechungen gibt oder wenn es potenzielle Verhaltensdifferenzen gibt, werden in den Code Kommentare mit Verknüpungen zu Hilfethemen eingefügt.
Wenn eine Anwendung auf Visual Basic 2008 aktualisiert wird und die Style-Eigenschaft auf 1 – Graphical festgelegt ist, wird die FlatStyle-Eigenschaft des aktualisierten Steuerelements auf Standard festgelegt, und Bilder, die der Picture-Eigenschaft zur Entwurfszeit zugewiesen wurden, werden der Image-Eigenschaft des aktualisierten Steuerelements zugewiesen.
Wenn die DownPicture-Eigenschaft oder die DisabledPicture-Eigenschaft zur Entwurfszeit bzw. zur Laufzeit festgelegt wurden, müssen Sie die aktualisierte Anwendung ändern, sodass diese ein ImageList-Steuerelement verwendet. Weitere Informationen finden Sie unter Gewusst wie: Emulieren eines Visual Basic 6.0-Steuerelements mit drei Zuständen in einer aktualisierten Anwendung.
Code, in dem die MaskColor-Eigenschaft verwendet wird, wird vom Aktualisierungs-Assistenten nicht aktualisiert. In den Code werden Aktualisierungswarnungen eingefügt. Sie müssen den Code ändern, bevor Sie die Anwendung ausführen.