CHOOSEFONT

Structura CHOOSEFONT conține informații care utilizează funcția ChooseFont pentru a inițializa din caseta de dialog comun de Font . După ce utilizatorul se închide caseta de dialog, sistemul întoarce informații despre selecția utilizatorului în această structură.

typedef struct {/ / cf DWORD lStructSize; 
    HWND hwndOwner; 
    HDC hDC; 
    LPLOGFONT lpLogFont; 
    INT iPointSize; 
    DWORD Steaguri; 
    DWORD rgbColors; 
    LPARAM lCustData; 
    LPCFHOOKPROC lpfnHook; 
    LPCTSTR lpTemplateName; 
    HINSTANCE hInstance; 
    LPTSTR lpszStyle; 
    WORD nFontType; 
    WORD ___MISSING_ALIGNMENT__; 
    INT nSizeMin; 
    INT nSizeMax; 
} CHOOSEFONT 

 

Membrii

lStructSize
Specifică lungimea, în octeți, structurii.
hwndOwner
Identifică fereastra care deține caseta de dialog. Acest membru poate fi orice fereastră valabil mâner, sau poate fi nul în cazul în care caseta de dialog a nu proprietar.
hDC
Identifică context de dispozitiv (sau informații context) a imprimantei ale căror fonturi va fi listat în caseta de dialog. Acest membru este utilizat numai în cazul în care membrul steaguri specifică pavilion CF_PRINTERFONTS sau CF_BOTH; în caz contrar, este ignorat acest membru.
lpLogFont
Indicatorul pentru a o LOGFONT structura. Dacă setați pavilion CF_INITTOLOGFONTSTRUCT membru steaguri și inițializa membrii LOGFONT , funcția ChooseFont inițializează caseta de dialog cu un font care este cel mai apropiat posibil meci. În cazul în care utilizatorul face clic pe butonul OK , ChooseFont stabilește membrii structura LOGFONT bazate pe selecții utilizatorului.
iPointSize
Specifică dimensiunea fontului selectat, în unită?i de 1/10 din punct. Funcția ChooseFont setează această valoare după ce utilizatorul se închide caseta de dialog.
Steaguri
Un set de steaguri de biți care le puteți utiliza pentru a inițializa din caseta de dialog comun de Font . Când se întoarce în caseta de dialog, se setează aceste semnalizări pentru a indica utilizatorului intrare. Acest membru pot fi o combinatie dintre steagurile de următoarele:
Drapelul Sensul
CF_APPLY Cauzele caseta de dialog pentru a afișa butonul Apply. Tu ar trebui să prevadă o procedură de cârlig la procesul WM_COMMAND mesaje pentru butonul aplicare. Procedura cârlig poate trimite mesajul WM_CHOOSEFONT_GETLOGFONT caseta de dialog pentru a prelua adresa LOGFONT structura care conține selecțiile curente pentru font.
CF_ANSIONLY Acest flag este învechit. Pentru a limita selecțiile de font la toate script-urile, cu excep?ia celor care utilizează seturi de caractere OEM sau simbol, utilizați CF_SCRIPTSONLY. Pentru a obține comportamentul Windows 3.1 CF_ANSIONLY, utilizați CF_SELECTSCRIPT și specificați EASTEUROPE_CHARSET membru lfCharSet structurii LOGFONT a subliniat de lpLogFont.
CF_BOTH Cauzele caseta de dialog pentru a lista fonturilor disponibile de imprimantă și ecran. Membre hDC identifică dispozitivul context (sau informații context) asociate cu imprimanta. Acest flag este o combinație dintre steagurile de CF_SCREENFONTS și CF_PRINTERFONTS.
CF_TTONLY Specifică că ChooseFont numai ar trebui să enumere și permite selectarea fonturi TrueType.
CF_EFFECTS Cauzele caseta de dialog pentru a afișa comenzile care permite utilizatorului să specifice Ștergere, subliniere și opțiuni de culoare text. Dacă acest flag este setat, utilizați membru rgbColors pentru a specifica culoarea textului inițial. Aveți posibilitatea să utilizați membrii lfStrikeOut și lfUnderline LOGFONT structura a subliniat de lpLogFont pentru a specifica setările inițiale din casetele text-tăiat și subliniere. ChooseFont utilizați acești membri să se întoarcă utilizatorului selecții.
CF_ENABLEHOOK Permite cârlig procedura specificată în lpfnHook membre de această structură.
CF_ENABLETEMPLATE Indică faptul că membrii hInstance și lpTemplateName specificat un șablon de caseta de dialog pentru a utiliza în loc de șablonul implicit.
CF_ENABLETEMPLATEHANDLE Indică faptul că hInstance membre identifică un bloc de date care conține un șablon de caseta de preloaded dialog. Sistemul ignoră membru lpTemplateName dacă acest flag este specificat.
CF_FIXEDPITCHONLY Specifică că ChooseFont ar trebui să selectați numai fixat-pitch fonturi.
CF_FORCEFONTEXIST Specifică că ChooseFont ar trebui să indice o condi?ie de eroare dacă utilizatorul încearcă să selectați un font sau stil care nu există.
CF_INITTOLOGFONTSTRUCT Specifică că ar trebui să utilizeze ChooseFont LOGFONT structura a subliniat de membru lpLogFont să inițializeze controalele casetă de dialog.
CF_LIMITSIZE Specifică că ChooseFont ar trebui să selectați numai dimensiunile fonturilor în domeniul specificat de membrii nSizeMin și nSizeMax.
CF_NOOEMFONTS Fel ca pavilionul CF_NOVECTORFONTS.
CF_NOFACESEL Atunci când se utilizează o structură LOGFONT să inițializeze controalele casetă de dialog, utilizați acest flag pentru a preveni selectiv caseta de dialog să afișeze o selecție inițial pentru caseta combo nume font. Acest lucru este util atunci când nu există nici un nume de font unic, care se aplică pentru selecție text.
CF_NOSCRIPTSEL Dezactivează caseta combo script-ul . Atunci când acest flag este setat, membru lfCharSet LOGFONT structura este setat la DEFAULT_CHARSET atunci ChooseFont întoarce. Acest flag este utilizat numai pentru a inițializa caseta de dialog.
CF_NOSTYLESEL Atunci când se utilizează o structură LOGFONT să inițializeze controalele casetă de dialog, utilizați acest flag pentru a preveni selectiv caseta de dialog să afișeze o selecție inițial pentru caseta combo Stil font. Acest lucru este util atunci când nu există nici un stil de font unic care se aplică pentru selecție text.
CF_NOSIZESEL Atunci când se utilizează o LOGFONT structura pentru a inițializa controalele casetă de dialog, utilizați acest flag pentru a preveni selectiv caseta de dialog să afișeze o selecție inițial pentru caseta combo de dimensiune font. Acest lucru este util atunci când nu există nici o dimensiune de font unic care se aplică pentru selecție text.
CF_NOSIMULATIONS Specifică că ChooseFont ar trebui să nu permite graphics device interface (GDI) font simulări.
CF_NOVECTORFONTS Specifică că ChooseFont ar trebui să nu permite vector font selecții.
CF_NOVERTFONTS Cauzele caseta de dialog Font pentru a lista numai fonturi orientate orizontal.
CF_PRINTERFONTS Cauzele caseta de dialog listă numai fonturi acceptate de imprimantă asociate cu context de dispozitiv (sau informații context) identificate de membru hDC.
CF_SCALABLEONLY Specifică că ChooseFont ar trebui să permită numai selecția de fonturi scalabil. (Fonturile scalabilă include fonturi vector, fonturile imprimantei scalabile, fonturi TrueType, și fonturile către alte tehnologii.)
CF_SCREENFONTS Caseta de dialog pentru a lista numai fonturile de ecran acceptate de sistemul de cauze.
CF_SCRIPTSONLY Specifică că ChooseFont ar trebui să permită selecție de fonturi pentru toate non-OEM și simbol caracter seturi, precum și setul de caractere ANSI. Aceasta înlocuiește valoarea CF_ANSIONLY.
CF_SELECTSCRIPT Când specificat la intrare, numai fonturi cu setul de caractere identificate în membru lfCharSet LOGFONT structura sunt afișate. Utilizatorul nu sunt permise pentru a schimba setul specificat în caseta combo script-uri de caractere.
CF_SHOWHELP Cauzele caseta de dialog pentru a afișa butonul Ajutor . Membru hwndOwner trebuie să specificați fereastra pentru a primi HELPMSGSTRING înregistrat mesaje care caseta de dialog trimite atunci când utilizatorul face clic pe butonul Ajutor.
CF_USESTYLE Specifică că punctele de membru lpszStyle o tampon care conține date de stil care ChooseFont ar trebui să utilizeze pentru a inițializa caseta combostil Font. Atunci când utilizatorul se închide caseta de dialog, ChooseFont copii stil date pentru selecție a utilizatorului la acest tampon .
CF_WYSIWYG Specifică că ChooseFont ar trebui să permită numai selecția de fonturi disponibile pe imprimanta și ecranul. Dacă acest flag este specificat, steagurile CF_BOTH și CF_SCALABLEONLY ar trebui să fie de asemenea precizate.

rgbColors
Dacă pavilion CF_EFFECTS este setat, rgbColors specifică culoarea textului inițial. Atunci când ChooseFont returnează succes, acest membru conține valoarea RGB Culoare text utilizatorului selectat.
lCustData
Specifică date definite de aplicarea că sistemul trece la procedura cârlig identificate de către lpfnHook . Atunci când sistemul trimite mesajul WM_INITDIALOG procedura cârlig, mesajul lui lParam parametru este un indicator de structura CHOOSEFONT specificat când dialogul a fost creat. Procedura cârlig poate utiliza acest indicator pentru a obține valoarea lCustData.
lpfnHook
Indicatorul pentru a o CFHookProc cârlig procedura care poate procesa mesaje destinate pentru caseta de dialog. Acest membru este ignorată dacă pavilion CF_ENABLEHOOK este setat în membre steaguri.
lpTemplateName
Indicatorul un șir null-terminated care nume de caseta de dialog șablon resursa în modulul identificate de către hInstance . Acest șablon este înlocuit pentru șablonul de caseta de standard dialog. Pentru resurse caseta de dialog numerotare, lpTemplateName poate fi o valoare returnată de macrocomanda MAKEINTRESOURCE . Acest membru este ignorată dacă pavilion CF_ENABLETEMPLATE este setat în membre steaguri.
hInstance
Dacă pavilion CF_ENABLETEMPLATEHANDLE este stabilit în membre steaguri , hInstance este ghidajul de un obiect de memorie care con?in un șablon de caseta de dialog. Dacă pavilion CF_ENABLETEMPLATE este setat, hInstance identifică un modul care conține un șablon de caseta de dialog numit de statul membru de lpTemplateName . Dacă este setat nici CF_ENABLETEMPLATEHANDLE, nici CF_ENABLETEMPLATE, acest membru este ignorat.
lpszStyle
Indicatorul pentru a o tampon care conține date de stil. Dacă este specificat de pavilion CF_USESTYLE, ChooseFont utilizează datele în acest tampon pentru a inițializa caseta combo Stil font. Atunci când utilizatorul se închide caseta de dialog, ChooseFont copiază șirul din caseta combo de stil font în acest tampon.
nFontType
Specifică tipul de fontul selectat atunci când ChooseFont întoarce. Acest membru pot fi o combinatie de următoarele valori:
Valoarea Sensul
BOLD_FONTTYPE Greutatea font este aldin. Această informație este duplicat în membru lfWeight LOGFONT structura și este echivalentă cu FW_BOLD.
ITALIC_FONTTYPE Este setat atributul font cursiv. Această informație este duplicat membru lfItalic din structura LOGFONT.
PRINTER_FONTTYPE Fontul este un font de imprimantă.
REGULAR_FONTTYPE Greutatea font este normal. Această informație este duplicat membru lfWeight din structura LOGFONT și este echivalentă cu FW_REGULAR.
SCREEN_FONTTYPE Fontului este un font pentru ecran.
SIMULATED_FONTTYPE Fontului este simulate de interfața grafică dispozitiv (GDI).

nSizeMin
Specifică dimensiunea punct minim poate selecta un utilizator. ChooseFont recunoaște acest membru numai dacă este specificat pavilion CF_LIMITSIZE.
nSizeMax
Specifică dimensiunea maximă punct poate selecta un utilizator. ChooseFont recunoaște acest membru numai dacă este specificat pavilion CF_LIMITSIZE.

QuickInfo

nbsp; Windows &NT: necesită versiunea 3.1 sau mai târziu.
Windows:Necesită Windows 95 sau o versiune ulterioară.
Windows CE:Neacceptat.
Antet:A declarat în commdlg.h.
Unicode:Definit ca structurile Unicode și ANSI.

A se vedea, de asemenea

Comune Dialog casetă de prezentare biblioteca, structuri comune de caseta de Dialog, ChooseFont, LOGFONT, MAKEINTRESOURCE

Index