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 invierten en aprender el comportamiento de la interfaz de usuario de la aplicación.
En esta sección se describen los cuadros de diálogo comunes que incluyen los cuadros de diálogo Abrir y Guardar como archivo; los cuadros de diálogo Buscar y reemplazar edición; los cuadros de diálogo Imprimir, Configurar impresión, Imprimir Hoja de propiedades y Configurar página ; y los cuadros de diálogo Color y Fuente .
Nota
A partir de Windows Vista, los cuadros de diálogo Abrir y Guardar como comunes se han reemplazado por el cuadro de diálogo elemento común. Se recomienda usar common item dialog API 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 distintos cuadros de diálogo. |
Marcas de inicialización comunes del cuadro de diálogo | Describe cómo se usan las marcas para modificar el comportamiento y la apariencia de un cuadro de diálogo común. |
Personalizar 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 API. |
Functions
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 Color que permite al usuario seleccionar un color. |
ChooseFont | Crea un cuadro de diálogo 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 común del cuadro de diálogo. Este código indica el error más reciente que se va a producir durante la ejecución de una de las funciones comunes del cuadro de diálogo. |
FindText | Crea un cuadro de diálogo Buscar modelo definido por el sistema que permite al usuario especificar una cadena para buscar y opciones que se usarán al buscar texto en un documento. |
FRHookProc | Recibe mensajes o notificaciones destinados al procedimiento de 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 Abrir que permite al usuario especificar la unidad, el directorio y el nombre de un archivo o conjunto de archivos que se van a abrir. |
GetSaveFileName | Crea un cuadro de diálogo Guardar que permite al usuario especificar la unidad, el directorio y el nombre de un 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 de los controles adicionales que haya definido especificando una plantilla 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 Configurar 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 Configurar 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 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 Configurar 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ónPageSetupDlg. |
PrintDlg | Muestra uncuadro de diálogo 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 Print que permite al usuario especificar las propiedades de un trabajo de impresión determinado. Una hoja de propiedadesPrinttiene una página General que contiene controles similares al 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 modelado definido por el sistema que permite al usuario especificar una cadena para buscar y una cadena de reemplazo, así como opciones para controlar las operaciones de búsqueda y reemplazo. |
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 Configurar 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 que una aplicación use la función PrintDlgEx para recuperar información sobre la impresora seleccionada actualmente. |
error de Hadoop
Nombre | Descripción |
---|---|
CDM_GETFILEPATH | Recupera la ruta de acceso y el nombre de archivo 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 tiene abierto actualmente 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 acceso de la carpeta o directorio abierto 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 de acceso) 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 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 Fuente para recuperar información sobre las selecciones de fuente actuales del usuario. |
WM_CHOOSEFONT_SETFLAGS | Una aplicación envía el mensaje WM_CHOOSEFONT_SETFLAGS a un cuadro de diálogo Fuente para establecer las opciones de presentació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 Fuente para establecer la información de fuente lógica actual. |
Notificaciones
Nombre | Descripción |
---|---|
CDN_FILEOK | Enviado por 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 | Enviado por un cuadro de diálogo Abrir o Guardar como de estilo explorador cuando se abre una nueva carpeta. |
CDN_HELP | Enviado por un cuadro de diálogo Abrir o Guardar como de estilo explorador cuando el usuario hace clic en el botón Ayuda . |
CDN_INCLUDEITEM | Enviado por 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 | Enviado por un cuadro de diálogo Abrir o Guardar como de estilo Explorador cuando el sistema haya terminado de organizar los controles en el cuadro de diálogo. El sistema mueve los controles estándar para dejar espacio a los controles del cuadro de diálogo secundario. |
CDN_SELCHANGE | Enviado por 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 | Enviado por 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 | Enviado por 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 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 rechace el color y obligue 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 de archivo y permitir que el cuadro de diálogo se cierre, o bien rechazar el nombre de archivo y forzar 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 propietaria 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 propietaria 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 Configurar página , PagePaintHook, que el cuadro de diálogo está a punto de dibujar el rectángulo sobre-stamp de la página de ejemplo. |
WM_PSD_FULLPAGERECT | Notifica a un procedimiento de enlace PagePaintHook de las coordenadas del rectángulo de página de ejemplo en el cuadro de diálogo Configurar 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 de un cuadro de diálogo Configurar 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 Configurar 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 de las coordenadas del rectángulo de margen en la página de ejemplo. Un cuadro de diálogo Configurar 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 Configurar 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 Configurar página , PagePaintHook, que el cuadro de diálogo está a punto de dibujar la parte de la dirección de retorno 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 e PrintDlg usan estas cadenas para inicializar la hoja de propiedades de impresión definida por el sistema o el cuadro de diálogo 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 propietaria de un cuadro de diálogo Buscar o Reemplazar . |
OFNOTIFY | Ccontains información sobre un mensaje de 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 de 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éntico 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 Configurar 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 en 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 Print. 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 . |