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
Requisito | Valore |
---|---|
Client minimo supportato | Windows 7, Windows Vista con SP2 e Aggiornamento della piattaforma per Windows Vista [app desktop | App UWP] |
Server minimo supportato | Windows Server 2008 R2, Windows Server 2008 con SP2 e Platform Update per Windows Server 2008 [app desktop | App UWP] |
Piattaforma di destinazione | Windows |
Intestazione | dwrite.h |
Libreria | Dwrite.lib |
DLL | Dwrite.dll |