GraphicsPath ::AddString(constWCHAR*,INT,constFontFamily*,INT,REAL,constRectF&,constStringFormat*) (gdipluspath.h)
La méthode GraphicsPath ::AddString ajoute le contour d’une chaîne à ce chemin.
Syntaxe
Status AddString(
[in] const WCHAR *string,
[in] INT length,
[in] const FontFamily *family,
[in] INT style,
[in] REAL emSize,
[in, ref] const RectF & layoutRect,
[in] const StringFormat *format
);
Paramètres
[in] string
Type : const WCHAR*
Pointeur vers une chaîne à caractères larges.
[in] length
Type : INT
Entier qui spécifie le nombre de caractères à afficher. Si le paramètre de chaîne pointe vers une chaîne terminée par null, ce paramètre peut être défini sur –1.
[in] family
Type : const FontFamily*
Pointeur vers un objet FontFamily qui spécifie la famille de polices de la chaîne.
[in] style
Type : INT
Entier qui spécifie le style de la police de type. Cette valeur doit être un élément de l’énumération FontStyle ou le résultat d’une OR au niveau du bit appliquée à deux ou plusieurs de ces éléments. Par exemple, FontStyleBold | FontStyleUnderline | FontStyleStrikeout
définit le style en tant que combinaison des trois styles.
[in] emSize
Type : REAL
Nombre réel qui spécifie la taille em, en unités mondiales, des caractères de chaîne.
[in, ref] layoutRect
Type : const RectF
Référence à un objet RectF qui spécifie, en unités mondiales, le rectangle englobant de la chaîne.
[in] format
Type : const StringFormat*
Pointeur vers un objet StringFormat qui spécifie des informations de disposition (alignement, découpage, tabulation, etc.) pour la chaîne.
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
Notez que GDI+ ne prend pas en charge les polices PostScript ou OpenType qui n’ont pas de contours TrueType.
Exemples
L’exemple suivant crée un chemin d’accès à l’objet GraphicsPath, ajoute une chaîne terminée par NULL au chemin d’accès, puis dessine le chemin.
VOID Example_AddString(HDC hdc)
{
Graphics graphics(hdc);
FontFamily fontFamily(L"Times New Roman");
GraphicsPath path;
path.AddString(
L"Hello World",
-1, // NULL-terminated string
&fontFamily,
FontStyleRegular,
48,
RectF(50.0f, 50.0f, 150.0f, 100.0f),
NULL);
Pen pen(Color(255, 255, 0, 0));
graphics.DrawPath(&pen, &path);
}
Configuration requise
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 | gdipluspath.h (inclure Gdiplus.h) |
Bibliothèque | Gdiplus.lib |
DLL | Gdiplus.dll |
Voir aussi
Génération et dessin de tracés
Commentaires
https://aka.ms/ContentUserFeedback.
Bientôt disponible : Tout au long de 2024, nous allons supprimer progressivement GitHub Issues comme mécanisme de commentaires pour le contenu et le remplacer par un nouveau système de commentaires. Pour plus d’informations, consultezEnvoyer et afficher des commentaires pour