Graphics ::D rawString(constWCHAR*,INT,constFont*,constPointF&,constBrush*) method (gdiplusgraphics.h)

  • Article

La méthode Graphics ::D rawString dessine une chaîne basée sur une police et une origine pour la chaîne.

Syntaxe

Status DrawString(
  [in]      const WCHAR    *string,
  [in]      INT            length,
  [in]      const Font     *font,
  [in, ref] const PointF & origin,
  [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] 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 dessine une chaîne à l’origine spécifiée.

VOID Example_DrawString2(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));

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

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

Voir aussi

Police

Graphismes

Graphicspath

SolidBrush