Biblioteca de cuadros de diálogo comunes
La biblioteca de cuadros de diálogo comunes contiene un conjunto de cuadros de diálogo para realizar tareas comunes de la aplicación, como abrir archivos, elegir valores de color e imprimir documentos. Los cuadros de diálogo comunes permiten implementar un enfoque coherente con la interfaz de usuario de la aplicación. Esto reduce la cantidad de esfuerzo que los usuarios dedican a aprender el comportamiento de la interfaz de usuario de su aplicación.
En esta sección se describen los cuadros de diálogo comunes, entre los que se incluyen los cuadros de diálogo de archivo Abrir y Guardar como, los cuadros de diálogo de edición Buscar y Reemplazar, los cuadros de diálogo de impresión Imprimir, Configuración de impresión, Hoja de propiedades de impresión y Configuración de página y los cuadros de diálogo de Color y Fuente.
Nota:
A partir de Windows Vista, los cuadros de diálogo comunes de Abrir y Guardar como se han reemplazado por el cuadro de diálogo común Elemento. Se recomienda usar la API del cuadro de diálogo común Elemento en lugar de estos cuadros de diálogo de la biblioteca de cuadros de diálogo comunes.
En esta sección
| Nombre | Descripción |
|---|---|
| Tipos de cuadros de diálogo comunes | Describe los diferentes cuadros de diálogo. |
| Marcas de inicialización de cuadro de diálogo común | Describe cómo se usan las marcas para modificar el comportamiento y la apariencia de un cuadro de diálogo común. |
| Personalización de cuadros de diálogo comunes | Describe cómo usar cuadros de diálogo comunes. |
| Uso de cuadros de diálogo comunes | Trata las tareas que invocan cuadros de diálogo comunes. |
| Referencia de cuadro de diálogo común | Contiene la referencia de la API. |
Funciones
| Nombre | Descripción |
|---|---|
| CCHookProc | Recibe mensajes o notificaciones destinados al procedimiento de cuadro de diálogo predeterminado del cuadro de diálogo Color. Se trata de una función de devolución de llamada definida por la aplicación o definida por la biblioteca que se usa con la función ChooseColor. |
| CFHookProc | Recibe mensajes o notificaciones destinados al procedimiento de cuadro de diálogo predeterminado del cuadro de diálogo Fuente. Se trata de un procedimiento de devolución de llamada definido por la aplicación o definido por la biblioteca que se usa con la función ChooseFont. |
| ChooseColor | Crea un cuadro de diálogo de Color que permite al usuario seleccionar un color. |
| ChooseFont | Crea un cuadro de diálogo de Fuente que permite al usuario elegir atributos para una fuente lógica. Estos atributos incluyen una familia de fuentes y un estilo de fuente asociado, un tamaño de punto, efectos (subrayado, tachado y color de texto) y un script (o juego de caracteres). |
| CommDlgExtendedError | Devuelve un código de error del cuadro de diálogo común. Este código indica el error más reciente que se produce durante la ejecución de una de las funciones comunes del cuadro de diálogo. |
| FindText | Crea un cuadro de diálogo de Buscar no modal y definido por el sistema que permite al usuario especificar una cadena para buscar y las opciones que se usarán al buscar texto en un documento. |
| FRHookProc | Recibe mensajes o notificaciones destinados al procedimiento del cuadro de diálogo predeterminado del cuadro de diálogo Buscar o Reemplazar. Se trata de una función de devolución de llamada definida por la aplicación o definida por la biblioteca que se usa con la función FindText o ReplaceText. |
| GetFileTitle | Recupera el nombre del archivo especificado. |
| GetOpenFileName | Crea un cuadro de diálogo de Abrir que permite al usuario especificar la unidad, el directorio y el nombre de un archivo o conjunto de archivos que se va a abrir. |
| GetSaveFileName | Crea un cuadro de diálogo de Guardar que permite al usuario especificar la unidad, el directorio y el nombre del archivo que se va a guardar. |
| OFNHookProc | Recibe mensajes de notificación enviados desde el cuadro de diálogo. La función también recibe mensajes para los controles adicionales que haya definido especificando una plantilla de cuadro de diálogo secundario. Se trata de una función de devolución de llamada definida por la aplicación o definida por la biblioteca que se usa con los cuadros de diálogo Abrir y Guardar como de estilo Explorador. |
| OFNHookProcOldStyle | Recibe mensajes o notificaciones destinados al procedimiento del cuadro de diálogo. Se trata de una función de devolución de llamada definida por la aplicación o definida por la biblioteca que se usa con los cuadros de diálogo Abrir y Guardar como. |
| PagePaintHook | Recibe mensajes que permiten personalizar el dibujo de la página de ejemplo en el cuadro de diálogo Configuración de página. Se trata de una función de devolución de llamada definida por la aplicación o definida por la biblioteca que se usa con la función PageSetupDlg. |
| PageSetupDlg | Crea un cuadro de diálogo de Configuración de página que permite al usuario especificar los atributos de una página impresa. Estos atributos incluyen el tamaño y el origen del papel, la orientación de la página (vertical u horizontal) y el ancho de los márgenes de página. |
| PageSetupHook | Recibe mensajes o notificaciones destinados al procedimiento de cuadro de diálogo predeterminado del cuadro de diálogo Configuración de página. Se trata de una función de devolución de llamada definida por la aplicación o definida por la biblioteca que se usa con la función PageSetupDlg. |
| PrintDlg | Muestra un cuadro de diálogo de Imprimir. El cuadro de diálogo Imprimir permite al usuario especificar las propiedades de un trabajo de impresión determinado. |
| PrintDlgEx | Muestra una hoja de propiedades de Imprimir que permite al usuario especificar las propiedades de un trabajo de impresión determinado. Una hoja de propiedades de Imprimir tiene una página General que contiene controles similares a los del cuadro de diálogo Imprimir. La hoja de propiedades también puede tener páginas de propiedades específicas de la aplicación y específicas del controlador, así como la página General. |
| PrintHookProc | Recibe mensajes o notificaciones destinados al procedimiento de cuadro de diálogo predeterminado del cuadro de diálogo Imprimir. Se trata de una función de devolución de llamada definida por la aplicación o definida por la biblioteca que se usa con la función PrintDlg. |
| ReplaceText | Crea un cuadro de diálogo no modal definido por el sistema que permite al usuario especificar una cadena para buscar y reemplazar, así como opciones para controlar las operaciones de buscar y reemplazar. |
| SetupHookProc | Función de devolución de llamada definida por la aplicación o definida por la biblioteca que se usa con la función PrintDlg. El procedimiento de enlace recibe mensajes o notificaciones destinados al procedimiento de cuadro de diálogo predeterminado del cuadro de diálogo Configuración de impresión. |
Interfaces
| Nombre | Descripción |
|---|---|
| IPrintDialogCallback | Proporciona métodos que permiten a una aplicación recibir notificaciones y mensajes de la función PrintDlgEx mientras se muestra la hoja de propiedades de impresión. |
| IPrintDialogServices | Proporciona métodos que permiten a una aplicación usar la función PrintDlgEx para recuperar información sobre la impresora seleccionada actualmente. |
Mensajes
| Nombre | Descripción |
|---|---|
| CDM_GETFILEPATH | Recupera la ruta y el nombre del archivo seleccionado en un cuadro de diálogo Abrir o Guardar como de estilo Explorador. El cuadro de diálogo debe haberse creado con la marca OFN_EXPLORER; de lo contrario, se produce un error en el mensaje. |
| CDM_GETFOLDERIDLIST | Recupera la dirección de la lista de identificadores de elemento correspondiente a la carpeta que actualmente tiene abierto un cuadro de diálogo Abrir o Guardar como de estilo Explorador. El cuadro de diálogo debe haberse creado con la marca OFN_EXPLORER; de lo contrario, se produce un error en el mensaje. |
| CDM_GETFOLDERPATH | Recupera la ruta de la carpeta o el directorio abiertos actualmente para un cuadro de diálogo Abrir o Guardar como de estilo Explorador. El cuadro de diálogo debe haberse creado con la marca OFN_EXPLORER; de lo contrario, se produce un error en el mensaje. |
| CDM_GETSPEC | Recupera el nombre de archivo (sin incluir la ruta) del archivo seleccionado actualmente en un cuadro de diálogo Abrir o Guardar como de estilo Explorador. El cuadro de diálogo debe haberse creado con la marca OFN_EXPLORER; de lo contrario, se produce un error en el mensaje. |
| CDM_HIDECONTROL | Oculta el control especificado en un cuadro de diálogo Abrir o Guardar como de estilo Explorador. El cuadro de diálogo debe haberse creado con la marca OFN_EXPLORER; de lo contrario, se produce un error en el mensaje. |
| CDM_SETCONTROLTEXT | Establece el texto del control especificado en un cuadro de diálogo Abrir o Guardar como de estilo Explorador. El cuadro de diálogo debe haberse creado con la marca OFN_EXPLORER; de lo contrario, se produce un error en el mensaje. |
| CDM_SETDEFEXT | Establece la extensión de nombre de archivo predeterminada para un cuadro de diálogo Abrir o Guardar como de estilo Explorador. El cuadro de diálogo debe haberse creado con la marca OFN_EXPLORER; de lo contrario, se produce un error en el mensaje. |
| SETRGBSTRING | El procedimiento de enlace de un cuadro de diálogo de Color, CCHookProc, puede enviar el mensaje registrado SETRGBSTRING al cuadro de diálogo para establecer la selección de color actual. |
| WM_CHOOSEFONT_GETLOGFONT | Una aplicación envía el mensaje WM_CHOOSEFONT_GETLOGFONT a un cuadro de diálogo de Fuente para recuperar información sobre las selecciones de fuentes actuales del usuario. |
| WM_CHOOSEFONT_SETFLAGS | Una aplicación envía el mensaje WM_CHOOSEFONT_SETFLAGS a un cuadro de diálogo de Fuente para establecer las opciones de visualización del cuadro de diálogo. |
| WM_CHOOSEFONT_SETLOGFONT | Una aplicación envía el mensaje WM_CHOOSEFONT_SETLOGFONT a un cuadro de diálogo de Fuente para establecer la información de fuente lógica actual. |
Notificaciones
| Nombre | Descripción |
|---|---|
| CDN_FILEOK | La envía un cuadro de diálogo Abrir o Guardar como de estilo Explorador cuando el usuario especifica un nombre de archivo y hace clic en el botón Aceptar. |
| CDN_FOLDERCHANGE | La envía un cuadro de diálogo Abrir o Guardar como de estilo Explorador cuando se abre una nueva carpeta. |
| CDN_HELP | La envía un cuadro de diálogo Abrir o Guardar como de estilo Explorador cuando el usuario hace clic en el botón Ayuda. |
| CDN_INCLUDEITEM | La envía un cuadro de diálogo Abrir o Guardar como para determinar si el cuadro de diálogo debe mostrar un elemento en la lista de elementos de una carpeta de shell. Cuando el usuario abre una carpeta, el cuadro de diálogo envía una notificación CDN_INCLUDEITEM para cada elemento de la carpeta. El cuadro de diálogo envía esta notificación solo si se estableció la marca OFN_ENABLEINCLUDENOTIFY cuando se creó el cuadro de diálogo. |
| CDN_INITDONE | La envía un cuadro de diálogo Abrir o Guardar como de estilo Explorador cuando el sistema termina de organizar los controles en el cuadro de diálogo. El sistema mueve los controles estándar para dejar espacio para los controles del cuadro de diálogo secundario. |
| CDN_SELCHANGE | La envía un cuadro de diálogo Abrir o Guardar como de estilo Explorador cuando la selección cambia en el cuadro de lista que muestra el contenido de la carpeta o directorio abiertos actualmente. |
| CDN_SHAREVIOLATION | La envía un cuadro de diálogo Abrir o Guardar como de estilo Explorador cuando el usuario hace clic en el botón Aceptar y se produce una infracción de uso compartido de red para el archivo seleccionado. |
| CDN_TYPECHANGE | La envía un cuadro de diálogo Abrir o Guardar como de estilo Explorador cuando el usuario selecciona un nuevo tipo de archivo en el cuadro combinado de tipos de archivo. |
| COLOROKSTRING | Un cuadro de diálogo Color envía el mensaje registrado COLOROKSTRING al procedimiento de enlace, CCHookProc cuando el usuario selecciona un color y hace clic en el botón Aceptar. El procedimiento de enlace puede aceptar el color y permitir que el cuadro de diálogo se cierre o bien rechazar el color y obligar a que el cuadro de diálogo permanezca abierto. |
| FILEOKSTRING | Un cuadro de diálogo Abrir o Guardar como envía el mensaje registrado FILEOKSTRING al procedimiento de enlace OFNHookProc cuando el usuario especifica un nombre de archivo y hace clic en el botón Aceptar. El procedimiento de enlace puede aceptar el nombre del archivo y permitir que el cuadro de diálogo se cierre o bien rechazar el nombre del archivo y obligar a que el cuadro de diálogo permanezca abierto. |
| FINDMSGSTRING | Un cuadro de diálogo Buscar o Reemplazar envía el mensaje registrado FINDMSGSTRING al procedimiento de ventana de su ventana de propietario cuando el usuario hace clic en el botón Buscar siguiente, Reemplazar o Reemplazar todo, o cierra el cuadro de diálogo. |
| HELPMSGSTRING | Un cuadro de diálogo común envía el mensaje registrado HELPMSGSTRING al procedimiento de ventana de su ventana de propietario cuando el usuario hace clic en el botón Ayuda. |
| LBSELCHSTRING | Un cuadro de diálogo Abrir o Guardar como envía el mensaje registrado LBSELCHSTRING al procedimiento de enlace cuando la selección cambia en cualquiera de los cuadros de lista o cuadros combinados del cuadro de diálogo. |
| SHAREVISTRING | Un cuadro de diálogo Abrir o Guardar como envía el mensaje registrado SHAREVISTRING al procedimiento de enlace OFNHookProc si se produce una infracción de uso compartido para el archivo seleccionado cuando el usuario hace clic en el botón Aceptar. |
| WM_PSD_ENVSTAMPRECT | Notifica al procedimiento de enlace de un cuadro de diálogo Configuración de página, PagePaintHook, que el cuadro de diálogo está a punto de dibujar el rectángulo de sello de sobre de la página de ejemplo. |
| WM_PSD_FULLPAGERECT | Notifica a un procedimiento de enlace PagePaintHook las coordenadas del rectángulo de página de ejemplo en el cuadro de diálogo Configuración de página. El cuadro de diálogo envía este mensaje cuando está a punto de dibujar el contenido de la página de ejemplo. |
| WM_PSD_GREEKTEXTRECT | Notifica al procedimiento de enlace un cuadro de diálogo Configuración de página, PagePaintHook, que el cuadro de diálogo está a punto de dibujar texto griego dentro del rectángulo de margen de la página de ejemplo. |
| WM_PSD_MARGINRECT | Notifica al procedimiento de enlace de un cuadro de diálogo Configuración de página, PagePaintHook, que el cuadro de diálogo está a punto de dibujar el rectángulo de margen de la página de ejemplo. |
| WM_PSD_MINMARGINRECT | Notifica a un procedimiento de enlace PagePaintHook las coordenadas del rectángulo de margen en la página de ejemplo. Un cuadro de diálogo Configuración de página envía este mensaje cuando está a punto de dibujar el contenido de la página de ejemplo. |
| WM_PSD_PAGESETUPDLG | Notifica a un procedimiento de enlace PagePaintHook que el cuadro de diálogo Configuración de página está a punto de dibujar el contenido de la página de ejemplo. El procedimiento de enlace puede usar este mensaje para llevar a cabo tareas de inicialización relacionadas con el dibujo del contenido de la página de ejemplo. |
| WM_PSD_YAFULLPAGERECT | Notifica al procedimiento de enlace de un cuadro de diálogo Configuración de página, PagePaintHook, que el cuadro de diálogo está a punto de devolver la parte de dirección de una página de ejemplo de sobre. |
Estructuras
| Nombre | Descripción |
|---|---|
| CHOOSECOLOR | Contiene información que la función ChooseColor usa para inicializar el cuadro de diálogo Color. Una vez que el usuario cierra el cuadro de diálogo, el sistema devuelve información sobre la selección del usuario en esta estructura. |
| CHOOSEFONT | Contiene información que la función ChooseFont usa para inicializar el cuadro de diálogo Fuente. Una vez que el usuario cierra el cuadro de diálogo, el sistema devuelve información sobre la selección del usuario en esta estructura. |
| DEVNAMES | Contiene cadenas que identifican los nombres de puerto de salida, dispositivo y controlador para una impresora. Las funciones PrintDlgEx y PrintDlg usan estas cadenas para inicializar los cuadros de diálogo definidos por el sistema Hoja de propiedades de impresión o Imprimir. Cuando el usuario cierra la hoja de propiedades o el cuadro de diálogo, se devuelve información sobre la impresora seleccionada en esta estructura. |
| FINDREPLACE | Contiene información que las funciones FindText y ReplaceText usan para inicializar los cuadros de diálogo Buscar y Reemplazar. El mensaje registrado FINDMSGSTRING usa esta estructura para pasar la entrada de búsqueda o reemplazo del usuario a la ventana de propietario de un cuadro de diálogo Buscar o Reemplazar. |
| OFNOTIFY | Ccontains información sobre un mensaje WM_NOTIFY enviado a un procedimiento de enlace OFNHookProc para un cuadro de diálogo Abrir o Guardar como. El parámetro lParam del mensaje WM_NOTIFY es un puntero a una estructura OFNOTIFY. |
| OFNOTIFYEX | Contiene información sobre un mensaje de notificación CDN_INCLUDEITEM. |
| OPENFILENAME | Contiene información que las funciones GetOpenFileName y GetSaveFileName usan para inicializar un cuadro de diálogo Abrir o Guardar como. Una vez que el usuario cierra el cuadro de diálogo, el sistema devuelve información sobre la selección del usuario en esta estructura. |
| OPENFILENAME_NT4 | Idéntica a OPENFILENAME con _WIN32_WINNT establecido en 0x0400. |
| PAGESETUPDLG | Contiene información que la función PageSetupDlg usa para inicializar el cuadro de diálogo Configuración de página. Una vez que el usuario cierra el cuadro de diálogo, el sistema devuelve información sobre los parámetros de página definidos por el usuario de esta estructura. |
| PRINTDLG | Contiene información que la función PrintDlg usa para inicializar el cuadro de diálogo Imprimir. Una vez que el usuario cierra el cuadro de diálogo, el sistema usa esta estructura para devolver información sobre las selecciones del usuario. |
| PRINTDLGEX | Contiene información que la función PrintDlgEx usa para inicializar la hoja de propiedades de impresión. Una vez que el usuario cierra la hoja de propiedades, el sistema usa esta estructura para devolver información sobre las selecciones del usuario. |
| PRINTPAGERANGE | Especifica un intervalo de páginas en un trabajo de impresión. Un trabajo de impresión puede tener más de un intervalo de páginas. Esta información se proporciona en la estructura PRINTDLGEX al llamar a la función PrintDlgEx. |