Compartilhar via


Método IDWriteTextRenderer::D rawGlyphRun (dwrite.h)

IDWriteTextLayout::Draw chama essa função para instruir o cliente a renderizar uma execução de glifos.

Sintaxe

HRESULT DrawGlyphRun(
       void                               *clientDrawingContext,
       FLOAT                              baselineOriginX,
       FLOAT                              baselineOriginY,
       DWRITE_MEASURING_MODE              measuringMode,
  [in] DWRITE_GLYPH_RUN const             *glyphRun,
  [in] DWRITE_GLYPH_RUN_DESCRIPTION const *glyphRunDescription,
       IUnknown                           *clientDrawingEffect
);

Parâmetros

clientDrawingContext

Tipo: void*

O contexto de desenho definido pelo aplicativo passado para IDWriteTextLayout::D raw.

baselineOriginX

Tipo: FLOAT

O local do pixel (coordenada X) na origem da linha de base da execução do glifo.

baselineOriginY

Tipo: FLOAT

O local do pixel (coordenada Y) na origem da linha de base da execução do glifo.

measuringMode

Tipo: DWRITE_MEASURING_MODE

O método de medição para glifos na execução, usado com as outras propriedades para determinar o modo de renderização.

[in] glyphRun

Tipo: const DWRITE_GLYPH_RUN*

Ponteiro para a instância de execução de glifo a ser renderizada.

[in] glyphRunDescription

Tipo: const DWRITE_GLYPH_RUN_DESCRIPTION*

Um ponteiro para a instância de descrição da execução de glifo que contém propriedades dos caracteres associados a essa execução.

clientDrawingEffect

Tipo: IUnknown*

Efeitos de desenho definidos pelo aplicativo para os glifos a serem renderizados. Normalmente, esse argumento representa efeitos como o pincel de primeiro plano preenchendo o interior do texto.

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

A função IDWriteTextLayout::D raw chama essa função de retorno de chamada com todas as informações sobre glifos a serem renderizados. O aplicativo implementa esse retorno de chamada delegando principalmente a chamada à API de gráficos da plataforma subjacente, como Direct2D para desenhar glifos no contexto de desenho. Um aplicativo que usa GDI pode implementar esse retorno de chamada em termos do método IDWriteBitmapRenderTarget::D rawGlyphRun .

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

IDWriteTextRenderer