CHOOSEFONTW, structure (commdlg.h)

Contient des informations que la fonction ChooseFont utilise pour initialiser la boîte de dialogue Police . Une fois que l’utilisateur a fermé la boîte de dialogue, le système retourne des informations sur la sélection de l’utilisateur dans cette structure.

Syntaxe

typedef struct tagCHOOSEFONTW {
  DWORD        lStructSize;
  HWND         hwndOwner;
  HDC          hDC;
  LPLOGFONTW   lpLogFont;
  INT          iPointSize;
  DWORD        Flags;
  COLORREF     rgbColors;
  LPARAM       lCustData;
  LPCFHOOKPROC lpfnHook;
  LPCWSTR      lpTemplateName;
  HINSTANCE    hInstance;
  LPWSTR       lpszStyle;
  WORD         nFontType;
  WORD         ___MISSING_ALIGNMENT__;
  INT          nSizeMin;
  INT          nSizeMax;
} CHOOSEFONTW;

Membres

lStructSize

Type : DWORD

Longueur de la structure, en octets.

hwndOwner

Type : HWND

Handle de la fenêtre qui possède la boîte de dialogue. Ce membre peut être n’importe quel handle de fenêtre valide, ou il peut être NULL si la boîte de dialogue n’a pas de propriétaire.

hDC

Type : HDC

Ce membre est ignoré par la fonction ChooseFont .

Windows Vista et Windows XP/2000 : Handle du contexte d’appareil ou du contexte d’informations de l’imprimante dont les polices seront répertoriées dans la boîte de dialogue. Ce membre est utilisé uniquement si le membre Flags spécifie l’indicateur CF_PRINTERFONTS ou CF_BOTH ; sinon, ce membre est ignoré.

lpLogFont

Type : LPLOGFONT

Pointeur vers une structure LOGFONT . Si vous définissez l’indicateur CF_INITTOLOGFONTSTRUCT dans le membre Indicateurs et initialisez les autres membres, la fonction ChooseFont initialise la boîte de dialogue avec une police qui correspond aux membres LOGFONT . Si l’utilisateur clique sur le bouton OK , ChooseFont définit les membres de la structure LOGFONT en fonction des sélections de l’utilisateur.

iPointSize

Type : INT

Taille de la police sélectionnée, en unités de 1/10 d’un point. La fonction ChooseFont définit cette valeur une fois que l’utilisateur a fermé la boîte de dialogue.

Flags

Type : DWORD

Ensemble d’indicateurs de bits que vous pouvez utiliser pour initialiser la boîte de dialogue Police . Lorsque la boîte de dialogue est retournée, elle définit ces indicateurs pour indiquer l’entrée utilisateur. Ce membre peut être une ou plusieurs des valeurs suivantes.

rgbColors

Type : COLORREF

Si l’indicateur CF_EFFECTS est défini, rgbColors spécifie la couleur de texte initiale. Lorsque ChooseFont retourne avec succès, ce membre contient la valeur RVB de la couleur de texte sélectionnée par l’utilisateur. Pour créer une valeur de couleur COLORREF , utilisez la macro RVB .

lCustData

Type : LPARAM

Données définies par l’application que le système transmet à la procédure de hook identifiée par le membre lpfnHook . Lorsque le système envoie le message WM_INITDIALOG à la procédure de hook, le paramètre lParam du message est un pointeur vers la structure CHOOSEFONT spécifiée lors de la création de la boîte de dialogue. La procédure de hook peut utiliser ce pointeur pour obtenir la valeur lCustData .

lpfnHook

Type : LPCFHOOKPROC

Pointeur vers une procédure de crochet CFHookProc qui peut traiter les messages destinés à la boîte de dialogue. Ce membre est ignoré, sauf si l’indicateur CF_ENABLEHOOK est défini dans le membre Indicateurs .

lpTemplateName

Type : LPCTSTR

Nom de la ressource de modèle de boîte de dialogue dans le module identifié par le membre hInstance . Ce modèle est remplacé par le modèle de boîte de dialogue standard. Pour les ressources de boîte de dialogue numérotées, lpTemplateName peut être une valeur retournée par la macro MAKEINTRESOURCE . Ce membre est ignoré, sauf si l’indicateur CF_ENABLETEMPLATE est défini dans le membre Indicateurs .

hInstance

Type : HINSTANCE

Si l’indicateur CF_ENABLETEMPLATEHANDLE est défini dans le membre Flags , hInstance est un handle d’un objet mémoire contenant un modèle de boîte de dialogue. Si l’indicateur CF_ENABLETEMPLATE est défini, hInstance est un handle d’un module qui contient un modèle de boîte de dialogue nommé par le membre lpTemplateName . Si ni CF_ENABLETEMPLATEHANDLE ni CF_ENABLETEMPLATE n’est défini, ce membre est ignoré.

lpszStyle

Type : LPTSTR

Données de style. Si l’indicateur CF_USESTYLE est spécifié, ChooseFont utilise les données de cette mémoire tampon pour initialiser la zone de liste déroulante Style de police . Lorsque l’utilisateur ferme la boîte de dialogue, ChooseFont copie la chaîne de la zone de liste déroulante Style de police dans cette mémoire tampon.

nFontType

Type : WORD

Type de la police sélectionnée lorsque ChooseFont est retourné. Ce membre peut être une ou plusieurs des valeurs suivantes.

___MISSING_ALIGNMENT__

nSizeMin

Type : INT

Taille minimale exprimée en points pouvant être sélectionnée par un utilisateur. ChooseFont reconnaît ce membre uniquement si l’indicateur CF_LIMITSIZE est spécifié.

nSizeMax

Type : INT

Taille maximale exprimée en points pouvant être sélectionnée par un utilisateur. ChooseFont reconnaît ce membre uniquement si l’indicateur CF_LIMITSIZE est spécifié.

Remarques

Configuration requise

Voir aussi

ChooseFont

Bibliothèque de boîtes de dialogue commune

Conceptuel

MAKEINTRESOURCE

Référence