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

IDWriteTextLayout::Draw ruft diese Funktion auf, um den Client anzuweisen, eine Unterstreichung zu zeichnen.

Syntax

HRESULT DrawUnderline(
       void                   *clientDrawingContext,
       FLOAT                  baselineOriginX,
       FLOAT                  baselineOriginY,
  [in] DWRITE_UNDERLINE const *underline,
       IUnknown               *clientDrawingEffect
);

Parameter

clientDrawingContext

Typ: void*

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

baselineOriginX

Typ: FLOAT

Die Pixelposition (X-Koordinate) am Basisursprung der Ausführung, an der unterstrichen wird.

baselineOriginY

Typ: FLOAT

Die Pixelposition (Y-Koordinate) am Basisursprung der Ausführung, an der unterstrichen wird.

[in] underline

Typ: const DWRITE_UNDERLINE*

Zeiger auf eine Struktur mit unterstrichenen logischen Informationen.

clientDrawingEffect

Typ: IUnknown*

Anwendungsdefinierter Effekt, der auf die Unterstreichung angewendet werden soll. Normalerweise stellt dieses Argument Effekte wie den Vordergrundpinsel dar, der das Innere einer Linie füllt.

Rückgabewert

Typ: HRESULT

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

Hinweise

Eine einzelne Unterstreichung kann in mehrere Aufrufe unterteilt werden, je nachdem, wie die Formatierung Attribute ändert. Wenn sich schriftgrößen/formatvorlagen innerhalb einer Unterstreichung ändern, werden die Stärke und der Offset entsprechend den Zeichen gewichtet. Um eine geeignete Startpixelposition zu erhalten, fügen Sie der Baseline unterstrichen:offset hinzu. Andernfalls gibt es keinen Abstand zwischen dem Text. Die x-Koordinate wird unabhängig von der Textrichtung immer als linke Seite übergeben. Dies vereinfacht das Zeichnen und reduziert das Problem der Abrundung, die möglicherweise zu Lücken oder einer doppelstempelten Alphamischung führen kann. Um Alphaüberlappungen zu vermeiden, runden Sie die Endpunkte auf das nächstgelegene Gerätepixel.

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

IDWriteTextRenderer