Controle CommonDialog para usuários do Visual Basic 6.0

Artigo
08/25/2010

O Visual Basic 6.0 CommonDialog controle é substituído por vários componentes especializados no Visual Basic 2008.

Diferenças Conceituais

No Visual Basic 6.0, a CommonDialog Controle ActiveX é usado para exibir várias (caixas de diálogo comumem aberto, Salvar, Cor, Fonte, Impressão, and Ajuda) para o seu aplicativo.

In Visual Basic 2008, o CommonDialog controle é substituído por componentes individuais para exibir caixas de diálogo — o OpenFileDialog, SaveFileDialog, ColorDialog, FontDialog, e PrintDialog componentes.

Observação:
Não há nenhum equivalente direto para mostrar uma caixa de diálogo Ajuda no Visual Basic 2008.The CommonDialog controle suporte apenas a Ajuda do Windows; Visual Basic 2008 só oferece suporte de Ajuda em HTML. Visual Basic 2008 usa o HelpProvider componente para exibir a Ajuda para seu aplicativo. Para obter mais informações, consulte Suporte de Ajuda para Usuários do Visual Basic 6.0.

Alterações de código para o controle CommonDialog

Os exemplos a seguir ilustram as diferenças na codificação técnicas entre o Visual Basic 6.0 e Visual Basic 2008 para alguns comum usa da CommonDialog controle.

Alterações de código para abrir caixa de diálogo File Open

O código a seguir demonstra como exibir uma caixa de diálogo File Open, inicializada no diretório 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()

Alterações de código para exibir uma caixa de diálogo File Save

O código a seguir demonstra como exibir uma caixa de diálogo File Save, salvando o arquivo na pasta do aplicativo.

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

Alterações de código para exibir uma caixa de diálogo Print

O código a seguir demonstra como exibir uma caixa de diálogo Print, imprimindo um arquivo localizado na pasta do aplicativo.

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

Alterações de código para exibir Help

O código a seguir demonstra como exibir um arquivo Help a partir de seu aplicativo, abrindo-o para o índice analítico.

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

Equivalências entre propriedade e método do controle CommonDialog

As tabelas a seguir listam propriedades no Visual Basic 6.0 e métodos e seus Visual Basic 2008 equivalentes. As propriedades e métodos com os mesmo nomes e comportamentos não estão listados.Onde aplicável, constantes são recuadas abaixo a propriedade ou método.All Visual Basic 2008 enumerações mapeiam para o System.Windows.Forms namespace, salvo indicação em contrário.

Links são fornecidos conforme necessário para tópicos explicando diferenças no comportamento.Onde não há nenhum equivalente direto no Visual Basic 2008, são fornecidos links para tópicos que apresentam alternativas.

Propriedades

Visual Basic 6,0	Visual Basic 2008 Equivalent
Action	Nova implementação.O Visual Basic 6.0 Action propriedade determina qual caixa de diálogo exibir; Visual Basic 2008 usa um componente separado para cada caixa de diálogo.
CancelError	Cancel
Copies	Copies
DialogTitle	Title (OpenFileDialog e SaveFileDialog componentes) Nova implementação dos outros componentes.Títulos padrão do Windows (Color, Font, e Print) são exibidos e não podem ser substituídos.
FileName	FileNames
FileTitle	Nova implementação.O Visual Basic 6.0 FileTitle propriedade para retornar a FileName sem o caminho; você pode analisar o FileNames propriedade para obter o nome sem o caminho.
Flags	O Visual Basic 6.0 Flags propriedade fornece constantes para configurar vários atributos das diferentes caixas de diálogo comuns. Em vez de usar constantes, os componentes da caixa de diálogo fornecem propriedades para definir os atributos.
Font FontBold FontItalic FontName FontSize FontStrikethrough FontUnderline	Font Observação: Fontes são tratadas de forma diferente no Visual Basic 2008.Para obter mais informações, consulte Fonte de tratamento para usuários do Visual Basic 6.0.
FromPage	FromPage
hDC	Nova implementação.Para obter mais informações, consulte: Elementos gráficos para usuários do Visual Basic 6.0.
HelpCommand	HelpNavigator
HelpFile	HelpNamespace
HelpKey	The parameter parâmetro das ShowHelp método.
Index	Nova implementação.Para obter mais informações, consulte Controle de matrizes para usuários do Visual Basic 6.0.
InitDir	InitialDirectory
Left	Left Observação: As coordenadas são alça de forma diferente de d Visual Basic 2008.Para obter mais informações, consulte Sistema de Coordenadas para usuários do Visual Basic 6.0.
Max	MaxSize (FontDialog componente) MaximumPage (PrintDialog componente)
Min	MinSize (FontDialog componente) MinimumPage (PrintDialog componente)
MaxFileSize	Nova implementação.Esta propriedade do Visual Basic 6.0 aloca memória para nomes extremamente extensos de arquivos; ela é mais necessária em código gerenciado.
Orientation	Landscape
Parent	Método FindForm
PrinterDefault	Nova implementação.Essa propriedade do Visual Basic 6.0 é usada em conjunto com o hDC propriedade para imprimir usando métodos de interface de dispositivos gráficos; isso não é mais suportado.
Top	P:System.Windows.Forms.Control.Top Observação: Coordenadas são tratados de maneira diferente em Visual Basic 2008.Para obter mais informações, consulte Sistema de Coordenadas para usuários do Visual Basic 6.0.
ToPage	ToPage

Métodos

Visual Basic 6,0	Equivalente Visual Basic 2005
AboutBox	Nova implementação.The AboutBox propriedade exibida um Sobre caixa de a CommonDialog controle foi criado para Microsoft por terceiros.
ShowColor	ShowDialog (ColorDialog componente)
ShowFont	ShowDialog (FontDialog componente)
ShowHelp	ShowHelp
ShowOpen	ShowDialog (OpenFileDialog componente)
ShowPrinter	ShowDialog (PrintDialog componente)
ShowSave	ShowDialog (SaveFileDialog componente)

Observações de Atualização

Ao atualizar um aplicativo do Visual Basic 6.0 para Visual Basic 2008, qualquer CommonDialog controles são atualizados para seus (componente) diálogo equivalenteOpenFileDialog, SaveFileDialog, ColorDialog, FontDialog ou PrintDialog).

Não há nenhum equivalente direto para mostrar um Help caixa de diálogo em Visual Basic 2008. If a CommonDialog controle está sendo usado sistema autônomo um Help caixa de diálogo, um aviso será emitido e ele não será atualizado. Para obter mais informações, consulte Suporte de Ajuda para Usuários do Visual Basic 6.0.

Um único CommonDialog controle pode ser usado para exibir diferentes tipos de caixas de diálogo. Nesse caso será atualizado para um OpenFileDialog componente; um aviso será emitido e você precisará adicionar manualmente as outros componentes da caixa de diálogo.

Além disso, onde um CommonDialog controle foi usado sistema autônomo uma variável que pode ser necessário alterá-lo para se referir a um componente específico da caixa de diálogo após a atualização.