IDWriteTextRenderer1::D rawUnderline-Methode (dwrite_2.h)

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

Syntax

HRESULT DrawUnderline(
       void                           *clientDrawingContext,
       FLOAT                          baselineOriginX,
       FLOAT                          baselineOriginY,
       DWRITE_GLYPH_ORIENTATION_ANGLE orientationAngle,
  [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 Basispunkt der Ausführung, an der unterstrichen wird.

baselineOriginY

Typ: FLOAT

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

orientationAngle

Typ: DWRITE_GLYPH_ORIENTATION_ANGLE

Ausrichtung der Unterstreichung.

[in] underline

Typ: const DWRITE_UNDERLINE*

Zeiger auf eine Struktur, die logische Informationen unterstreicht.

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. Fügen Sie der Baseline unterstrichen::offset hinzu, um eine geeignete Startpixelposition zu erhalten. 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 Lücken oder eine doppelstempelte Alphamischung verursachen kann. Um Alphaüberlappung zu vermeiden, runden Sie den Endpunkt auf das nächste 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_2.h
Bibliothek	Dwrite.lib
DLL	Dwrite.dll

Weitere Informationen

IDWriteTextRenderer1