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

  • Artículo

Dibuja texto mediante el contexto de dibujo de cliente especificado.

Sintaxis

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

Parámetros

clientDrawingContext

Tipo: void*

Contexto de dibujo definido por la aplicación.

renderer

Tipo: IDWriteTextRenderer*

Puntero al conjunto de funciones de devolución de llamada usadas para dibujar partes de una cadena de texto.

originX

Tipo: FLOAT

Coordenada x del lado izquierdo del diseño.

originY

Tipo: FLOAT

Coordenada y del lado superior del diseño.

Valor devuelto

Tipo: HRESULT

Si este método se realiza correctamente, devuelve S_OK. De lo contrario, devuelve un código de error de HRESULT.

Comentarios

Para dibujar texto con este método, la aplicación debe crear un objeto textLayout mediante IDWriteFactory::CreateTextLayout.

Una vez obtenido el objeto textLayout , la aplicación llama al método IDWriteTextLayout::D raw para dibujar el texto, las decoraciones y los objetos insertados. El dibujo real se realiza a través de la interfaz de devolución de llamada que se pasa como el argumento textRenderer ; allí, se llama a la API DrawGlyphRun correspondiente.

Si establece una dirección de lectura de texto vertical en IDWriteTextLayout a través de SetReadingDirection con DWRITE_READING_DIRECTION_TOP_TO_BOTTOM (o inferior a arriba), debe pasar una interfaz que implemente IDWriteTextRenderer1. De lo contrario, obtendrá el error DWRITE_E_TEXTRENDERERINCOMPATIBLE porque la interfaz IDWriteTextRenderer original solo admitía texto horizontal.

Requisitos

   
Cliente mínimo compatible Windows 7, Windows Vista con SP2 y Platform Update para Windows Vista [aplicaciones de escritorio | Aplicaciones para UWP]
Servidor mínimo compatible Windows Server 2008 R2, Windows Server 2008 con SP2 y Actualización de plataforma para Windows Server 2008 [aplicaciones de escritorio | Aplicaciones para UWP]
Plataforma de destino Windows
Encabezado dwrite.h
Library Dwrite.lib
Archivo DLL Dwrite.dll

Consulte también

IDWriteTextLayout