Estructura CHOOSEFONTA (commdlg.h)

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.

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

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

La 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

Puntero a una estructura LOGFONT . Si establece la marca de 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 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

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

rgbColors

Tipo: COLORREF

Si se establece la marca CF_EFFECTS , rgbColors especifica el color de texto inicial. Cuando ChooseFont vuelve 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 .

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 cuando se creó el cuadro de diálogo. El procedimiento de enlace puede usar este puntero para obtener el valor 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 de CF_ENABLEHOOK esté establecida en el miembro Flags .

lpTemplateName

Tipo: LPCTSTR

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 de cuadro de diálogo numerados, 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 se establece en el miembro Flags , 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

Los 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 ChooseFont devuelve. Este miembro puede ser uno o varios de los valores siguientes.

___MISSING_ALIGNMENT__

nSizeMin

Tipo: INT

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

nSizeMax

Tipo: INT

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

Comentarios

Requisitos

Consulte también

ChooseFont

Biblioteca de cuadros de diálogo comunes

Conceptual

MAKEINTRESOURCE

Referencia