Estructura CHOOSEFONTA (commdlg.h)

Contiene información que la función ChooseFont usa para inicializar el cuadro de diálogo fuente de . 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.

Sintaxis

typedef struct tagCHOOSEFONTA {
  DWORD        lStructSize;
  HWND         hwndOwner;
  HDC          hDC;
  LPLOGFONTA   lpLogFont;
  INT          iPointSize;
  DWORD        Flags;
  COLORREF     rgbColors;
  LPARAM       lCustData;
  LPCFHOOKPROC lpfnHook;
  LPCSTR       lpTemplateName;
  HINSTANCE    hInstance;
  LPSTR        lpszStyle;
  WORD         nFontType;
  WORD         ___MISSING_ALIGNMENT__;
  INT          nSizeMin;
  INT          nSizeMax;
} CHOOSEFONTA;

Miembros

lStructSize

Tipo: DWORD de

Longitud de la estructura, en bytes.

hwndOwner

Tipo: HWND

Identificador de la ventana que posee el cuadro de diálogo. Este miembro puede ser cualquier identificador de ventana válido o puede ser NULL si el cuadro de diálogo no tiene propietario.

hDC

Tipo: HDC

El función ChooseFont omite este miembro.

Windows Vista y Windows XP/2000: Identificador del contexto del dispositivo o contexto de información de la impresora cuyas fuentes se mostrarán en el cuadro de diálogo. Este miembro solo se usa si el miembro Flags especifica la marca CF_PRINTERFONTS o CF_BOTH; de lo contrario, se omite este miembro.

lpLogFont

Tipo: LPLOGFONT de

Puntero a una estructura de LOGFONT. Si establece la marca CF_INITTOLOGFONTSTRUCT en el miembro Flags e inicializa los demás miembros, la función ChooseFont inicializa el cuadro de diálogo con una fuente que coincida con los miembros LOGFONT. Si el usuario hace clic en el botón Aceptar , ChooseFont establece los miembros de la estructura LOGFONT de en función de las selecciones del usuario.

iPointSize

Tipo: INT

Tamaño de la fuente seleccionada, en unidades de 1/10 de un punto. La función ChooseFont establece este valor después de que el usuario cierre el cuadro de diálogo.

Flags

Tipo: DWORD de

Conjunto de marcas de bits que puede usar para inicializar el cuadro de diálogo fuente de . Cuando el cuadro de diálogo vuelve, establece estas marcas para indicar la entrada del usuario. Este miembro puede ser uno o varios de los siguientes valores.

rgbColors

Tipo: COLORREF

Si se establece la marca CF_EFFECTS, rgbColors especifica el color de texto inicial. Cuando ChooseFont devuelve correctamente, este miembro contiene el valor RGB del color de texto seleccionado por el usuario. Para crear un valor de color COLORREF, use la macro RGB de .

lCustData

Tipo: LPARAM

Datos definidos por la aplicación que el sistema pasa al procedimiento de enlace identificado por el miembro lpfnHook. Cuando el sistema envía el mensaje WM_INITDIALOG al procedimiento de enlace, el parámetro lParam del mensaje es un puntero a la estructura CHOOSEFONT especificada al crear el cuadro de diálogo. El procedimiento de enlace puede usar este puntero para obtener el valor de lCustData.

lpfnHook

Tipo: LPCFHOOKPROC

Puntero a un procedimiento de enlace CFHookProc que puede procesar mensajes destinados al cuadro de diálogo. Este miembro se omite a menos que la marca CF_ENABLEHOOK esté establecida en el miembro Flags.

lpTemplateName

Tipo: LPCTSTR de

Nombre del recurso de plantilla del cuadro de diálogo en el módulo identificado por el miembro hInstance. Esta plantilla se sustituye por la plantilla de cuadro de diálogo estándar. Para los recursos del cuadro de diálogo numerado, lpTemplateName puede ser un valor devuelto por la macro MAKEINTRESOURCE. Este miembro se omite a menos que la marca de CF_ENABLETEMPLATE esté establecida en el miembro Flags.

hInstance

Tipo: HINSTANCE

Si la marca CF_ENABLETEMPLATEHANDLE está establecida en el miembro flags de , hInstance es un identificador de un objeto de memoria que contiene una plantilla de cuadro de diálogo. Si se establece la marca CF_ENABLETEMPLATE, hInstance es un identificador de un módulo que contiene una plantilla de cuadro de diálogo denominada por el miembro lpTemplateName. Si no se establece ni CF_ENABLETEMPLATEHANDLE ni CF_ENABLETEMPLATE, se omite este miembro.

lpszStyle

Tipo: LPTSTR de

Datos de estilo. Si se especifica la marca CF_USESTYLE, ChooseFont usa los datos de este búfer para inicializar el cuadro combinado Estilo de fuente. Cuando el usuario cierra el cuadro de diálogo, ChooseFont copia la cadena en el cuadro combinado estilo de fuente en este búfer.

nFontType

Tipo: word

Tipo de la fuente seleccionada cuando se devuelve ChooseFont. Este miembro puede ser uno o varios de los siguientes valores.

___MISSING_ALIGNMENT__

nSizeMin

Tipo: INT

Tamaño mínimo de punto que un usuario puede seleccionar. ChooseFont reconoce este miembro solo si se especifica la marca CF_LIMITSIZE.

nSizeMax

Tipo: INT

Tamaño máximo de punto que puede seleccionar un usuario. ChooseFont reconoce este miembro solo si se especifica la marca CF_LIMITSIZE.

Observaciones

Requisitos

Consulte también

ChooseFont

biblioteca de cuadros de diálogo común de

conceptual de

MAKEINTRESOURCE

de referencia de