CommonDialog-Steuerelement für Visual Basic 6.0-Benutzer

Artikel
09/02/2008

Aktualisiert: November 2007

Das CommonDialog-Steuerelement von Visual Basic 6.0 wird in Visual Basic 2008 durch mehrere spezialisierte Komponenten ersetzt.

Konzeptionelle Unterschiede

In Visual Basic 6.0 wird das CommonDialog-ActiveX-Steuerelement zum Anzeigen verschiedener Standarddialogfelder (Öffnen, Speichern, Farbe, Schriftart, Drucken und Hilfe) in der Anwendung verwendet.

In Visual Basic 2008 wird das CommonDialog-Steuerelement durch einzelne Komponenten zum Anzeigen von Dialogfeldern ersetzt. Es handelt sich um die Komponenten OpenFileDialog, SaveFileDialog, ColorDialog, FontDialog und PrintDialog.

Hinweis:
Es gibt in Visual Basic 2008 keine direkte Entsprechung zum Anzeigen eines Hilfedialogfelds. Das CommonDialog-Steuerelement unterstützte nur die Windows-Hilfe. Visual Basic 2008 unterstützt nur HTML-Hilfe. In Visual Basic 2008 wird die HelpProvider-Komponente zum Anzeigen von anwendungsspezifischer Hilfe verwendet. Weitere Informationen finden Sie unter Hilfeunterstützung für Visual Basic 6.0-Benutzer.

Es gibt in Visual Basic 2008 keine direkte Entsprechung zum Anzeigen eines Hilfedialogfelds. Das CommonDialog-Steuerelement unterstützte nur die Windows-Hilfe. Visual Basic 2008 unterstützt nur HTML-Hilfe. In Visual Basic 2008 wird die HelpProvider-Komponente zum Anzeigen von anwendungsspezifischer Hilfe verwendet. Weitere Informationen finden Sie unter Hilfeunterstützung für Visual Basic 6.0-Benutzer.

Änderungen am Code des CommonDialog-Steuerelements

In den folgenden Beispielen werden die Unterschiede in den Codierungstechniken zwischen Visual Basic 6.0 und Visual Basic 2008 für einige gängige Verwendungsmöglichkeiten des CommonDialog-Steuerelements dargestellt.

Änderungen am Code zum Anzeigen eines Dialogfelds zum Öffnen von Dateien

Im folgenden Code wird veranschaulicht, wie ein Dialogfeld mit dem Namen Datei öffnen angezeigt wird. Das Dialogfeld wird mit dem Verzeichnis Programme initialisiert.

' Visual Basic 6.0
' Uses a CommonDialog control.
CommonDialog1.InitDir = "C:\Program Files"
CommonDialog1.ShowOpen

' Visual Basic
' Uses a OpenFileDialog component.
OpenFileDialog1.InitialDirectory = "C:\Program Files"
OpenFileDialog1.ShowDialog()

Änderungen am Code zum Anzeigen eines Dialogfelds zum Speichern von Dateien

Im folgenden Code wird das Anzeigen eines Dialogfelds mit dem Namen Datei speichern veranschaulicht. Die Datei wird im Ordner der Anwendung gespeichert.

' Visual Basic 6.0
' Uses a CommonDialog control.
CommonDialog1.InitDir = App.Path
CommonDialog1.ShowSave

' Visual Basic
' Uses a SaveFileDialog component.
SaveFileDialog1.InitialDirectory = My.Application.Info.DirectoryPath
SaveFileDialog1.ShowDialog()

Änderungen am Code zum Anzeigen eines Dialogfelds "Drucken"

Im folgenden Code wird das Anzeigen eines Dialogfelds Drucken veranschaulicht. Es wird eine im Ordner der Anwendung enthaltene Datei gedruckt.

' Visual Basic 6.0
' Uses a CommonDialog control.
CommonDialog1.FileName = App.Path & "MyFile.txt"
CommonDialog1.ShowPrinter

' Visual Basic
' Uses PrintDocument and PrintDialog components.
PrintDocument1.DocumentName = My.Application.Info.DirectoryPath _
& "MyFile.txt"
PrintDialog1.Document = PrintDocument1
PrintDialog1.ShowDialog()

Änderungen am Code zum Anzeigen der Hilfe

Im folgenden Code wird das Anzeigen einer Hilfedatei in der Anwendung veranschaulicht. Die Hilfe wird mit dem Inhaltsverzeichnis geöffnet.

' Visual Basic 6.0
' Uses a CommonDialog control.
CommonDialog1.HelpFile = "C:\Windows\Help\calc.hlp"
CommonDialog1.HelpCommand = cdlHelpContents
CommonDialog1.ShowHelp

' Visual Basic
' Uses the Help.ShowHelp method.
Help.ShowHelp(Me, "file://C:\Windows\Help\calc.chm", _
HelpNavigator.TableOfContents)

Entsprechungen für Eigenschaften und Methoden des CommonDialog-Steuerelements

In den folgenden Tabellen werden Visual Basic 6.0-Eigenschaften und -Methoden zusammen mit ihren Visual Basic 2008-Entsprechungen aufgeführt. Eigenschaften und Methoden mit den gleichen Namen und dem gleichen Verhalten sind 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.

Bei Bedarf werden Links zu Themen bereitgestellt, in denen die 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
Action	Neue Implementierung. Die Action-Eigenschaft in Visual Basic 6.0 bestimmt, welches Dialogfeld angezeigt wird. Visual Basic 2008 verwendet für jedes Dialogfeld eine eigene Komponente.
CancelError	Cancel
Copies	Copies
DialogTitle	Title (nur die OpenFileDialog-Komponente und die SaveFileDialog-Komponente) Neue Implementierung für die anderen Komponenten. Standard-Windows-Titel (Color, Font und Print) werden angezeigt und können nicht überschrieben werden.
FileName	FileNames
FileTitle	Neue Implementierung. Die FileTitle-Eigenschaft in Visual Basic 6.0 gibt FileName ohne den Pfad zurück. Sie können die FileNames-Eigenschaft analysieren, um den Namen ohne den Pfad abzurufen.
Flags	Die Flags-Eigenschaft in Visual Basic 6.0 enthält Konstanten zum Festlegen verschiedener Attribute der einzelnen Standarddialogfelder. Die Dialogfeldkomponenten verwenden keine Konstanten, sondern stellen Eigenschaften zum Festlegen der Attribute bereit.
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.
FromPage	FromPage
hDC	Neue Implementierung. Weitere Informationen finden Sie unter Grafiken für Visual Basic 6.0-Benutzer.
HelpCommand	HelpNavigator
HelpFile	HelpNamespace
HelpKey	Der parameter-Parameter der ShowHelp-Methode.
Index	Neue Implementierung. Weitere Informationen finden Sie unter Steuerelementarrays für Visual Basic 6.0-Benutzer.
InitDir	InitialDirectory
Left	Left Hinweis: Koordinaten werden in Visual Basic 2008 anders behandelt. Weitere Informationen finden Sie unter Koordinatensystem für Visual Basic 6.0-Benutzer.
Max	MaxSize (FontDialog-Komponente) MaximumPage (PrintDialog-Komponente)
Min	MinSize (FontDialog-Komponente) MinimumPage (PrintDialog-Komponente)
MaxFileSize	Neue Implementierung. Diese Visual Basic 6.0-Eigenschaft reserviert Speicher für äußerst lange Dateinamen. In verwaltetem Code wird sie nicht mehr benötigt.
Orientation	Landscape
Parent	FindForm-Methode
PrinterDefault	Neue Implementierung. Diese Visual Basic 6.0-Eigenschaft wird in Verbindung mit der hDC-Eigenschaft zum Drucken mithilfe von Methoden von Grafikgeräteschnittstellen verwendet. Sie wird nicht mehr unterstützt.
Top	P:System.Windows.Forms.Control.Top Hinweis: Koordinaten werden in Visual Basic 2008 anders behandelt. Weitere Informationen finden Sie unter Koordinatensystem für Visual Basic 6.0-Benutzer.
ToPage	ToPage

Methoden

Visual Basic 6.0	Visual Basic 2005-Entsprechung
AboutBox	Neue Implementierung. Mit der AboutBox-Eigenschaft wurde ein Info-Feld für das CommonDialog-Steuerelement angezeigt, das von einem Drittanbieter für Microsoft erstellt wurde.
ShowColor	ShowDialog (ColorDialog-Komponente)
ShowFont	ShowDialog (FontDialog-Komponente)
ShowHelp	ShowHelp
ShowOpen	ShowDialog (OpenFileDialog-Komponente)
ShowPrinter	ShowDialog (PrintDialog-Komponente)
ShowSave	ShowDialog (SaveFileDialog-Komponente)

Hinweise zum Durchführen einer Aktualisierung

Bei der Aktualisierung einer Anwendung von Visual Basic 6.0 auf Visual Basic 2008 werden alle CommonDialog-Steuerelemente auf die entsprechende Dialogfeldkomponente aktualisiert (OpenFileDialog, SaveFileDialog, ColorDialog, FontDialog oder PrintDialog).

Es gibt in Visual Basic 2008 keine direkte Entsprechung zum Anzeigen eines Help-Dialogfelds. Wenn ein CommonDialog-Steuerelement als Help-Dialogfeld verwendet wird, wird eine Warnung ausgegeben, und das Steuerelement wird nicht aktualisiert. Weitere Informationen finden Sie unter Hilfeunterstützung für Visual Basic 6.0-Benutzer.

Ein einzelnes CommonDialog-Steuerelement konnte zum Anzeigen verschiedener Arten von Dialogfeldern verwendet werden. In diesem Fall wird es auf eine OpenFileDialog-Komponente aktualisiert. Eine Warnung wird ausgegeben, und Sie müssen die übrigen Dialogfeldkomponenten manuell hinzufügen.

Falls ein CommonDialog-Steuerelement als Variable verwendet wurde, müssen Sie es darüber hinaus eventuell ändern, sodass es nach der Aktualisierung auf eine bestimmte Dialogfeldkomponente verweist.