IDWriteBitmapRenderTarget::D rawGlyphRun-Methode (dwrite.h)

Zeichnet eine Ausführung von Glyphen auf ein Bitmapziel an der angegebenen Position.

Syntax

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

Parameter

baselineOriginX

Typ: FLOAT

Die horizontale Position des Basisplanursprungs in DIPs relativ zur oberen linken Ecke des DIB.

baselineOriginY

Typ: FLOAT

Die vertikale Position des Basisplanursprungs in DIPs relativ zur oberen linken Ecke des DIB.

measuringMode

Typ: DWRITE_MEASURING_MODE

Die Messmethode für Glyphen im Lauf, die zusammen mit den anderen Eigenschaften verwendet wird, um den Renderingmodus zu bestimmen.

[in] glyphRun

Typ: const DWRITE_GLYPH_RUN*

Die -Struktur, die die Eigenschaften der Glyphenausführung enthält.

renderingParams

Typ: IDWriteRenderingParams*

Das -Objekt, das das Renderingverhalten steuert.

textColor

Typ: COLORREF

Die Vordergrundfarbe des Texts.

[out, optional] blackBoxRect

Typ: RECT*

Das optionale Rechteck, das den Begrenzungsrahmen (in Pixeln, nicht DIPs) aller Pixel empfängt, die vom Zeichnen der Glyphenausführung betroffen sind. Das Blackbox-Rechteck kann über die Abmessungen der Bitmap hinausgehen.

Rückgabewert

Typ: HRESULT

Wenn diese Methode erfolgreich ist, wird S_OK zurückgegeben. Andernfalls wird ein Fehlercode HRESULT zurückgegeben.

Hinweise

Sie können IDWriteBitmapRenderTarget::D rawGlyphRun verwenden, um aus einem benutzerdefinierten Textrenderer, den Sie implementieren, in einer Bitmap zu rendern. Der benutzerdefinierte Textrenderer sollte diese Methode aus der IDWriteTextRenderer::D rawGlyphRun-Rückrufmethode aufrufen, wie im folgenden Code gezeigt.

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;
}

Die Parameter baselineOriginX, baslineOriginY, measuringMethod und glyphRun werden (als Argumente) bereitgestellt, wenn die Rückrufmethode aufgerufen wird. RenderingParams, textColor und blackBoxRect sind nicht.

Standardrenderingparameter können mithilfe der IDWriteFactory::CreateMonitorRenderingParams-Methode abgerufen werden.

Anforderungen

Unterstützte Mindestversion (Client)	Windows 7, Windows Vista mit SP2 und Plattformupdate für Windows Vista [Desktop-Apps | UWP-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2008 R2, Windows Server 2008 mit SP2 und Plattformupdate für Windows Server 2008 [Desktop-Apps | UWP-Apps]
Zielplattform	Windows
Kopfzeile	dwrite.h
Bibliothek	Dwrite.lib
DLL	Dwrite.dll

Weitere Informationen

IDWriteBitmapRenderTarget