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 |