Label-Steuerelement für Visual Basic 6.0-Benutzer

Aktualisiert: November 2007

In diesem Thema wird das Label-Steuerelement von Visual Basic 6.0 mit seiner Entsprechung in Visual Basic 2008 verglichen.

Das Label-Steuerelement von Visual Basic 6.0 wird in Visual Basic 2008 durch das Label-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

BackStyle-Eigenschaft

In Visual Basic 6.0 legt die BackStyle-Eigenschaft des Label-Steuerelements fest, ob die Bezeichnung über einen transparenten Hintergrund verfügt. Wenn die BackStyle-Eigenschaft auf 0 – Transparent festgelegt wird, sind Hintergrundbilder durch die Bezeichnung zu sehen. Wenn die Bezeichnung über anderen Steuerelementen platziert wird, sind die Steuerelemente ebenfalls sichtbar.

In Visual Basic 2008 ist die BackStyle-Eigenschaft nicht mehr vorhanden, und das Transparenzverhalten unterscheidet sich etwas. Um das Transparenzverhalten in Visual Basic 2008 zu emulieren, legen Sie die BackColor-Eigenschaft auf Transparent fest. Damit kann das Hintergrundbild durchscheinen. Wenn die Bezeichnung über anderen Steuerelementen platziert wird, sind die Steuerelemente nur sichtbar, wenn sie in der z-Reihenfolge höher angesiedelt sind.

Hinweis:
In Visual Basic 2008 ist die ZOrder-Methode nicht mehr vorhanden. Zur Entwurfszeit können Sie im Menü Format den Befehl In den Vordergrund oder In den Hintergrund verwenden. Zur Laufzeit könnn Sie die BringToFront-Funktion oder die SendToBack-Funktion verwenden.

WordWrap-Eigenschaft

In Visual Basic 6.0 bestimmt die WordWrap-Eigenschaft, ob Text in mehrere Zeilen umbrochen wird, wenn er nicht in eine Bezeichnung passt.

In Visual Basic 2008 wird der Text in einem Label-Steuerelement automatisch umgebrochen. Der Umbruch kann nur verhindert werden, wenn die Höhe des Label-Steuerelements auf eine Textzeile festgelegt wird.

Weitere Unterschiede

Darüber hinaus gibt es zahlreiche konzeptionelle Unterschiede, die für alle Steuerelemente gelten. Hierzu gehören Unterschiede bei Datenbindung, Schriftartbehandlung, Drag & Drop, Hilfeunterstützung usw. Weitere Informationen finden Sie unter Windows Forms-Konzepte für Visual Basic 6.0-Benutzer.

Änderungen am Code des Label-Steuerelements

Im folgenden Codebeispiel werden Unterschiede in den Codierungstechniken von Visual Basic 6.0 und Visual Basic 2008 aufgezeigt.

Änderungen am Code, mit dem Bezeichnungen transparent gemacht werden

Im folgenden Beispiel wird gezeigt, wie der Hintergrund eines Label-Steuerelements transparent gemacht wird. Wenn sich hinter dem Label-Steuerelement andere Steuerelemente befinden, sind diese in Visual Basic 6.0 sichtbar. Im Visual Basic 2008-Beispiel können alle Steuerelemente hinter Label mit der BringToFront-Funktion und der SendToBack-Funktion optional sichtbar gemacht werden.

' Visual Basic 6.0 
Private Sub MakeTransparent()
    Label1.BackStyle = vbTransparent
End Sub

' Visual Basic
Private Sub MakeTransparent()
  Label1.BackColor = System.Drawing.Color.Transparent
  ' Let controls behind the label show through.
  Label1.SendToBack()
  ' Make the portion of controls behind the label transparent
  Label1.BringToFront()
End Sub

Entsprechungen zu Eigenschaften, Methoden und Ereignissen des Label-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.

Diese Tabelle Enthält Hyperlinks zu Themen, in denen Verhaltensunterschiede erläutert werden. Wenn in Visual Basic 2008 keine direkte Entsprechung vorhanden ist, werden Links zu Alternativen angegeben.

Label-Eigenschaften

Visual Basic 6.0	Visual Basic 2008-Entsprechung
Alignment: 0 - Left Justify 1 - Right Justify	TextAlign MiddleLeft-Enumerationswert MiddleRight-Enumerationswert
Appearance	Neue Implementierung. Weitere Informationen finden Sie unter Appearance-Eigenschaft und BorderStyle-Eigenschaft für Visual Basic 6.0-Benutzer.
AutoSize	AutoSize
BackColor	BackColor Hinweis   Eine Liste mit Konstanten finden Sie unter Behandeln von Farben für Visual Basic 6.0-Benutzer. Hinweis: Farben werden in Visual Basic 2008 anders behandelt. Weitere Informationen finden Sie unter Farbverhalten für Visual Basic 6.0-Benutzer.
BackStyle	Neue Implementierung. Weitere Informationen finden Sie oben unter Konzeptionelle Unterschiede.
Caption	Text
Container	Parent
DataChanged DataField DataFormat DataMember DataSource	Neue Implementierung. Weitere Informationen finden Sie unter Datenzugriff 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 Schriftartbehandlung für Visual Basic 6.0-Benutzer.
ForeColor	ForeColor Hinweis: Eine Liste mit Konstanten finden Sie unter Behandeln von Farben für Visual Basic 6.0-Benutzer. Hinweis: Farben werden in Visual Basic 2008 anders behandelt. Weitere Informationen finden Sie unter Farbverhalten 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.
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.
LinkItem LinkMode LinkTimeOut LinkTopic	Keine Entsprechung. Weitere Informationen finden Sie unter Dynamischer Datenaustausch (Dynamic Data Exchange, DDE) 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
RightToLeft:  True  False	RightToLeft  Yes-Enumerationswert  No-Enumerationswert
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.
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.
WordWrap	Neue Implementierung. Hinweis: Text im Label-Steuerelement von Visual Basic 2008 wird standardmäßig umgebrochen und kann nicht geändert werden.

Label-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.
LinkExecute LinkPoke LinkRequest LinkSend	Keine Entsprechung. Weitere Informationen finden Sie unter Dynamischer Datenaustausch (Dynamic Data Exchange, DDE) 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.
ShowWhatsThis	Neue Implementierung. Weitere Informationen finden Sie unter Hilfeunterstützung für Visual Basic 6.0-Benutzer.
ZOrder:  0 – vbBringToFront  1 - vbSendToBack	BringToFront-Methode oder SendToBack-Methode  BringToFront  SendToBack

Label-Ereignisse

Hinweise zum Durchführen einer Aktualisierung

Beim Durchführen einer Aktualisierung für eine Visual Basic 6.0-Anwendung auf Visual Basic 2008 werden alle Label-Steuerelemente auf Label-Steuerelemente von Windows Forms aktualisiert. Eigenschaften, Methoden und Ereignisse werden auf ihre jeweiligen Entsprechungen aktualisiert. Bei Abweichungen im Verhalten werden Aktualisierungskommentare in den Code eingefügt.

Siehe auch

Konzepte

Einführung in das Label-Steuerelement