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

Dibuja una ejecución de glifos en un destino de mapa de bits en la posición especificada.

Sintaxis

HRESULT DrawGlyphRun(
                  FLOAT                  baselineOriginX,
                  FLOAT                  baselineOriginY,
                  DWRITE_MEASURING_MODE  measuringMode,
  [in]            DWRITE_GLYPH_RUN const *glyphRun,
                  IDWriteRenderingParams *renderingParams,
                  COLORREF               textColor,
  [out, optional] RECT                   *blackBoxRect
);

Parámetros

baselineOriginX

Tipo: FLOAT

Posición horizontal del origen de línea base, en DIP, relativa a la esquina superior izquierda de la DIB.

baselineOriginY

Tipo: FLOAT

Posición vertical del origen de línea base, en DIP, relativa a la esquina superior izquierda de la DIB.

measuringMode

Tipo: DWRITE_MEASURING_MODE

Método de medición para glifos en la ejecución, que se usa con las demás propiedades para determinar el modo de representación.

[in] glyphRun

Tipo: const DWRITE_GLYPH_RUN*

Estructura que contiene las propiedades de la ejecución del glifo.

renderingParams

Tipo: IDWriteRenderingParams*

Objeto que controla el comportamiento de representación.

textColor

Tipo: COLORREF

Color de primer plano del texto.

[out, optional] blackBoxRect

Tipo: RECT*

Rectángulo opcional que recibe el rectángulo delimitador (en píxeles no DIP) de todos los píxeles afectados por dibujar la ejecución del glifo. El rectángulo de cuadro negro puede extenderse más allá de las dimensiones del mapa de bits.

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

Puede usar IDWriteBitmapRenderTarget::D rawGlyphRun para representarlo en un mapa de bits desde un representador de texto personalizado que implemente. El representador de texto personalizado debe llamar a este método desde el método IDWriteTextRenderer::D rawGlyphRun callback, como se muestra en el código siguiente.

STDMETHODIMP GdiTextRenderer::DrawGlyphRun(
    __maybenull 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
    )
{
    HRESULT hr = S_OK;

    // Pass on the drawing call to the render target to do the real work.
    RECT dirtyRect = {0};

    hr = pRenderTarget_->DrawGlyphRun(
        baselineOriginX,
        baselineOriginY,
        measuringMode,
        glyphRun,
        pRenderingParams_,
        RGB(0,200,255),
        &dirtyRect
        );
    

    return hr;
}

Los parámetros baselineOriginX, baslineOriginY, measuringMethod y glyphRun se proporcionan (como argumentos) cuando se invoca el método de devolución de llamada. El elemento renderingParams, textColor y blackBoxRect no lo son.

Los parámetros de representación predeterminados se pueden recuperar mediante el método IDWriteFactory::CreateMonitorRenderingParams .

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

IDWriteBitmapRenderTarget