Freigeben über


IDWriteTextLayout::SetDrawingEffect-Methode (dwrite.h)

Legt den anwendungsdefinierten Zeichnungseffekt fest.

Syntax

HRESULT SetDrawingEffect(
  IUnknown          *drawingEffect,
  DWRITE_TEXT_RANGE textRange
);

Parameter

drawingEffect

Typ: IUnknown*

Anwendungsdefinierte Zeichnungseffekte, die für den Bereich gelten. Dieses Datenobjekt wird zum endgültigen Rendering an die Zeichnungsrückrufe der Anwendung zurückgegeben.

textRange

Typ: DWRITE_TEXT_RANGE

Der Textbereich, für den diese Änderung gilt.

Rückgabewert

Typ: HRESULT

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

Bemerkungen

Ein ID2D1Brush, z. B. ein Farb- oder Farbverlaufpinsel, kann als Zeichnungseffekt festgelegt werden, wenn Sie id2D1RenderTarget::D rawTextLayout zum Zeichnen von Text verwenden und dieser Pinsel zum Zeichnen des angegebenen Textbereichs verwendet wird.

Dieser Zeichnungseffekt ist dem angegebenen Bereich zugeordnet und wird über den Rückruf an die Anwendung zurückgegeben, wenn der Bereich zur Zeichnungszeit gezeichnet wird.

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

Idwritetextlayout