Biblioteca de cuadros de diálogo comunes

  • Artículo

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 .