Condividi tramite


Funzione CreateFontA (wingdi.h)

La funzione CreateFont crea un carattere logico con le caratteristiche specificate. Il tipo di carattere logico può essere selezionato successivamente come tipo di carattere per qualsiasi dispositivo.

Sintassi

HFONT CreateFontA(
  [in] int    cHeight,
  [in] int    cWidth,
  [in] int    cEscapement,
  [in] int    cOrientation,
  [in] int    cWeight,
  [in] DWORD  bItalic,
  [in] DWORD  bUnderline,
  [in] DWORD  bStrikeOut,
  [in] DWORD  iCharSet,
  [in] DWORD  iOutPrecision,
  [in] DWORD  iClipPrecision,
  [in] DWORD  iQuality,
  [in] DWORD  iPitchAndFamily,
  [in] LPCSTR pszFaceName
);

Parametri

[in] cHeight

Altezza, in unità logiche, della cella o del carattere del carattere del tipo di carattere. Il valore dell'altezza del carattere (noto anche come altezza em) è il valore di altezza della cella di caratteri meno il valore interno-iniziale. Il mapper del tipo di carattere interpreta il valore specificato in nHeight nel modo seguente.

Valore Significato
> 0
Il mapper del tipo di carattere trasforma questo valore in unità dispositivo e lo corrisponde all'altezza della cella dei tipi di carattere disponibili.
0
Il mapper del tipo di carattere usa un valore di altezza predefinito quando cerca una corrispondenza.
< 0
Il mapper del tipo di carattere trasforma questo valore in unità dispositivo e corrisponde al valore assoluto rispetto all'altezza dei caratteri disponibili.
 

Per tutti i confronti di altezza, il mapper del carattere cerca il tipo di carattere più grande che non supera le dimensioni richieste.

Questo mapping si verifica quando il tipo di carattere viene usato per la prima volta.

Per la modalità di mapping MM_TEXT, è possibile usare la formula seguente per specificare un'altezza per un tipo di carattere con dimensioni del punto specificate:


nHeight = -MulDiv(PointSize, GetDeviceCaps(hDC, LOGPIXELSY), 72);

[in] cWidth

Larghezza media, in unità logiche, di caratteri nel tipo di carattere richiesto. Se questo valore è zero, il mapper del tipo di carattere sceglie un valore di corrispondenza più vicino. Il valore di corrispondenza più vicino è determinato confrontando i valori assoluti della differenza tra le proporzioni del dispositivo corrente e le proporzioni digitalizzate dei tipi di carattere disponibili.

[in] cEscapement

Angolo, in decimi di gradi, tra il vettore di escape e l'asse x del dispositivo. Il vettore di escape è parallelo alla riga di base di una riga di testo.

Quando la modalità grafica è impostata su GM_ADVANCED, è possibile specificare l'angolo di escape della stringa indipendentemente dall'angolo di orientamento dei caratteri della stringa.

Quando la modalità grafica è impostata su GM_COMPATIBLE, nEscapement specifica sia l'escape che l'orientamento. È necessario impostare nEscapement e nOrientation sullo stesso valore.

[in] cOrientation

L'angolo, in decimi di gradi, tra la linea di base di ogni carattere e l'asse x del dispositivo.

[in] cWeight

Peso del carattere nell'intervallo da 0 a 1000. Ad esempio, 400 è normale e 700 è grassetto. Se questo valore è zero, viene usato un peso predefinito.

I valori seguenti sono definiti per praticità.

Peso Valore
FW_DONTCARE
0
FW_THIN
100
FW_EXTRALIGHT
200
FW_ULTRALIGHT
200
FW_LIGHT
300
FW_NORMAL
400
FW_REGULAR
400
FW_MEDIUM
500
FW_SEMIBOLD
600
FW_DEMIBOLD
600
FW_BOLD
700
FW_EXTRABOLD
800
FW_ULTRABOLD
800
FW_HEAVY
900
FW_BLACK
900

[in] bItalic

Specifica un carattere corsivo se impostato su TRUE.

[in] bUnderline

Specifica un carattere sottolineato se impostato su TRUE.

[in] bStrikeOut

Tipo di carattere di strikeout se impostato su TRUE.

[in] iCharSet

Set di caratteri. I valori seguenti sono predefiniti:

  • ANSI_CHARSET
  • BALTIC_CHARSET
  • CHINESEBIG5_CHARSET
  • DEFAULT_CHARSET
  • EASTEUROPE_CHARSET
  • GB2312_CHARSET
  • GREEK_CHARSET
  • HANGUL_CHARSET
  • MAC_CHARSET
  • OEM_CHARSET
  • RUSSIAN_CHARSET
  • SHIFTJIS_CHARSET
  • SYMBOL_CHARSET
  • TURKISH_CHARSET
  • VIETNAMESE_CHARSET
Edizione della lingua coreana di Windows:
  • JOHAB_CHARSET
Edizione del linguaggio Middle East di Windows:
  • ARABIC_CHARSET
  • HEBREW_CHARSET
Edizione della lingua thai di Windows:
  • THAI_CHARSET
Il valore OEM_CHARSET specifica un set di caratteri dipendente dal sistema operativo.

DEFAULT_CHARSET è impostato su un valore basato sulle impostazioni locali del sistema corrente. Ad esempio, quando le impostazioni locali di sistema sono inglese (Stati Uniti), viene impostata come ANSI_CHARSET.

I tipi di carattere con altri set di caratteri possono esistere nel sistema operativo. Se un'applicazione usa un tipo di carattere con un set di caratteri sconosciuto, non deve tentare di tradurre o interpretare stringhe di cui viene eseguito il rendering con tale tipo di carattere.

Per garantire risultati coerenti durante la creazione di un tipo di carattere, non specificare OEM_CHARSET o DEFAULT_CHARSET. Se si specifica un nome di tipoface nel parametro lpszFace , assicurarsi che il valore fdwCharSet corrisponda al set di caratteri del carattere specificato in lpszFace.

[in] iOutPrecision

Precisione dell'output. La precisione di output definisce il modo in cui l'output deve corrispondere all'altezza, alla larghezza, all'orientamento del carattere, all'orientamento del carattere, all'escape, al passo e al tipo di carattere richiesto. Può essere uno dei valori seguenti.

Valore Significato
OUT_CHARACTER_PRECIS
Non usato.
OUT_DEFAULT_PRECIS
Comportamento del mapper del tipo di carattere predefinito.
OUT_DEVICE_PRECIS
Indica al mapper del tipo di carattere di scegliere un tipo di carattere Dispositivo quando il sistema contiene più tipi di carattere con lo stesso nome.
OUT_OUTLINE_PRECIS
Questo valore indica al mapper di carattere di scegliere tra TrueType e altri tipi di carattere basati su struttura.
OUT_PS_ONLY_PRECIS
Indica al mapper di carattere di scegliere solo tipi di carattere PostScript. Se nel sistema non sono installati tipi di carattere PostScript, il mapper del tipo di carattere restituisce il comportamento predefinito.
OUT_RASTER_PRECIS
Indica al mapper di carattere di scegliere un tipo di carattere raster quando il sistema contiene più tipi di carattere con lo stesso nome.
OUT_STRING_PRECIS
Questo valore non viene usato dal mapper del tipo di carattere, ma viene restituito quando vengono enumerati i tipi di carattere raster.
OUT_STROKE_PRECIS
Questo valore non viene usato dal mapper del tipo di carattere, ma viene restituito quando TrueType, altri tipi di carattere basati su struttura e i tipi di carattere vettoriale vengono enumerati.
OUT_TT_ONLY_PRECIS
Indica al mapper di carattere di scegliere solo tipi di carattere TrueType. Se nel sistema non sono installati tipi di carattere TrueType, il mapper del tipo di carattere restituisce il comportamento predefinito.
OUT_TT_PRECIS
Indica al mapper del tipo di carattere di scegliere un tipo di carattere TrueType quando il sistema contiene più tipi di carattere con lo stesso nome.
 

Le applicazioni possono usare i valori OUT_DEVICE_PRECIS, OUT_RASTER_PRECIS, OUT_TT_PRECIS e OUT_PS_ONLY_PRECIS per controllare il modo in cui il mapper del tipo di carattere sceglie un tipo di carattere quando il sistema operativo contiene più tipi di carattere con un nome specificato. Ad esempio, se un sistema operativo contiene un tipo di carattere denominato Symbol nel modulo raster e TrueType, specificando OUT_TT_PRECIS forza il mapper del tipo di carattere per scegliere la versione TrueType. Specificando OUT_TT_ONLY_PRECIS forza il mapper del tipo di carattere a scegliere un tipo di carattere TrueType, anche se deve sostituire un carattere TrueType di un altro nome.

[in] iClipPrecision

Precisione di ritaglio. La precisione di ritaglio definisce come ritagliare i caratteri parzialmente esterni all'area di ritaglio. Può essere uno o più dei valori seguenti.

Valore Significato
CLIP_CHARACTER_PRECIS
Non usato.
CLIP_DEFAULT_PRECIS
Specifica il comportamento predefinito di ritaglio.
CLIP_DFA_DISABLE
Windows XP SP1: disattiva l'associazione dei tipi di carattere per il tipo di carattere. Si noti che questo flag non è garantito avere alcun effetto su qualsiasi piattaforma dopo Windows Server 2003.
CLIP_EMBEDDED
È necessario specificare questo flag per usare un tipo di carattere di sola lettura incorporato.
CLIP_LH_ANGLES
Quando viene usato questo valore, la rotazione per tutti i tipi di carattere dipende dal fatto che l'orientamento del sistema di coordinate sia sinistro o destro.

Se non viene usato, i tipi di carattere del dispositivo ruotano sempre in senso antiorario, ma la rotazione di altri tipi di carattere dipende dall'orientamento del sistema di coordinate.

Per altre informazioni sull'orientamento dei sistemi di coordinate, vedere la descrizione del parametro nOrientation

CLIP_MASK
Non usato.
CLIP_DFA_OVERRIDE
Disattiva l'associazione dei tipi di carattere per il tipo di carattere. Questo è identico a CLIP_DFA_DISABLE, ma può avere problemi in alcune situazioni; il flag consigliato da usare è CLIP_DFA_DISABLE.
CLIP_STROKE_PRECIS
Non usato dal mapper del tipo di carattere, ma viene restituito quando vengono enumerati i tipi di carattere raster, vector o TrueType.

Per la compatibilità, questo valore viene sempre restituito durante l'enumerazione dei tipi di carattere.

CLIP_TT_ALWAYS
Non usato.

[in] iQuality

Qualità dell'output. La qualità dell'output definisce il modo in cui GDI deve tentare di trovare la corrispondenza tra gli attributi del tipo di carattere logico a quelli di un carattere fisico effettivo. Può essere uno dei valori seguenti.

Valore Significato
ANTIALIASED_QUALITY
Il carattere è antialiased o lisciato, se il tipo di carattere lo supporta e le dimensioni del carattere non sono troppo piccole o troppo grandi.
CLEARTYPE_QUALITY
Se impostato, il testo viene eseguito (quando possibile) usando il metodo antialiasing ClearType. Per ulteriori informazioni, vedere la sezione Osservazioni.
DEFAULT_QUALITY
L'aspetto del tipo di carattere non è importante.
DRAFT_QUALITY
L'aspetto del tipo di carattere è meno importante di quando viene usato il valore PROOF_QUALITY. Per i tipi di carattere raster GDI, la scalabilità è abilitata, il che significa che sono disponibili più dimensioni dei tipi di carattere, ma la qualità potrebbe essere inferiore. I tipi di carattere grassetto, corsivo, sottolineatura e strikeout vengono sintetizzati, se necessario.
NONANTIALIASED_QUALITY
Il tipo di carattere non è mai antialiased, ovvero non viene eseguito lo smoothing del tipo di carattere.
PROOF_QUALITY
La qualità dei caratteri del tipo di carattere è più importante rispetto alla corrispondenza esatta degli attributi del tipo di carattere logico. Per i tipi di carattere raster GDI, il ridimensionamento è disabilitato e viene scelto il tipo di carattere più vicino alle dimensioni. Anche se la dimensione del carattere scelta potrebbe non essere mappata esattamente quando viene usata PROOF_QUALITY, la qualità del tipo di carattere è elevata e non esiste alcuna distorsione dell'aspetto. I tipi di carattere grassetto, corsivo, sottolineatura e strikeout vengono sintetizzati, se necessario.
 

Se la qualità dell'output è DEFAULT_QUALITY, DRAFT_QUALITY o PROOF_QUALITY, il tipo di carattere viene antialiasato se il parametro di sistema SPI_GETFONTSMOOTHING è TRUE. Gli utenti possono controllare questo parametro di sistema dalla Pannello di controllo. (La parola precisa dell'impostazione nel pannello di controllo dipende dalla versione di Windows, ma sarà parole per l'effetto di "Bordi uniforme dei tipi di carattere dello schermo".

[in] iPitchAndFamily

Il campo e la famiglia del tipo di carattere. I due bit a basso ordine specificano il passo del tipo di carattere e possono essere uno dei valori seguenti:

  • DEFAULT_PITCH
  • FIXED_PITCH
  • VARIABLE_PITCH
I quattro bit di ordine elevato specificano la famiglia di caratteri e possono essere uno dei valori seguenti.
Valore Significato
FF_DECORATIVE
Tipi di carattere novità. Un esempio è Old English.
FF_DONTCARE
Usare il tipo di carattere predefinito.
FF_MODERN
Tipi di carattere con larghezza del tratto costante, con o senza serifs. Pica, Elite e Courier New sono esempi.
FF_ROMAN
Tipi di carattere con larghezza del tratto variabile e con serifs. Un esempio è MS Serif.
FF_SCRIPT
Tipi di carattere progettati per essere simili alla grafia. Esempi sono Script e Cursive.
FF_SWISS
Tipi di carattere con larghezza del tratto variabile e senza serifs. SIGNORA? Sans Serif è un esempio.
 

Un'applicazione può specificare un valore per il parametro fdwPitchAndFamily usando l'operatore OR booleano per aggiungere una costante di passo con una costante della famiglia.

Le famiglie di caratteri descrivono l'aspetto di un carattere in modo generale. Sono destinati a specificare i tipi di carattere quando non è disponibile il carattere di tipo esatto richiesto.

[in] pszFaceName

Puntatore a una stringa con terminazione null che specifica il nome del carattere di tipo. La lunghezza di questa stringa non deve superare i 32 caratteri, incluso il carattere null terminante. La funzione EnumFontFamilies può essere usata per enumerare i nomi di carattere tipizzato di tutti i tipi di carattere attualmente disponibili. Per ulteriori informazioni, vedere la sezione Osservazioni.

Se lpszFace è NULL o stringa vuota, GDI usa il primo tipo di carattere corrispondente agli altri attributi specificati.

Valore restituito

Se la funzione ha esito positivo, il valore restituito è un handle per un tipo di carattere logico.

Se la funzione ha esito negativo, il valore restituito è NULL.

Commenti

Quando non è più necessario il tipo di carattere, chiamare la funzione DeleteObject per eliminarla.

Per proteggere i copyright dei fornitori che forniscono tipi di carattere per Windows, le applicazioni devono sempre segnalare il nome esatto di un tipo di carattere selezionato. Poiché i tipi di carattere disponibili possono variare dal sistema al sistema, non si supponga che il tipo di carattere selezionato sia sempre uguale al tipo di carattere richiesto. Ad esempio, se si richiede un carattere denominato Palatino, ma non è disponibile alcun tipo di carattere nel sistema, il mapper del carattere sostituirà un carattere con attributi simili ma un nome diverso. Segnala sempre il nome del tipo di carattere selezionato all'utente.

Per ottenere il tipo di carattere appropriato in versioni diverse del sistema operativo, chiamare EnumFontFamiliesEx con le caratteristiche del carattere desiderate nella struttura LOGFONT, quindi recuperare il nome di carattere appropriato e creare il tipo di carattere usando CreateFont o CreateFontIndirect.

Il mapper del tipo di carattere per CreateFont, CreateFontIndirect e CreateFontIndirectEx riconosce sia l'inglese che il nome di carattere localizzato, indipendentemente dalle impostazioni locali.

Le situazioni seguenti non supportano l'antialiasing ClearType:

  • Testo sottoposto a rendering in una stampante.
  • Un set di visualizzazione per 256 colori o meno.
  • Testo sottoposto a rendering in un client del server terminale.
  • Il carattere non è un carattere TrueType o un tipo di carattere OpenType con contorni TrueType. Ad esempio, le seguenti non supportano l'antialiasing ClearType: tipi di carattere 1, tipi di carattere OpenType postscript senza contorni TrueType, tipi di carattere bitmap, tipi di carattere vettoriale e tipi di carattere del dispositivo.
  • Il tipo di carattere ha ottimizzato le bitmap incorporate, solo per le dimensioni del carattere che contengono le bitmap incorporate. Ad esempio, questo si verifica comunemente nei tipi di carattere asiatici orientali.

Esempio

LRESULT CALLBACK WndProc(HWND hWnd, UINT message, WPARAM wParam, LPARAM lParam)
{
    int wmId, wmEvent;
    PAINTSTRUCT ps;
    HDC hdc;
    switch (message)
    {
    
    
    case WM_PAINT:
        {
        RECT rect;
        HFONT hFontOriginal, hFont1, hFont2, hFont3;
        hdc = BeginPaint(hWnd, &ps);

            
            //Logical units are device dependent pixels, so this will create a handle to a logical font that is 48 pixels in height.
            //The width, when set to 0, will cause the font mapper to choose the closest matching value.
            //The font face name will be Impact.
            hFont1 = CreateFont(48,0,0,0,FW_DONTCARE,FALSE,TRUE,FALSE,DEFAULT_CHARSET,OUT_OUTLINE_PRECIS,
                CLIP_DEFAULT_PRECIS,CLEARTYPE_QUALITY, VARIABLE_PITCH,TEXT("Impact"));
            hFontOriginal = (HFONT)SelectObject(hdc, hFont1);
            
            //Sets the coordinates for the rectangle in which the text is to be formatted.
            SetRect(&rect, 100,100,700,200);
            SetTextColor(hdc, RGB(255,0,0));
            DrawText(hdc, TEXT("Drawing Text with Impact"), -1,&rect, DT_NOCLIP);
            
            //Logical units are device dependent pixels, so this will create a handle to a logical font that is 36 pixels in height.
            //The width, when set to 20, will cause the font mapper to choose a font which, in this case, is stretched.
            //The font face name will be Times New Roman.  This time nEscapement is at -300 tenths of a degree (-30 degrees)
            hFont2 = CreateFont(36,20,-300,0,FW_DONTCARE,FALSE,TRUE,FALSE,DEFAULT_CHARSET,OUT_OUTLINE_PRECIS,
                CLIP_DEFAULT_PRECIS,CLEARTYPE_QUALITY, VARIABLE_PITCH,TEXT("Times New Roman"));
            SelectObject(hdc,hFont2);
            
            //Sets the coordinates for the rectangle in which the text is to be formatted.
            SetRect(&rect, 100, 200, 900, 800);
            SetTextColor(hdc, RGB(0,128,0));
            DrawText(hdc, TEXT("Drawing Text with Times New Roman"), -1,&rect, DT_NOCLIP);
                
            //Logical units are device dependent pixels, so this will create a handle to a logical font that is 36 pixels in height.
            //The width, when set to 10, will cause the font mapper to choose a font which, in this case, is compressed. 
            //The font face name will be Arial. This time nEscapement is at 250 tenths of a degree (25 degrees)
            hFont3 = CreateFont(36,10,250,0,FW_DONTCARE,FALSE,TRUE,FALSE,DEFAULT_CHARSET,OUT_OUTLINE_PRECIS,
                CLIP_DEFAULT_PRECIS,ANTIALIASED_QUALITY, VARIABLE_PITCH,TEXT("Arial"));
            SelectObject(hdc,hFont3);

            //Sets the coordinates for the rectangle in which the text is to be formatted.
            SetRect(&rect, 500, 200, 1400, 600);
            SetTextColor(hdc, RGB(0,0,255));
            DrawText(hdc, TEXT("Drawing Text with Arial"), -1,&rect, DT_NOCLIP);

            SelectObject(hdc,hFontOriginal);
            DeleteObject(hFont1);
            DeleteObject(hFont2);
            DeleteObject(hFont3);
        
        EndPaint(hWnd, &ps);
        break;
        }
    case WM_DESTROY:
        PostQuitMessage(0);
        break;
    default:
        return DefWindowProc(hWnd, message, wParam, lParam);
    }
    return 0;
}

Per un altro esempio, vedere "Impostazione dei tipi di carattere per le stringhe di testo Menu-Item" in Uso dei menu.

Nota

L'intestazione wingdi.h definisce CreateFont come alias che seleziona automaticamente la versione ANSI o Unicode di questa funzione in base alla definizione della costante del preprocessore UNICODE. La combinazione dell'utilizzo dell'alias di codifica neutrale con il codice che non è neutrale dalla codifica può causare errori di corrispondenza che causano errori di compilazione o runtime. Per altre informazioni, vedere Convenzioni per i prototipi di funzione.

Requisiti

Requisito Valore
Client minimo supportato Windows 2000 Professional [solo app desktop]
Server minimo supportato Windows 2000 Server [solo app desktop]
Piattaforma di destinazione Windows
Intestazione wingdi.h (include Windows.h)
Libreria Gdi32.lib
DLL Gdi32.dll

Vedi anche

CreateFontIndirect

CreateFontIndirectEx

DeleteObject

EnumFontFamilies

EnumFontFamiliesEx

EnumFonts

Funzioni carattere e testo

Panoramica dei tipi di carattere e del testo

LOGFONT

SelectObject