Tipos comunes de cuadros de diálogo

La biblioteca de cuadros de diálogo comunes proporciona una función de creación y una estructura para cada tipo de cuadro de diálogo común. Para usar un cuadro de diálogo común en su forma más sencilla, llame a su función de creación y especifique un puntero a una estructura que contenga valores iniciales y marcas de opción. Después de inicializar el cuadro de diálogo, el procedimiento del cuadro de diálogo usa la estructura para devolver información sobre la entrada del usuario. También puede personalizar un cuadro de diálogo común para satisfacer las necesidades de la aplicación.

En la tabla siguiente se proporciona una breve descripción de los distintos tipos de cuadros de diálogo comunes y se muestra la función y la estructura usadas con cada tipo.

Cuadro de diálogo	Descripción
Color	Muestra los colores disponibles y, opcionalmente, permite al usuario crear colores personalizados. El usuario puede seleccionar un color básico o personalizado. Use la función ChooseColor y la estructura CHOOSECOLOR . Para obtener más información, vea Cuadro de diálogo Color.
Buscar	Muestra un cuadro de diálogo en el que el usuario puede escribir la cadena que se va a buscar. El usuario también puede especificar opciones de búsqueda, como la dirección de búsqueda y si la búsqueda distingue mayúsculas de minúsculas. Use la función FindText y la estructura FINDREPLACE . Para obtener más información, vea Buscar y reemplazar cuadros de diálogo.
Fuente	Muestra un cuadro de diálogo en el que el usuario puede seleccionar una familia de fuentes y un estilo de fuente asociado, tamaños de punto y otros atributos de fuente, como color de fuente, subrayado o tachado. Use la función ChooseFont y la estructura CHOOSEFONT . Para obtener más información, vea Cuadro de diálogo Fuente.
Abrir	Muestra un cuadro de diálogo en el que el usuario puede escribir o seleccionar el nombre de un archivo o un objeto de espacio de nombres de shell que se va a abrir. El cuadro de diálogo incluye listas de unidades, directorios y extensiones de espacio de nombres de shell que permiten al usuario examinar el espacio de nombres del shell. También incluye una lista de extensiones de nombre de archivo que permite al usuario filtrar los nombres de archivo mostrados. Use la función GetOpenFileName y la estructura OPENFILENAME . Para obtener más información, vea Abrir y guardar como cuadros de diálogo.
Configuración de página	Muestra la configuración de página actual. El usuario puede seleccionar opciones de configuración de página, como orientación de papel, tamaño, origen y márgenes. Use la función PageSetupDlg y la estructura PAGESETUPDLG . Para obtener más información, vea Cuadro de diálogo Configurar página.
Imprimir	Muestra información sobre la impresora instalada y su configuración. El usuario puede seleccionar opciones de trabajo de impresión, como el intervalo de páginas para imprimir y el número de copias, e iniciar el proceso de impresión. Use la función PrintDlg y la estructura PRINTDLG . Para obtener más información, vea Imprimir cuadro de diálogo. Para mostrar una hoja de propiedades Print en lugar de un cuadro de diálogo Imprimir , use la función PrintDlgEx con la estructura PRINTDLGEX . La página General de la hoja de propiedades es similar al cuadro de diálogo Imprimir . La hoja de propiedades puede tener páginas de propiedades adicionales específicas de la aplicación y específicas del controlador después de la página General . Para obtener más información, vea Imprimir hoja de propiedades.
Sustituya	Muestra un cuadro de diálogo en el que el usuario puede escribir la cadena para buscar y la cadena de reemplazo. El usuario puede especificar opciones de búsqueda, como si la búsqueda distingue mayúsculas de minúsculas y opciones de reemplazo, como el ámbito de reemplazo. Use la función ReplaceText y la estructura FINDREPLACE . Para obtener más información, vea Buscar y reemplazar cuadros de diálogo.
Guardar como	Muestra un cuadro de diálogo en el que el usuario puede escribir o seleccionar el nombre con el que guardar un archivo o un objeto de espacio de nombres de shell. El cuadro de diálogo incluye listas de unidades, directorios y extensiones de espacio de nombres de shell que permiten al usuario examinar el espacio de nombres del shell. También incluye una lista de extensiones de nombre de archivo que permite al usuario filtrar los nombres de archivo mostrados. Use la función GetSaveFileName y la estructura OPENFILENAME . Para obtener más información, vea Abrir y guardar como cuadros de diálogo.

Aunque hay disponible un cuadro de diálogo Configurar impresión , se ha reemplazado por el cuadro de diálogo Configurar página . Las aplicaciones deben usar el cuadro de diálogo Configurar página en lugar del cuadro de diálogo Configurar impresión .

Todos los cuadros de diálogo comunes son modales, excepto los cuadros de diálogo Buscar y reemplazar . El usuario debe cerrar los cuadros de diálogo modales para poder devolver la función utilizada para crear el cuadro de diálogo. Los cuadros de diálogo Buscar y reemplazar son modelos; la función devuelve antes de que se cierre el cuadro de diálogo. Si usa los cuadros de diálogo Buscar y reemplazar , también debe usar la función IsDialogMessage en el bucle de mensajes principal de la aplicación para asegurarse de que estos cuadros de diálogo procesan correctamente la entrada del teclado, como las teclas TAB y ESC.