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

Confira também

IDWriteFactory