ID2D1RenderTarget::D rawText(constWCHAR,UINT32,IDWriteTextFormat,constD2D1_RECT_F&,ID2D1Brush*,D2D1_DRAW_TEXT_OPTIONS,DWRITE_MEASURING_MODE) (d2d1.h)

Artículo
08/22/2023

Dibuja el texto especificado utilizando la información de formato proporcionada por un objeto IDWriteTextFormat .

Sintaxis

void DrawText(
  [in]  const WCHAR            *string,
        UINT32                 stringLength,
  [in]  IDWriteTextFormat      *textFormat,
  [ref] const D2D1_RECT_F &    layoutRect,
  [in]  ID2D1Brush             *defaultFillBrush,
        D2D1_DRAW_TEXT_OPTIONS options,
        DWRITE_MEASURING_MODE  measuringMode
);

Parámetros

[in] string

Tipo: WCHAR*

Un puntero a una matriz de caracteres Unicode por dibujar.

stringLength

Tipo: UINT

Número de caracteres de la cadena.

[in] textFormat

Tipo: IDWriteTextFormat*

Un objeto que describe los detalles de formato del texto que se dibujará, como la fuente, el tamaño de fuente y la dirección del flujo.

[ref] layoutRect

Tipo: const D2D1_RECT_F

El tamaño y la posición del área en que se dibujará el texto.

[in] defaultFillBrush

Tipo: ID2D1Brush*

Pincel utilizado para pintar el texto.

options

Tipo: D2D1_DRAW_TEXT_OPTIONS

Un valor que indica si el texto se debe acoplar a los límites de píxeles y si el texto se debe recortar según el rectángulo de diseño. El valor predeterminado es D2D1_DRAW_TEXT_OPTIONS_NONE, lo que indica que el texto se debe ajustar a los límites de píxeles y no debe recortarse en el rectángulo de diseño.

measuringMode

Tipo: DWRITE_MEASURING_MODE

Un valor que indica cómo se usan las métricas de glifo para medir el texto cuando tiene formato. El valor predeterminado es DWRITE_MEASURING_MODE_NATURAL.

Valor devuelto

None

Observaciones

Para crear un objeto IDWriteTextFormat , cree un IDWriteFactory y llame a su método CreateTextFormat .

Este método no devuelve un código de error si se produce un error. Para determinar si se produjo un error en una operación de dibujo (como DrawText), compruebe el resultado devuelto por los métodos ID2D1RenderTarget::EndDraw o ID2D1RenderTarget::Flush .

Ejemplos

Para obtener un ejemplo, vea Cómo: Dibujar texto.

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	d2d1.h
Library	D2d1.lib
Archivo DLL	D2d1.dll