Método IDWriteFactory::CreateGdiCompatibleTextLayout (dwrite.h)
Usa uma cadeia de caracteres, formato e restrições associadas e produz um objeto que representa o resultado, formatado para uma resolução de exibição específica e modo de medição.
Sintaxe
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
);
Parâmetros
[in] string
Tipo: const WCHAR*
Uma matriz de caracteres que contém a cadeia de caracteres para criar um novo objeto IDWriteTextLayout . Essa matriz deve ser de stringLength de comprimento e pode conter caracteres NULL inseridos.
stringLength
Tipo: UINT32
O comprimento da cadeia de caracteres, na contagem de caracteres.
textFormat
Tipo: IDWriteTextFormat*
O objeto de formatação de texto a ser aplicado à cadeia de caracteres.
layoutWidth
Tipo: FLOAT
A largura da caixa de layout.
layoutHeight
Tipo: FLOAT
A altura da caixa de layout.
pixelsPerDip
Tipo: FLOAT
O número de pixels físicos por DIP (pixel independente do dispositivo). Por exemplo, se a renderização em um dispositivo de 96 DPI pixelsPerDip for 1. Se a renderização em um dispositivo de 120 DPI pixelsPerDip for 1.25 (120/96).
[in, optional] transform
Tipo: const DWRITE_MATRIX*
Uma transformação opcional aplicada aos glifos e suas posições. Essa transformação é aplicada depois que o dimensionamento especifica o tamanho da fonte e os pixels por DIP.
useGdiNatural
Tipo: BOOL
Instrui o layout de texto a usar as mesmas métricas que o texto de nível bi da GDI quando definido como FALSE. Quando definido como TRUE, instrui o layout de texto a usar as mesmas métricas que o texto medido pelo GDI usando uma fonte criada com CLEARTYPE_NATURAL_QUALITY.
[out] textLayout
Tipo: IDWriteTextLayout**
Quando esse método retorna, contém um endereço para o ponteiro do objeto de layout de texto resultante.
Retornar valor
Tipo: HRESULT
Se o método for bem-sucedido, ele retornará S_OK. Caso contrário, ele retornará um código de erro HRESULT.
Comentários
O layout de texto resultante só deve ser usado para a resolução pretendida e, para casos em que a escalabilidade de texto é desejada , CreateTextLayout deve ser usado.
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Windows 7, Windows Vista com SP2 e Atualização de Plataforma para Windows Vista [aplicativos da área de trabalho | Aplicativos UWP] |
| Servidor mínimo com suporte | Windows Server 2008 R2, Windows Server 2008 com SP2 e Atualização de Plataforma para Windows Server 2008 [aplicativos da área de trabalho | Aplicativos UWP] |
| Plataforma de Destino | Windows |
| Cabeçalho | dwrite.h |
| Biblioteca | Dwrite.lib |
| DLL | Dwrite.dll |