Control CommonDialog para usuarios de Visual Basic 6.0

Artículo
10/07/2008

Actualización: noviembre 2007

El control CommonDialog de Visual Basic 6.0 se ha reemplazado por varios componentes especializados en Visual Basic 2008.

Diferencias conceptuales

En Visual Basic 6.0, el control ActiveX CommonDialog se utiliza para mostrar varios cuadros de diálogos comunes (Abrir, Guardar, Color, Fuente, Imprimir y Ayuda) en la aplicación.

En Visual Basic 2008, el control CommonDialog se ha reemplazado por distintos componentes para mostrar cuadros de diálogo: OpenFileDialog, SaveFileDialog, ColorDialog, FontDialog y PrintDialog.

Nota:
No existe ningún equivalente directo en Visual Basic 2008 para mostrar un cuadro de diálogo Ayuda. El control CommonDialog sólo admitía la Ayuda de Windows; Visual Basic 2008 sólo admite la Ayuda HTML. Visual Basic 2008 utiliza el componente HelpProvider para mostrar la Ayuda de la aplicación. Para obtener más información, vea Compatibilidad con la Ayuda para usuarios de Visual Basic 6.0.

Cambios de código para el control CommonDialog

En los ejemplos siguientes se muestran las diferencias que existen entre las técnicas de codificación de Visual Basic 6.0 y de Visual Basic 2008 en algunos usos habituales del control CommonDialog.

El código se modifica para mostrar un cuadro de diálogo Abrir archivo

En el código siguiente se ilustra cómo se muestra un cuadro de diálogo Abrir archivo, que se inicializa en el directorio Archivos de programa.

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

El código se modifica para mostrar un cuadro de diálogo Guardar archivo

En el código siguiente se ilustra cómo se muestra un cuadro de diálogo Guardar archivo, que guarda el archivo en la carpeta de la aplicación.

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

El código se modifica para mostrar un cuadro de diálogo Imprimir

En el código siguiente se ilustra cómo se muestra un cuadro de diálogo Imprimir, que imprime un archivo ubicado en la carpeta de la aplicación.

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

El código se modifica para mostrar Ayuda

En el código siguiente se ilustra cómo se muestra un archivo de Ayuda en su aplicación, que se abre en la tabla de contenido.

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

Equivalencias de propiedades y métodos del control CommonDialog

En las siguientes tablas se enumeran propiedades y métodos de Visual Basic 6.0 junto con sus equivalentes en Visual Basic 2008. No se enumeran aquellas propiedades y métodos que tienen el mismo nombre y el mismo comportamiento. Donde corresponde, las constantes aparecen con sangría debajo de la propiedad o método. Salvo que se indique lo contrario, todas las enumeraciones de Visual Basic 2008 se asignan al espacio de nombres System.Windows.Forms.

Cuando es necesario, se proporcionan vínculos a temas que explican las diferencias de comportamiento. Cuando no existe un equivalente directo en Visual Basic 2008, se proporcionan vínculos a temas en los que se incluyen alternativas.

Propiedades

Visual Basic 6.0	Visual Basic 2008Equivalente
Action	Nueva implementación. La propiedad Action de Visual Basic 6.0 determina qué cuadro de diálogo se va a mostrar; Visual Basic 2008 utiliza un componente independiente para cada cuadro de diálogo.
CancelError	Cancel
Copies	Copies
DialogTitle	Title (sólo los componentes OpenFileDialog y SaveFileDialog) Nueva implementación para el resto de los componentes. Se muestran títulos estándar de Windows (Color, Font y Print) y no se pueden reemplazar.
FileName	FileNames
FileTitle	Nueva implementación. La propiedad FileTitle de Visual Basic 6.0 devuelve el valor FileName sin la ruta de acceso; puede analizar la propiedad FileNames para obtener el nombre sin la ruta de acceso.
Flags	La propiedad Flags de Visual Basic 6.0 proporciona constantes para configurar varios atributos de diferentes cuadros de diálogo comunes. En lugar de utilizar constantes, los componentes de cuadro de diálogo proporcionan las propiedades para configurar los atributos.
Font FontBold FontItalic FontName FontSize FontStrikethrough FontUnderline	Font Nota: Las fuentes se administran de forma diferente en Visual Basic 2008. Para obtener más información, vea Control de fuentes para usuarios de Visual Basic 6.0.
FromPage	FromPage
hDC	Nueva implementación. Para obtener más información, vea Gráficos para usuarios de Visual Basic 6.0.
HelpCommand	HelpNavigator
HelpFile	HelpNamespace
HelpKey	El parámetro parameter del método ShowHelp.
Index	Nueva implementación. Para obtener más información, vea Matrices de controles para usuarios de Visual Basic 6.0.
InitDir	InitialDirectory
Left	Left Nota: Las coordenadas se administran de forma diferente en Visual Basic 2008. Para obtener más información, vea Sistema de coordenadas para usuarios de Visual Basic 6.0.
Max	MaxSize (componente FontDialog) MaximumPage (componente PrintDialog)
Min	MinSize (componente FontDialog) MinimumPage (componente PrintDialog)
MaxFileSize	Nueva implementación. Esta propiedad de Visual Basic 6.0 asigna memoria a nombres de archivo extremadamente largos; ya no es necesario hacerlo en el código administrado.
Orientation	Landscape
Parent	Método FindForm
PrinterDefault	Nueva implementación. Esta propiedad de Visual Basic 6.0 se utilizaba junto con la propiedad hDC para imprimir mediante métodos de la interfaz de dispositivos gráficos; esta operación ya no se admite.
Top	P:System.Windows.Forms.Control.Top Nota: Las coordenadas se administran de forma diferente en Visual Basic 2008. Para obtener más información, vea Sistema de coordenadas para usuarios de Visual Basic 6.0.
ToPage	ToPage

Métodos

Visual Basic 6.0	Equivalente en Visual Basic 2005
AboutBox	Nueva implementación. La propiedad AboutBox mostraba un cuadro Acerca de en el control CommonDialog que otro fabricante había creado para Microsoft.
ShowColor	ShowDialog (componente ColorDialog)
ShowFont	ShowDialog (componente FontDialog)
ShowHelp	ShowHelp
ShowOpen	ShowDialog (componente OpenFileDialog)
ShowPrinter	ShowDialog (componente PrintDialog)
ShowSave	ShowDialog (componente SaveFileDialog)

Notas de actualización

Cuando se actualiza una aplicación de Visual Basic 6.0 a Visual Basic 2008, todos los controles CommonDialog se actualizan a su componente de cuadro de diálogo equivalente (OpenFileDialog, SaveFileDialog, ColorDialog, FontDialog o PrintDialog).

No existe ningún equivalente directo en Visual Basic 2008 para mostrar un cuadro de diálogo Help. Si un control CommonDialog se utiliza como un cuadro de diálogo Help, se emitirá una advertencia y no se actualizará. Para obtener más información, vea Compatibilidad con la Ayuda para usuarios de Visual Basic 6.0.

Podía utilizarse un único control CommonDialog para mostrar diferentes tipos de cuadros de diálogo. En este caso, se actualizará a un componente OpenFileDialog; se emitirá una advertencia, y deberá agregar los demás componentes de diálogo manualmente.

Además, es posible que necesite cambiar el código que utilizaba un control CommonDialog como una variable para que haga referencia a un componente de diálogo específico después de la actualización.