Struttura CHOOSEFONTA (commdlg.h)

Contiene informazioni usate dalla funzione ChooseFont per inizializzare la finestra di dialogo Carattere . Dopo aver chiuso la finestra di dialogo, il sistema restituisce informazioni sulla selezione dell'utente in questa struttura.

Sintassi

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;

Members

lStructSize

Tipo: DWORD

Lunghezza della struttura, in byte.

hwndOwner

Tipo: HWND

Handle nella finestra che possiede la finestra di dialogo. Questo membro può essere qualsiasi handle di finestra valido oppure può essere NULL se la finestra di dialogo non ha alcun proprietario.

hDC

Tipo: HDC

Questo membro viene ignorato dalla funzione ChooseFont .

Windows Vista e Windows XP/2000: Handle per il contesto del dispositivo o il contesto informativo della stampante i cui tipi di carattere verranno elencati nella finestra di dialogo. Questo membro viene usato solo se il membro Flags specifica il flag CF_PRINTERFONTS o CF_BOTH ; in caso contrario, questo membro viene ignorato.

lpLogFont

Tipo: LPLOGFONT

Puntatore a una struttura LOGFONT . Se si imposta il flag di CF_INITTOLOGFONTSTRUCT nel membro Flags e si inizializza l'altro membro, la funzione ChooseFont inizializza la finestra di dialogo con un tipo di carattere corrispondente ai membri LOGFONT . Se l'utente fa clic sul pulsante OK , ChooseFont imposta i membri della struttura LOGFONT in base alle selezioni dell'utente.

iPointSize

Tipo: INT

Dimensione del tipo di carattere selezionato, in unità di 1/10 di un punto. La funzione ChooseFont imposta questo valore dopo che l'utente chiude la finestra di dialogo.

Flags

Tipo: DWORD

Set di flag di bit che è possibile usare per inizializzare la finestra di dialogo Carattere . Quando la finestra di dialogo restituisce, imposta questi flag per indicare l'input dell'utente. Questo membro può essere uno o più dei valori seguenti.

rgbColors

Tipo: COLORREF

Se il flag di CF_EFFECTS è impostato, rgbColors specifica il colore di testo iniziale. Quando ChooseFont restituisce correttamente, questo membro contiene il valore RGB del colore del testo selezionato dall'utente. Per creare un valore di colore COLORREF , usare la macro RGB .

lCustData

Tipo: LPARAM

Dati definiti dall'applicazione che il sistema passa alla procedura di hook identificata dal membro lpfnHook . Quando il sistema invia il messaggio di WM_INITDIALOG alla procedura di hook, il parametro lParam del messaggio è un puntatore alla struttura CHOOSEFONT specificata al momento della creazione della finestra di dialogo. La procedura di hook può usare questo puntatore per ottenere il valore lCustData .

lpfnHook

Tipo: LPCFHOOKPROC

Puntatore a una routine di hook CFHookProc che può elaborare i messaggi destinati alla finestra di dialogo. Questo membro viene ignorato a meno che il flag di CF_ENABLEHOOK non sia impostato nel membro Flags .

lpTemplateName

Tipo: LPCTSTR

Nome della risorsa modello della finestra di dialogo nel modulo identificato dal membro hInstance . Questo modello viene sostituito per il modello di finestra di dialogo standard. Per le risorse della finestra di dialogo numerate, lpTemplateName può essere un valore restituito dalla macro MAKEINTRESOURCE . Questo membro viene ignorato a meno che il flag di CF_ENABLETEMPLATE non sia impostato nel membro Flags .

hInstance

Tipo: HINSTANCE

Se il flag di CF_ENABLETEMPLATEHANDLE è impostato nel membro Flags , hInstance è un handle su un oggetto memoria contenente un modello di finestra di dialogo. Se il flag CF_ENABLETEMPLATE è impostato, hInstance è un handle su un modulo che contiene un modello di finestra di dialogo denominato dal membro lpTemplateName . Se non viene impostato né CF_ENABLETEMPLATEHANDLE né CF_ENABLETEMPLATE , questo membro viene ignorato.

lpszStyle

Tipo: LPTSTR

Dati di stile. Se viene specificato il flag CF_USESTYLE , ChooseFont usa i dati in questo buffer per inizializzare la casella combinata Stile carattere . Quando l'utente chiude la finestra di dialogo, ScegliFont copia la stringa nella casella combinata Stile carattere in questo buffer.

nFontType

Tipo: WORD

Tipo del tipo di carattere selezionato quando ChooseFont restituisce. Questo membro può essere uno o più dei valori seguenti.

___MISSING_ALIGNMENT__

nSizeMin

Tipo: INT

La dimensione minima selezionabile da un utente, espressa in punti. ChooseFont riconosce questo membro solo se viene specificato il flag CF_LIMITSIZE .

nSizeMax

Tipo: INT

La dimensione massima selezionabile da un utente, espressa in punti. ChooseFont riconosce questo membro solo se viene specificato il flag CF_LIMITSIZE .

Commenti

Requisiti

Vedi anche

ScegliFont

Libreria delle finestre di dialogo comuni

Informazioni concettuali

MAKEINTRESOURCE

Riferimento