Condividi tramite


CDC::GetGlyphOutline

Recupera la curva o la bitmap della struttura per un carattere della struttura nel carattere corrente.

DWORD GetGlyphOutline( 
   UINT nChar, 
   UINT nFormat, 
   LPGLYPHMETRICS lpgm, 
   DWORD cbBuffer, 
   LPVOID lpBuffer, 
   const MAT2* lpmat2 
) const;

Parametri

  • nChar
    Specifica le informazioni di carattere per il quale è di essere restituita.

  • nFormat
    Specifica il formato in cui la funzione viene restituire informazioni. Può essere uno dei seguenti valori, o 0:

    Valore

    Significato

    GGO_BITMAP

    Restituisce la bitmap di icona. Al completamento della funzione, il buffer puntato da lpBuffer contiene un 1 bit per pixel bitmap delle righe iniziano nei limiti di primi quattro byte.

    GGO_NATIVE

    Restituisce i punti dati della curva nel formato nativo di unità di rasterizzazione, utilizzando le unità. Quando questo valore viene specificato, qualsiasi trasformazione specificata in lpmat2 viene ignorata.

    Quando il valore nFormat è 0, la funzione inserisce una struttura GLYPHMETRICS ma non restituisce i dati di glifo- struttura.

  • lpgm
    Punta a una struttura GLYPHMETRICS che specifica la posizione del glifo nella cella del carattere.

  • cbBuffer
    Specifica la dimensione del buffer in cui la funzione copiare le informazioni sul carattere della struttura. Se questo valore è 0 e il parametro nFormat è valori GGO_NATIVE o GGO_BITMAP, la funzione restituisce la dimensione richiesta del buffer.

  • lpBuffer
    Punta a un buffer in cui la funzione copiare le informazioni sul carattere della struttura. Se nFormat specifica il valore GGO_NATIVE, le informazioni vengono copiate sotto forma di strutture TTPOLYCURVE e TTPOLYGONHEADER. Se questo valore è NULL e nFormat è il valore GGO_NATIVE o GGO_BITMAP, la funzione restituisce la dimensione richiesta del buffer.

  • lpmat2
    I punti su MAT2 struttura che contiene una matrice di trasformazione per il carattere. Questo parametro non può essere NULL, anche se il valore GGO_NATIVE è specificato per nFormat.

Valore restituito

Dimensione, in byte, del buffer richieste le informazioni recuperate se cbBuffer è 0 o lpBuffer è NULL. Altrimenti, è un valore positivo se la funzione ha esito positivo, o – 1 se è presente un errore.

Note

Un'applicazione può ruotare i caratteri recuperati in formato bitmap specificando una matrice di trasformazione 2 by-2 nella struttura indicata da lpmat2.

Una struttura di glifo viene restituita come serie di contorni. Ogni contorno è definito da una struttura TTPOLYGONHEADER seguita da tutte le strutture TTPOLYCURVE come sono necessari descriverla. Tutti i punti vengono restituiti come strutture POINTFX e rappresentano posizioni assolute, movimenti non su. Il punto iniziale fornito dal membro pfxStart della struttura TTPOLYGONHEADER è il punto in cui la struttura per un contorno avvia. Le strutture TTPOLYCURVE di seguito possono essere tutti i record della polilinea o scanalare i record. I record polilinea sono le serie di punti; le linee tracciate tra i punti descrivono la struttura del carattere. I record delle spline rappresentano le curve quadratiche utilizzate da TrueType ovvero b- spline quadratiche).

Requisiti

Header: afxwin.h

Vedere anche

Riferimenti

Classe CDC

Grafico delle gerarchie

CDC::GetOutlineTextMetrics

GetGlyphOutline

GLYPHMETRICS

TTPOLYGONHEADER

TTPOLYCURVE