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	BackColor 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	Text
Container	Parent
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	Font Hinweis: Schriftarten werden in Visual Basic 2008 anders behandelt. Weitere Informationen finden Sie unter Font-Objekt für Visual Basic 6.0-Benutzer.
Height	Height, Size 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	Handle
Index	Neue Implementierung. Weitere Informationen finden Sie unter Steuerelementarrays für Visual Basic 6.0-Benutzer.
Left	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	Cursor 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	Image
RightToLeft	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	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	Width, Size 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	SetBounds 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	Focus
ShowWhatsThis	Neue Implementierung. Weitere Informationen finden Sie unter Hilfeunterstützung für Visual Basic 6.0-Benutzer.
ZOrder	BringToFront-Funktion oder SendToBack-Funktion

Ereignisse

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.

Siehe auch

Konzepte

MaskColor für Visual Basic 6.0-Benutzer