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

Artikel
08/23/2023

IDWriteTextLayout::Draw ruft diese Funktion auf, um den Client anzuweisen, eine Ausführung von Glyphen zu rendern.

Syntax

HRESULT DrawGlyphRun(
       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
);

Parameter

clientDrawingContext

Typ: void*

Der anwendungsdefinierte Zeichnungskontext, der an IDWriteTextLayout::D raw übergeben wird.

baselineOriginX

Typ: FLOAT

Die Pixelposition (X-Koordinate) am Basisursprung der Glyphenausführung.

baselineOriginY

Typ: FLOAT

Die Pixelposition (Y-Koordinate) am Basisursprung des Glyphenlaufs.

measuringMode

Typ: DWRITE_MEASURING_MODE

Die Messmethode für Glyphen in der Ausführung, die mit den anderen Eigenschaften verwendet wird, um den Renderingmodus zu bestimmen.

[in] glyphRun

Typ: const DWRITE_GLYPH_RUN*

Zeiger auf die Glyphenausführung, instance gerendert werden soll.

[in] glyphRunDescription

Typ: const DWRITE_GLYPH_RUN_DESCRIPTION*

Ein Zeiger auf die Glyphenausführungsbeschreibung instance die Eigenschaften der zeichen enthält, die dieser Ausführung zugeordnet sind.

clientDrawingEffect

Typ: IUnknown*

Anwendungsdefinierte Zeichnungseffekte für die zu rendernden Glyphen. Normalerweise stellt dieses Argument Effekte wie den Vordergrundpinsel dar, der das Innere des Texts füllt.

Rückgabewert

Typ: HRESULT

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

Hinweise

Die IDWriteTextLayout::D raw-Funktion ruft diese Rückruffunktion mit allen Informationen zu den zu rendernden Glyphen auf. Die Anwendung implementiert diesen Rückruf, indem sie den Aufruf größtenteils an die Grafik-API der zugrunde liegenden Plattform delegiert, z. B . Direct2D , um Glyphen im Zeichnungskontext zu zeichnen. Eine Anwendung, die GDI verwendet, kann diesen Rückruf in Bezug auf die IDWriteBitmapRenderTarget::D rawGlyphRun-Methode implementieren.

Anforderungen

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

IDWriteTextRenderer

Freigeben über