PictureBox-Steuerelement für Visual Basic 6.0-Benutzer
Aktualisiert: November 2007
Das PictureBox-Steuerelement von Visual Basic 6.0 wird in Visual Basic 2008 durch das PictureBox-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
PictureBox als Container
Das PictureBox von Visual Basic 6.0 ist ein Containersteuerelement. Es kann nicht nur Bilder anzeigen, sondern auch zum Gruppieren und Anzeigen anderer Steuerelemente verwendet werden.
Das PictureBox-Steuerelement von Visual Basic 2008 ist kein Containersteuerelement. Es wird lediglich zum Anzeigen von Bildern verwendet. Sie können das neue Panel-Steuerelement als Ersatz für das PictureBox-Steuerelement verwenden, wenn Sie ein Containersteuerelement benötigen.
AutoSize-Eigenschaft
In Visual Basic 6.0 legt die AutoSize-Eigenschaft fest, ob ein PictureBox-Steuerelement seine zur Entwurfszeit eingestellte Größe (AutoSize = False) behält oder ob seine Größe dynamisch an die Maße des Bilds (AutoSize = True) angepasst wird.
In Visual Basic 2008 wurde die AutoSize-Eigenschaft durch die SizeMode-Eigenschaft ersetzt. Neben dem Normal-Modus und dem AutoSize-Modus sind Optionen zum Zentrieren, Dehnen oder Zoomen des Bilds verfügbar.
Grafikeigenschaften und -methoden
In Visual Basic 6.0 sind für das Zeichnen von Linien, Formen und Text auf einem PictureBox-Steuerelement verschiedene Eigenschaften und Methoden verfügbar.
In Visual Basic 2008 besitzen Steuerelemente keine Grafikeigenschaften oder -methoden mehr. Mithilfe eines T:System.Drawing.Graphics-Objekts ist es jedoch weiterhin möglich, auf einem PictureBox-Steuerelement zu zeichnen. Weitere Informationen finden Sie unter Grafiken für Visual Basic 6.0-Benutzer.
Andere 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 für das PictureBox-Steuerelement
Im folgenden Beispiel werden Unterschiede in den Codierungstechniken von Visual Basic 6.0 und Visual Basic 2008 dargestellt.
Änderungen am Code zum Anzeigen eines Bilds
Im folgenden Code wird veranschaulicht, wie ein Bild zur Laufzeit in einem PictureBox-Steuerelement angezeigt wird.
' Visual Basic 6.0
Picture1.Picture = LoadPicture(App.Path & "\somepicture.jpg")
' Visual Basic
PictureBox1.Image = System.Drawing.Bitmap.FromFile( _
My.Application.Info.DirectoryPath & "\somepicture.jpg")
Änderungen am Code zum Löschen eines PictureBox-Steuerelements
Im folgenden Code wird veranschaulicht, wie ein PictureBox-Steuerelement zur Laufzeit gelöscht wird, damit kein Bild angezeigt wird.
' Visual Basic 6.0
Picture1.Picture = LoadPicture("")
' Visual Basic
If Not (PictureBox1.Image Is Nothing) Then
PictureBox1.Image.Dispose()
PictureBox1.Image = Nothing
End If
Änderungen am Code zum Zeichnen auf einem PictureBox-Steuerelement
Im folgenden Code wird veranschaulicht, wie zur Laufzeit ein roter Kreis mit einem Durchmesser von 40 Pixel in der Mitte eines PictureBox-Steuerelements gezeichnet wird.
' Visual Basic 6.0
Private Sub Picture1_Paint
Dim x As Integer
Dim y As Integer
Picture1.ScaleMode = vbPixels
x = Picture1.ScaleWidth / 2
y = Picture1.ScaleHeight / 2
Picture1.Circle (x, y), 20, vbRed
End Sub
' Visual Basic
Private Sub PictureBox1_Paint(ByVal sender As Object, ByVal e _
As System.Windows.Forms.PaintEventArgs) Handles PictureBox1.Paint
Dim radius As Integer = 20
Dim diameter As Integer = radius * 2
Dim x As Integer = (PictureBox1.Width / 2) - radius
Dim y As Integer = (PictureBox1.Height / 2) - radius
e.Graphics.DrawEllipse(Pens.Red, x, y, diameter, diameter)
End Sub
Entsprechungen zu Eigenschaften, Methoden und Ereignissen des PictureBox-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 über denselben Namen und dasselbe Verhalten verfügen, werden dabei nicht berücksichtigt. 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 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 |
|
Appearance |
Neue Implementierung. Weitere Informationen finden Sie unter Appearance-Eigenschaft und BorderStyle-Eigenschaft für Visual Basic 6.0-Benutzer. |
AutoRedraw |
Neue Implementierung. Weitere Informationen finden Sie unter Grafiken für Visual Basic 6.0-Benutzer. |
AutoSize |
|
BackColor |
.gif "Hinweis") Hinweis:
Farben werden in Visual Basic 2008 anders behandelt. Weitere Informationen finden Sie unter Farbverhalten für Visual Basic 6.0-Benutzer.
|
BorderStyle |
Hinweis:
In Visual Basic ist der Standardwert Fixed Single. In Visual Basic 2008 ist der Standardwert None.
|
ClipControls |
Neue Implementierung. Weitere Informationen finden Sie unter Grafiken für Visual Basic 6.0-Benutzer. |
Container |
|
CurrentX CurrentY |
Neue Implementierung. Weitere Informationen finden Sie unter Grafiken für Visual Basic 6.0-Benutzer. |
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. |
DrawMode DrawStyle DrawWidth FillColor FillStyle |
Neue Implementierung. Weitere Informationen finden Sie unter Grafiken 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.
|
ForeColor |
Hinweis:
Farben werden in Visual Basic 2008 anders behandelt. Weitere Informationen finden Sie unter Farbverhalten für Visual Basic 6.0-Benutzer.
|
HasDC HDC |
Neue Implementierung. Weitere Informationen finden Sie unter Grafiken 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 |
|
Image |
Neue Implementierung. Weitere Informationen finden Sie unter Grafiken für Visual Basic 6.0-Benutzer. Hinweis:
In Visual Basic 2008 ist die Image-Eigenschaft keine Grafikeigenschaft. Es ist die Entsprechung der Picture-Eigenschaft von Visual Basic 6.0.
|
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.
|
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 |
Eine Liste mit Konstanten finden Sie unter MousePointer für Visual Basic 6.0-Benutzer. |
OLEDragMode OLEDropMode |
Neue Implementierung. Weitere Informationen finden Sie unter Drag & Drop für Visual Basic 6.0-Benutzer. |
Parent |
|
Picture |
|
ScaleHeight ScaleLeft ScaleMode ScaleTop ScaleWidth |
Neue Implementierung. Weitere Informationen finden Sie unter Koordinatensystem 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.
|
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 |
|---|---|
Circle Cls |
Neue Implementierung. Weitere Informationen finden Sie unter Grafiken für Visual Basic 6.0-Benutzer. |
Drag |
Neue Implementierung. Weitere Informationen finden Sie unter Drag & Drop für Visual Basic 6.0-Benutzer. |
Line |
Neue Implementierung. Weitere Informationen finden Sie unter Grafiken 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 |
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. |
PaintPicture Point PSet |
Neue Implementierung. Weitere Informationen finden Sie unter Grafiken für Visual Basic 6.0-Benutzer. |
Scale ScaleX ScaleY |
Neue Implementierung. Weitere Informationen finden Sie unter Koordinatensystem 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. |
TextHeight TextWidth |
Neue Implementierung. Weitere Informationen finden Sie unter Grafiken für Visual Basic 6.0-Benutzer. |
ZOrder |
BringToFront-Methode oder SendToBack-Methode |
Ereignisse
Visual Basic 6.0 |
Visual Basic 2008-Entsprechung |
|---|---|
Change |
Neue Implementierung. Es gibt einzelne Ereignisse (BackgroundImageChanged, SizeChanged usw.), die beim Ändern mancher Eigenschaften ausgelöst werden. |
DblClick |
|
DragDrop DragOver |
Neue Implementierung. Weitere Informationen finden Sie unter Drag & Drop für Visual Basic 6.0-Benutzer. |
GotFocus |
|
KeyDown KeyPress KeyUp |
Neue Implementierung. Das PictureBox-Steuerelement von Visual Basic 2008 ist kein Containersteuerelement und empfängt keine Tastaturanschläge. |
LinkClose LinkError LinkNotify LinkOpen |
Keine Entsprechung. Weitere Informationen finden Sie unter Dynamischer Datenaustausch (Dynamic Data Exchange, DDE) für Visual Basic 6.0-Benutzer. |
LostFocus |
|
OLECompleteDrag OLEDragDrop OLEDragOver OLEGiveFeedback OLESetData OLEStartDrag |
Neue Implementierung. Weitere Informationen finden Sie unter Drag & Drop für Visual Basic 6.0-Benutzer. |
Validate |
Hinweise zum Durchführen einer Aktualisierung
Beim Aktualisieren werden PictureBox-Steuerelemente, die Steuerelemente enthalten, auf Panel-Steuerelemente aktualisiert. Bei auf Panel-Steuerelemente aktualisierten PictureBox-Steuerelementen aus Visual Basic 6.0 werden Bilder, die der Picture-Eigenschaft zugewiesen sind, der BackgroundPicture-Eigenschaft des Panel-Steuerelements zugeordnet.