Metodo IDWriteFactory::CreateGdiCompatibleTextLayout (dwrite.h)

Accetta una stringa, un formato e vincoli associati e produce un oggetto che rappresenta il risultato, formattato per una particolare risoluzione di visualizzazione e modalità di misurazione.

Sintassi

HRESULT CreateGdiCompatibleTextLayout(
  [in]           WCHAR const         *string,
                 UINT32              stringLength,
                 IDWriteTextFormat   *textFormat,
                 FLOAT               layoutWidth,
                 FLOAT               layoutHeight,
                 FLOAT               pixelsPerDip,
  [in, optional] DWRITE_MATRIX const *transform,
                 BOOL                useGdiNatural,
  [out]          IDWriteTextLayout   **textLayout
);

Parametri

[in] string

Tipo: const WCHAR*

Matrice di caratteri che contiene la stringa da cui creare un nuovo oggetto IDWriteTextLayout . Questa matrice deve essere di lunghezza stringLength e può contenere caratteri NULL incorporati.

stringLength

Tipo: UINT32

Lunghezza della stringa, nel conteggio dei caratteri.

textFormat

Tipo: IDWriteTextFormat*

Oggetto di formattazione del testo da applicare alla stringa.

layoutWidth

Tipo: FLOAT

Larghezza della casella di layout.

layoutHeight

Tipo: FLOAT

Altezza della casella di layout.

pixelsPerDip

Tipo: FLOAT

Numero di pixel fisici per DIP (device independent pixel). Ad esempio, se il rendering in un dispositivo dpi 96 pixelPerDip è 1. Se il rendering in un dispositivo dpi 120 pixelPerDip è 1,25 (120/96).

[in, optional] transform

Tipo: const DWRITE_MATRIX*

Trasformazione facoltativa applicata ai glifi e alle relative posizioni. Questa trasformazione viene applicata dopo il ridimensionamento specifica le dimensioni e i pixel del carattere per DIP.

useGdiNatural

Tipo: BOOL

Indica al layout di testo di usare le stesse metriche del testo a livello di bilivello GDI se impostato su FALSE. Se impostato su TRUE, indica al layout di testo di usare le stesse metriche del testo misurate da GDI usando un tipo di carattere creato con CLEARTYPE_NATURAL_QUALITY.

[out] textLayout

Tipo: IDWriteTextLayout**

Quando termina, questo metodo contiene un indirizzo al puntatore dell'oggetto layout di testo risultante.

Valore restituito

Tipo: HRESULT

Se questo metodo ha esito positivo, restituisce S_OK. In caso contrario, restituisce un codice di errore HRESULT .

Commenti

Il layout di testo risultante deve essere usato solo per la risoluzione desiderata e per i casi in cui è preferibile usare CreateTextLayout per la scalabilità del testo.

Requisiti

Vedi anche

IDWriteFactory