Interfaz IDWriteTextFormat (dwrite.h)

La interfaz IDWriteTextFormat describe las propiedades de fuente y párrafo que se usan para dar formato al texto y describe la información de configuración regional.

Herencia

La interfaz IDWriteTextFormat hereda de la interfaz IUnknown . IDWriteTextFormat también tiene estos tipos de miembros:

Métodos

La interfaz IDWriteTextFormat tiene estos métodos.

IDWriteTextFormat::GetFlowDirection Obtiene la dirección en la que fluyen las líneas de texto.
IDWriteTextFormat::GetFontCollection Obtiene la colección de fuentes actual.
IDWriteTextFormat::GetFontFamilyName Obtiene una copia del nombre de la familia de fuentes.
IDWriteTextFormat::GetFontFamilyNameLength Obtiene la longitud del nombre de familia de fuentes.
IDWriteTextFormat::GetFontSize Obtiene el tamaño de fuente en unidades DIP.
IDWriteTextFormat::GetFontStretch Obtiene la extensión de fuente del texto.
IDWriteTextFormat::GetFontStyle Obtiene el estilo de fuente del texto.
IDWriteTextFormat::GetFontWeight Obtiene el peso de fuente del texto.
IDWriteTextFormat::GetIncrementalTabStop Obtiene la posición de tabulación incremental.
IDWriteTextFormat::GetLineSpacing Obtiene el ajuste de interlineado establecido para un párrafo de texto multilínea. (IDWriteTextFormat.GetLineSpacing)
IDWriteTextFormat::GetLocaleName Obtiene una copia del nombre de la configuración regional.
IDWriteTextFormat::GetLocaleNameLength Obtiene la longitud del nombre de la configuración regional.
IDWriteTextFormat::GetParagraphAlignment Obtiene la opción de alineación de un párrafo que es relativo a los bordes superior e inferior de un cuadro de diseño.
IDWriteTextFormat::GetReadingDirection Obtiene la dirección de lectura actual del texto de un párrafo.
IDWriteTextFormat::GetTextAlignment Obtiene la opción de alineación del texto en relación con el borde inicial y final del cuadro de diseño.
IDWriteTextFormat::GetTrimming Obtiene las opciones de recorte del texto que desborda el cuadro de diseño.
IDWriteTextFormat::GetWordWrapping Obtiene la opción de ajuste de palabras.
IDWriteTextFormat::SetFlowDirection Establece la dirección del flujo del párrafo.
IDWriteTextFormat::SetIncrementalTabStop Establece una distancia fija entre dos tabulaciones adyacentes.
IDWriteTextFormat::SetLineSpacing Establece el espaciado de líneas.
IDWriteTextFormat::SetParagraphAlignment Establece la opción de alineación de un párrafo en relación con el borde superior e inferior del cuadro de diseño.
IDWriteTextFormat::SetReadingDirection Establece la dirección de lectura del párrafo.
IDWriteTextFormat::SetTextAlignment Establece la alineación del texto en un párrafo, en relación con el borde inicial y final de un cuadro de diseño para una interfaz IDWriteTextFormat.
IDWriteTextFormat::SetTrimming Establece las opciones de recorte para el texto que desborda el ancho del diseño.
IDWriteTextFormat::SetWordWrapping Establece la opción de ajuste de palabras.

Comentarios

Para obtener una referencia a la interfaz IDWriteTextFormat , la aplicación debe llamar al método IDWriteFactory::CreateTextFormat como se muestra en el código siguiente.

if (SUCCEEDED(hr))
{
    hr = pDWriteFactory_->CreateTextFormat(
        L"Gabriola",
        NULL,
        DWRITE_FONT_WEIGHT_REGULAR,
        DWRITE_FONT_STYLE_NORMAL,
        DWRITE_FONT_STRETCH_NORMAL,
        72.0f,
        L"en-us",
        &pTextFormat_
        );
}

Al crear un objeto IDWriteTextFormat mediante la función CreateTextFormat , la aplicación especifica la familia de fuentes, la colección de fuentes, el peso de fuente, el tamaño de fuente y el nombre de la configuración regional para el formato de texto.

Estas propiedades no se pueden cambiar después de crear el objeto IDWriteTextFormat . Para cambiar estas propiedades, se debe crear un nuevo objeto IDWriteTextFormat con las propiedades deseadas.

La interfaz IDWriteTextFormat se usa para dibujar texto con un solo formato.

Para dibujar texto con varios formatos, o para usar un representador de texto personalizado, use la interfaz IDWriteTextLayout . IDWriteTextLayout permite a la aplicación cambiar el formato de los intervalos de texto dentro de la cadena. IdWriteFactory::CreateTextLayout toma un objeto IDWriteTextFormat como parámetro y aplica inicialmente la información de formato a toda la cadena.

Este objeto puede no ser seguro para subprocesos y puede llevar el estado del cambio de formato de texto.

DirectWrite y Direct2D

Para dibujar texto simple con un solo formato, Direct2D proporciona el método ID2D1RenderTarget::D rawText , que dibuja una cadena con la información de formato proporcionada por un objeto IDWriteTextFormat .

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