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