Compartir a través de

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

  • Artículo

Toma una cadena, formato y restricciones asociadas, y genera un objeto que representa el resultado, con formato para una resolución de pantalla determinada y modo de medición.

Sintaxis

HRESULT CreateGdiCompatibleTextLayout(
  [in]           WCHAR const         *string,
                 UINT32              stringLength,
                 IDWriteTextFormat   *textFormat,
                 FLOAT               layoutWidth,
                 FLOAT               layoutHeight,
                 FLOAT               pixelsPerDip,
  [in, optional] DWRITE_MATRIX const *transform,
                 BOOL                useGdiNatural,
  [out]          IDWriteTextLayout   **textLayout
);

Parámetros

[in] string

Tipo: const WCHAR*

Matriz de caracteres que contiene la cadena a partir de la que se va a crear un nuevo objeto IDWriteTextLayout . Esta matriz debe ser de longitud stringLength y puede contener caracteres NULL incrustados.

stringLength

Tipo: UINT32

Longitud de la cadena, en recuento de caracteres.

textFormat

Tipo: IDWriteTextFormat*

Objeto de formato de texto que se va a aplicar a la cadena.

layoutWidth

Tipo: FLOAT

Ancho del cuadro de diseño.

layoutHeight

Tipo: FLOAT

Alto del cuadro de diseño.

pixelsPerDip

Tipo: FLOAT

Número de píxeles físicos por DIP (píxel independiente del dispositivo). Por ejemplo, si la representación en un dispositivo de 96 PPP píxelesPerDip es 1. Si la representación en un dispositivo de 120 PPP píxelesPerDip es 1,25 (120/96).

[in, optional] transform

Tipo: const DWRITE_MATRIX*

Transformación opcional aplicada a los glifos y sus posiciones. Esta transformación se aplica después de que el escalado especifique el tamaño de fuente y los píxeles por DIP.

useGdiNatural

Tipo: BOOL

Indica al diseño de texto que use las mismas métricas que el texto de nivel bi de GDI cuando se establece en FALSE. Cuando se establece en TRUE, indica al diseño de texto que use las mismas métricas que el texto medido por GDI mediante una fuente creada con CLEARTYPE_NATURAL_QUALITY.

[out] textLayout

Tipo: IDWriteTextLayout**

Cuando este método vuelve, contiene una dirección al puntero del objeto de diseño de texto resultante.

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

El diseño de texto resultante solo debe usarse para la resolución prevista y, en los casos en los que se desee la escalabilidad de texto, se debe usar CreateTextLayout en su lugar.

Requisitos

Requisito Value
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

IDWriteFactory