AdjustableArrowCap::GetMiddleInset-Methode (gdipluslinecaps.h)

Die AdjustableArrowCap::GetMiddleInset-Methode ruft den Wert des Einsets ab. Der mittlere Einset ist die Anzahl der Einheiten, die der Mittelpunkt der Basis in Richtung des Scheitelpunkts verschiebt.

Syntax

REAL GetMiddleInset();

Rückgabewert

Typ: REAL

Diese Methode gibt den Einsetwert 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, wobei der mittlere Einschub auf 0 (Standardwert) festgelegt ist. Der Code erstellt dann ein Pen-Objekt , weist myArrow als endende Zeilenkappe für dieses Pen-Objekt zu und zeichnet eine gekappte Linie. Als Nächstes ruft der Code den mittleren Einset ab, erhöht ihn und zeichnet eine weitere gekappte Linie.

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

   // Create an AdjustableArrowCap with width and height set to 10. 
   // Middle inset defaults to 0 pixels.
   AdjustableArrowCap myArrow(10, 10, true);

   // 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, 10), Point(100, 10));

   // Get the inset of the arrow.
   REAL inset = myArrow.GetMiddleInset();

   // Increase inset by 5 pixels and draw another line.
   myArrow.SetMiddleInset(inset + 5);
   arrowPen.SetCustomEndCap(&myArrow);
   graphics.DrawLine(&arrowPen, Point(0, 40), Point(100, 40));
}

Anforderungen

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