Compartilhar via

Método IDWriteTextLayout::D raw (dwrite.h)

  • Artigo

Desenha texto usando o contexto de desenho do cliente especificado.

Sintaxe

HRESULT Draw(
  void                *clientDrawingContext,
  IDWriteTextRenderer *renderer,
  FLOAT               originX,
  FLOAT               originY
);

Parâmetros

clientDrawingContext

Tipo: void*

Um contexto de desenho definido pelo aplicativo.

renderer

Tipo: IDWriteTextRenderer*

Ponteiro para o conjunto de funções de retorno de chamada usadas para desenhar partes de uma cadeia de caracteres de texto.

originX

Tipo: FLOAT

A coordenada x do lado esquerdo do layout.

originY

Tipo: FLOAT

A coordenada y do lado superior do layout.

Valor retornado

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

Para desenhar texto com esse método, um objeto textLayout precisa ser criado pelo aplicativo usando IDWriteFactory::CreateTextLayout.

Depois que o objeto textLayout é obtido, o aplicativo chama o método IDWriteTextLayout::D raw para desenhar o texto, decorações e objetos embutidos. O desenho real é feito por meio da interface de retorno de chamada passada como o argumento textRenderer ; lá, a API DrawGlyphRun correspondente é chamada.

Se você definir uma direção de leitura de texto vertical em IDWriteTextLayout por meio de SetReadingDirection com DWRITE_READING_DIRECTION_TOP_TO_BOTTOM (ou de baixo para cima), deverá passar uma interface que implemente IDWriteTextRenderer1. Caso contrário, você receberá o erro DWRITE_E_TEXTRENDERERINCOMPATIBLE porque a interface IDWriteTextRenderer original só suportava texto horizontal.

Requisitos

   
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

IDWriteTextLayout