Visual Basic 6.0 使用者可用的 CommonDialog 控制項

更新：2007 年 11 月

Visual Basic 6.0 的 CommonDialog 控制項在 Visual Basic 2008 中已經由數個特殊元件取代。

概念上的差異

在 Visual Basic 6.0 中，CommonDialog ActiveX 控制項可用於顯示應用程式的各種通用對話方塊 (Common Dialog Box) ([開啟]、[儲存]、[色彩]、[字型]、[列印] 和 [說明])。

在 Visual Basic 2008 中，CommonDialog 控制項已經由下列個別元件取代以顯示對話方塊：OpenFileDialog、SaveFileDialog、ColorDialog、FontDialog 和 PrintDialog 元件。

注意事項：
在 Visual Basic 2008 中沒有顯示 [說明] 對話方塊的直接對等用法。CommonDialog 控制項僅支援 Windows 說明。Visual Basic 2008 僅支援 HTML 說明。Visual Basic 2008 會使用 HelpProvider 元件顯示應用程式的說明。如需詳細資訊，請參閱Visual Basic 6.0 使用者可用的說明支援。

CommonDialog 控制項的程式碼變更

下列程式碼範例會說明 CommonDialog 控制項的某些通用用法上，在 Visual Basic 6.0 和 Visual Basic 2008 之間的程式撰寫技巧差異。

顯示開啟舊檔對話方塊的程式碼變更

下列程式碼會示範顯示 [開啟舊檔] 對話方塊，初始化到 [Program Files] 目錄。

' 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()

顯示儲存檔案對話方塊的程式碼變更

下列程式碼會示範顯示 [儲存檔案] 對話方塊，將檔案儲存到應用程式的資料夾。

' 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()

顯示列印對話方塊的程式碼變更

下列程式碼會示範顯示 [列印] 對話方塊，列印應用程式資料夾中的檔案。

' 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()

顯示說明的程式碼變更

下列程式碼會示範從應用程式顯示說明檔，並開啟到目錄。

' 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)

CommonDialog 控制項屬性和方法對等用法

下表列出 Visual Basic 6.0 的屬性和方法，以及其 Visual Basic 2008 對等用法。但不會列出具有相同名稱和行為的屬性及方法。在適用的情況下，常數會在屬性或方法之下縮排。除非另外註明，否則所有 Visual Basic 2008 列舉型別 (Enumeration) 都會對應到 System.Windows.Forms 命名空間 (Namespace)。

將視需要提供連結至解釋行為差異的主題。若 Visual Basic 2008 中沒有直接的對等用法，則提供連結至替代的主題。

屬性

Visual Basic 6.0	Visual Basic 2008對等用法
Action	新實作。Visual Basic 6.0 的 Action 屬性會判斷要顯示的對話方塊，Visual Basic 2008 會對每個對話方塊使用不同的元件。
CancelError	Cancel
Copies	Copies
DialogTitle	Title (僅限 OpenFileDialog 和 SaveFileDialog 元件) 其他元件的新實作。會顯示標準 Windows 標題 (Color、Font 和 Print)，並且無法覆寫。
FileName	FileNames
FileTitle	新實作。Visual Basic 6.0 FileTitle 屬性會傳回 FileName 且不帶路徑。您可以剖析 FileNames 屬性，以取得不帶路徑的名稱。
Flags	Visual Basic 6.0 Flags 屬性 (Property) 提供一些常數，用於設定不同通用對話方塊的各種屬性 (Attribute)。不使用常數時，對話方塊元件會提供設定屬性 (Attribute) 的屬性 (Property)。
Font FontBold FontItalic FontName FontSize FontStrikethrough FontUnderline	Font 注意事項： 在 Visual Basic 2008 中會以不同方式處理字型。如需詳細資訊，請參閱 Visual Basic 6.0 使用者可用的字型處理方式。
FromPage	FromPage
hDC	新實作。如需詳細資訊，請參閱 Visual Basic 6.0 使用者可用的圖形。
HelpCommand	HelpNavigator
HelpFile	HelpNamespace
HelpKey	ShowHelp 方法的 parameter 參數。
Index	新實作。如需詳細資訊，請參閱 Visual Basic 6.0 使用者可用的控制項陣列。
InitDir	InitialDirectory
Left	Left 注意事項： 在 Visual Basic 2008 中會以不同方式處理座標。如需詳細資訊，請參閱 Visual Basic 6.0 使用者可用的座標系統。
Max	MaxSize (FontDialog 元件) MaximumPage (PrintDialog 元件)
Min	MinSize (FontDialog 元件) MinimumPage (PrintDialog 元件)
MaxFileSize	新實作。這個 Visual Basic 6.0 屬性會對極長的檔名配置記憶體，Managed 程式碼中不再需要這個屬性。
Orientation	Landscape
Parent	FindForm 方法
PrinterDefault	新實作。這個 Visual Basic 6.0 屬性用於結合 hDC 屬性，以使用圖形裝置介面方法進行列印，但已不再支援這個屬性。
Top	P:System.Windows.Forms.Control.Top 注意事項： 在 Visual Basic 2008 中會以不同方式處理座標。如需詳細資訊，請參閱 Visual Basic 6.0 使用者可用的座標系統。
ToPage	ToPage

方法

Visual Basic 6.0	Visual Basic 2005 對等用法
AboutBox	新實作。AboutBox 屬性會顯示 CommonDialog 控制項的 [關於] 方塊，這是協力廠商為 Microsoft 建立的控制項。
ShowColor	ShowDialog (ColorDialog 元件)
ShowFont	ShowDialog (FontDialog 元件)
ShowHelp	ShowHelp
ShowOpen	ShowDialog (OpenFileDialog 元件)
ShowPrinter	ShowDialog (PrintDialog 元件)
ShowSave	ShowDialog (SaveFileDialog 元件)

升級注意事項

將應用程式從 Visual Basic 6.0 升級為 Visual Basic 2008 時，CommonDialog 控制項會升級為對等的對話方塊元件 (OpenFileDialog、SaveFileDialog、ColorDialog、FontDialog 或 PrintDialog)。

在 Visual Basic 2008 中沒有顯示 Help 對話方塊的直接對等用法。如果 CommonDialog 控制項已當做 Help 對話方塊使用，將發出警告且不會升級此控制項。如需詳細資訊，請參閱Visual Basic 6.0 使用者可用的說明支援。

單一 CommonDialog 控制項可用於顯示不同型別的對話方塊。在上述情況中，將升級至 OpenFileDialog 元件。將發出警告而您需要以手動方式加入其他對話方塊元件。

此外，CommonDialog 控制項當做變數使用時，您可能需要在升級之後變更此控制項，以參考特定對話方塊元件。

請參閱

參考

FontDialog 元件概觀 (Windows Form)

HelpProvider 元件概觀 (Windows Form)

其他資源

ColorDialog 元件 (Windows Form)

OpenFileDialog 元件 (Windows Form)

SaveFileDialog 元件 (Windows Form)

PrintDialog 元件 (Windows Form)

PrintDocument 元件 (Windows Form)