Método IDWriteFactory::CreateTextLayout (dwrite.h)

Artigo
08/23/2023

Usa uma cadeia de caracteres, um formato de texto e restrições associadas e produz um objeto que representa o resultado totalmente analisado e formatado.

Sintaxe

HRESULT CreateTextLayout(
  [in]  WCHAR const       *string,
        UINT32            stringLength,
        IDWriteTextFormat *textFormat,
        FLOAT             maxWidth,
        FLOAT             maxHeight,
  [out] IDWriteTextLayout **textLayout
);

Parâmetros

[in] string

Tipo: const WCHAR*

Uma matriz de caracteres que contém a cadeia de caracteres da qual criar um novo objeto IDWriteTextLayout . Essa matriz deve ter comprimento stringLength e pode conter caracteres NULL inseridos.

stringLength

Tipo: UINT32

O número de caracteres na cadeia de caracteres.

textFormat

Tipo: IDWriteTextFormat*

Um ponteiro para um objeto que indica o formato a ser aplicado à cadeia de caracteres.

maxWidth

Tipo: FLOAT

A largura da caixa de layout.

maxHeight

Tipo: FLOAT

A altura da caixa de layout.

[out] textLayout

Tipo: IDWriteTextLayout**

Quando este método retorna, contém um endereço de um ponteiro para o 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.

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 Platform Update 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

Compartilhar via