AdjustableArrowCap::SetMiddleInset-Methode (gdipluslinecaps.h)

Artikel
08/24/2023

Die AdjustableArrowCap::SetMiddleInset-Methode legt die Anzahl der Einheiten fest, die der Mittelpunkt der Basis zum Scheitelpunkt verschiebt.

Syntax

Status SetMiddleInset(
  [in] REAL middleInset
);

Parameter

[in] middleInset

Typ: REAL

Reelle Zahl, die die Anzahl der Einheiten angibt, die der Mittelpunkt der Basis in Richtung des Scheitelpunkts verschiebt.

Rückgabewert

Typ: Status

Wenn die Methode erfolgreich ist, gibt sie OK zurück, ein Element der Status-Enumeration .

Wenn die Methode fehlschlägt, gibt sie eines der anderen Elemente der Status-Enumeration zurück.

Hinweise

Der mittlere Einset ist die Anzahl der Einheiten, die der Mittelpunkt der Basis in Richtung des Scheitelpunkts verschiebt. Ein mittlerer Nulleinbruch führt zu keiner Verschiebung – die Basis ist eine gerade Linie, die dem Pfeil eine dreieckige Form verleiht. Ein positiver Mitteleinbruch (größer als null) führt zu einer Verschiebung der angegebenen Anzahl von Einheiten zum Scheitelpunkt – die Basis ist eine Pfeilform, die auf den Scheitelpunkt zeigt und der Pfeilkappe eine V-Form ergibt. Ein negativer Mitteleinbruch (kleiner als 00) führt zu einer Verschiebung der angegebenen Anzahl von Einheiten vom Scheitelpunkt entfernt – die Basis wird zu einer Pfeilform, die vom Scheitelpunkt weg zeigt und dem Pfeil entweder eine Diamantform (wenn der absolute Wert des mittleren Einsatzes gleich der Höhe ist) oder eine verzerrte Rautenform ergibt. Wenn der mittlere Einset gleich oder größer als die Höhe der Pfeilkappe ist, wird die Obergrenze überhaupt nicht angezeigt. Der Wert des mittleren Satzes wirkt sich nur auf die Pfeilkappe aus, wenn die Pfeilkappe gefüllt ist. Der mittlere Einschub ist standardmäßig 0, wenn ein AdjustableArrowCap-Objekt erstellt wird.

Beispiele

Im folgenden Beispiel wird ein AdjustableArrowCap-Objekt , myArrow, erstellt und der mittlere Einschub der Obergrenze auf 5 Pixel festgelegt. Der Code erstellt dann ein Pen-Objekt und weist myArrow als endende Zeilenkappe für dieses Pen-Objekt zu. Als Nächstes zeichnet der Code eine gekappte Linie.

VOID Example_SetMiddleInset(HDC hdc)
{
   Graphics graphics(hdc);

   // Create an AdjustableArrowCap, and set the middle inset to 5.
   AdjustableArrowCap myArrow(10, 10, true);
   myArrow.SetMiddleInset(5.0f);

   // Create a Pen, and assign myArrow as the end cap.
   Pen arrowPen(Color(255, 0, 0, 0));
   arrowPen.SetCustomEndCap(&myArrow);

   // Draw a line using arrowPen.
   graphics.DrawLine(&arrowPen, Point(0, 0), Point(100, 100));
}

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows XP, Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows 2000 Server [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	gdipluslinecaps.h (include Gdiplus.h)
Bibliothek	Gdiplus.lib
DLL	Gdiplus.dll

Share via