IInkRenderer::D raw-Methode (msinkaut.h)

Artikel
03/06/2024

Zeichnet Freihandstriche mithilfe des bekannten Gerätekontexts.

Syntax

HRESULT Draw(
  [in] LONG_PTR    hDC,
  [in] IInkStrokes *Strokes
);

Parameter

[in] hDC

Gibt den hWnd des Gerätekontexts an, auf dem gezeichnet werden soll.

[in] Strokes

Gibt die zu zeichnenden Striche an.

Rückgabewert

Diese Methode kann einen dieser Werte zurückgeben.

Rückgabecode	BESCHREIBUNG
S_OK	Erfolg.
E_POINTER	Ein Parameter enthielt einen ungültigen Zeiger.
E_INK_MISMATCHED_INK_OBJECT	Der Strichparameter ist einem anderen InkDisp-Objekt zugeordnet.
E_INVALIDARG	Ein Argument ist ungültig.
E_INK_INCOMPATIBLE_OBJECT	Der hdc - oder der strokes-Parameter zeigt nicht auf ein gültiges Objekt.
E_INK_EXCEPTION	Innerhalb der -Methode ist eine Ausnahme aufgetreten.
E_UNEXPECTED	Unerwarteter Parameter oder Eigenschaftstyp.

Hinweise

Die Stiftbreite wird mit der Quadratwurzel der Determinante der Ansichtstransformation multipliziert (oder skaliert).

Hinweis Wenn Sie die Stiftbreite nicht explizit festgelegt haben, ist sie standardmäßig 53. Sie müssen die Stiftbreite mit der Quadratwurzel der Determinante multiplizieren, um den richtigen Begrenzungsrahmen zu erhalten. Höhe und Breite des Begrenzungsrahmens werden in jeder Richtung um die Hälfte dieses Betrags erweitert.

Angenommen, die Stiftbreite beträgt 53, die Quadratwurzel der Determinante ist 50 und der Begrenzungsrahmen ist (0,0,1000,1000). Die Anpassung der Stiftbreite am Begrenzungsrahmen in jeder Richtung wird als (53*50)/2 berechnet, und die rechte und die untere Seite werden um eins erhöht. Dies führt zu einem gerenderten Begrenzungsrahmen von (-1325,-1325,2326,2326).

Hinweis Verwenden Sie die DrawStroke-Methode , um einen einzelnen Strich zu zeichnen.

Der InkRenderer erzwingt die Viewport- und Fensterherkunft auf 0, 0. Alle vorhandenen Einstellungen werden gespeichert und wiederhergestellt, aber nicht vom InkRenderer verwendet. Verwenden Sie zum Ausführen eines Bildlaufs die Ansichts- und Objekttransformationsmethoden des InkRenderer-Objekts .

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows XP Tablet PC Edition [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Nicht unterstützt
Zielplattform	Windows
Kopfzeile	msinkaut.h
Bibliothek	InkObj.dll