Méthode AdjustableArrowCap ::SetMiddleInset (gdipluslinecaps.h)

Article
03/02/2024

La méthode AdjustableArrowCap ::SetMiddleInset définit le nombre d’unités que le point médian de la base déplace vers le sommet.

Syntaxe

Status SetMiddleInset(
  [in] REAL middleInset
);

Paramètres

[in] middleInset

Type : REAL

Nombre réel qui spécifie le nombre d’unités que le point médian de la base déplace vers le sommet.

Valeur retournée

Type : État

Si la méthode réussit, elle retourne Ok, qui est un élément de l’énumération Status .

Si la méthode échoue, elle retourne l’un des autres éléments de l’énumération Status .

Remarques

L’en-tête central est le nombre d’unités que le point central de la base déplace vers le sommet. Un ensemble central de zéro n’entraîne aucun décalage : la base est une ligne droite, ce qui donne à la flèche une forme triangulaire. Un en-tête central positif (supérieur à zéro) entraîne un décalage du nombre spécifié d’unités vers le vertex . La base est une forme de flèche qui pointe vers le sommet, ce qui donne à la flèche une forme en V. Un incrusté du milieu négatif (inférieur à zéro) entraîne un décalage du nombre spécifié d’unités par rapport au sommet : la base devient une forme de flèche qui pointe loin du sommet, donnant à la flèche une forme de diamant (si la valeur absolue de l’incrusté du milieu est égale à la hauteur) ou une forme de diamant déformée. Si l’en-tête du milieu est égal ou supérieur à la hauteur de la flèche, le capuchon n’apparaît pas du tout. La valeur de l’en-tête central affecte le capuchon de la flèche uniquement si la flèche est remplie. L’inset central a la valeur zéro par défaut lorsqu’un objet AdjustableArrowCap est construit.

Exemples

L’exemple suivant crée un objet AdjustableArrowCap , myArrow, et définit l’incrusté au milieu de la limite sur 5 pixels. Le code crée ensuite un objet Pen et affecte myArrow comme limite de ligne de fin pour cet objet Pen . Ensuite, le code dessine une ligne limitée.

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));
}

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows XP, Windows 2000 Professionnel [applications de bureau uniquement]
Serveur minimal pris en charge	Windows 2000 Server [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	gdipluslinecaps.h (inclure Gdiplus.h)
Bibliothèque	Gdiplus.lib
DLL	Gdiplus.dll

Partager via