Graphics ::D rawString(constWCHAR,INT,constFont,constPointF&,constStringFormat,constBrush) , méthode (gdiplusgraphics.h)

Article
02/29/2024

La méthode Graphics ::D rawString dessine une chaîne en fonction d’une police, d’une origine de chaîne et d’un format.

Syntaxe

Status DrawString(
  [in]      const WCHAR        *string,
  [in]      INT                length,
  [in]      const Font         *font,
  [in, ref] const PointF &     origin,
  [in]      const StringFormat *stringFormat,
  [in]      const Brush        *brush
);

Paramètres

[in] string

Type : const WCHAR*

Pointeur vers une chaîne de caractères larges à dessiner.

[in] length

Type : INT

Entier qui spécifie le nombre de caractères dans le tableau de chaînes . Le paramètre length peut être défini sur –1 si la chaîne est terminée par null.

[in] font

Type : const Font*

Pointeur vers un objet Font qui spécifie les attributs de police (le nom de famille, la taille et le style de la police) à utiliser.

[in, ref] origin

Type : const PointF

Référence à un objet PointF qui spécifie le point de départ de la chaîne.

[in] stringFormat

Type : const StringFormat*

Pointeur vers un objet StringFormat qui spécifie les informations de disposition de texte et les manipulations d’affichage à appliquer à la chaîne.

[in] brush

Type : const Brush*

Pointeur vers un objet Brush utilisé pour remplir 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.

Lorsque vous utilisez l’API GDI+, vous ne devez pas autoriser votre application à télécharger des polices arbitraires à partir de sources non approuvées. Le système d’exploitation nécessite des privilèges élevés pour garantir que toutes les polices installées sont approuvées.

Exemples

L’exemple suivant utilise la mise en forme spécifiée pour dessiner une chaîne à l’origine spécifiée.

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

   // Create a string.
   WCHAR string[] = L"Sample Text";
   
   // Initialize arguments.
   Font myFont(L"Arial", 16);
   PointF origin(0.0f, 0.0f);
   SolidBrush blackBrush(Color(255, 0, 0, 0));
   StringFormat format;
   format.SetAlignment(StringAlignmentCenter);

   // Draw string.
   graphics.DrawString(
   string,
   11,
   &myFont,
   origin,
   &format,
   &blackBrush);
}

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	gdiplusgraphics.h (inclure Gdiplus.h)
Bibliothèque	Gdiplus.lib
DLL	Gdiplus.dll