Control Control CommonDialog para usuarios de Visual Basic 6.0 Visual Studio 2005 Otras versiones
y
Visual
Studio 2008
El control CommonDialog de Visual Basic 6.0 se ha sustituido por varios varios componentes co mponentes especializados en Visual Basic 2005.
Diferencias conceptuales En Visual Basic 6.0, el control ActiveX CommonDialog se utiliza para mostrar varios cuadros de diálogos comunes co munes (Abrir, Guardar, Color, Fuente, Imprimir y Ayuda) en la aplicación. En Visual Basic 2005, el control CommonDialog se ha reemplazado por distintos componentes para mostrar cuadros de diálogo: OpenFileDialog OpenFileDialog,, SaveFileDialog SaveFileDialog,, ColorDialog,, FontDialog y PrintDialog ColorDialog PrintDialog.. Nota
No existe ningún equivalente directo en Visual Basic 2005 para mostrar un cuadro de diálogo Ayuda. El control CommonDialog sólo admitía la Ayuda de Windows; Visual Basic 2005 sólo admite la Ayuda HTML. Visual Basic 2005 utiliza el componente HelpProvider para HelpProvider para mostrar la Ayuda de la aplicación. Para obtener más información, información, vea Compatibilidad con la Ayuda para usuarios de Visual Basic 6.0. 6.0.
Cambios de código para el control CommonDialog En los ejemplos de código cód igo siguientes se ilustran las diferencias que existen entre las técnicas de codificación de Visual Basic 6.0 y de Visual Basic 2005 en algunos usos comunes 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 pro grama.
' Visual Basic 6.0 ' Uses a CommonDialog control. CommonDialog1.InitDir = "C:\Program Files" CommonDialog1.ShowOpen
VB
C# C++ F# JScript
' Visual Basic 2005 ' 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
VB
C# C++
F# JScript
' Visual Basic 2005 ' 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
VB
C# C++ F# JScript
' Visual Basic 2005 ' 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 e n 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
VB
C# C++ F# JScript
' Visual Basic 2005 ' 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 2005. 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 2005 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 2005, se proporcionan vínculos a temas en los que se incluyen alternativas.
Propiedades Visual Basic 6.0
Equivalente en Visual Basic 2005
Action
Nueva implementación. La propiedad Action de Visual Basic 6.0 determina qué cuadro de diálogo se va a mostrar; Visual Basic 2005 utiliza un componente independiente para cada cuadro de diálogo.
CancelError
Cancel
Copies
Copies Title (sólo los componentes OpenFileDialog y SaveFileDialog)
DialogTitle
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 d iálogo comunes. En lugar de utilizar constantes, los componentes de cuadro de diálogo proporcionan las propiedades para configurar los atributos.
Font FontBold
Font
FontItalic
Nota
FontName
Las fuentes se controlan de forma diferente en Visual Basic 2005. Para obtener más información, vea Control de fuentes para usuarios de Visual Basic 6.0.
FontSize FontStrikethrough FontUnderline 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.
InitialDirectory
InitDir
Left Nota
Left
Las coordenadas se controlan de forma diferente en Visual Basic 2005. Para obtener más información, vea Sistema de coordenadas para usuarios de Visual Basic 6.0. MaxSize (componente FontDialog)
Max
MaximumPage (componente PrintDialog) MinSize (componente FontDialog) Min
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 pro piedad hDC para imprimir mediante métodos de la interfaz de dispositivos gráficos; esta operación ya no se admite. P:System.Windows.Forms.Control.Top
Nota
Top
Las coordenadas se controlan de forma diferente en Visual Basic 2005. 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 2005, 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 2005 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 actua lización. http://msdn.microsoft.com/es-es/library/256tssz7%28v=vs.80%29.aspx
http://es.scribd.com/doc/36423069/256/Puntos-de-interrupcion
