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

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

Syntaxe

Status DrawString(
  const WCHAR        *string,
  INT                length,
  const Font         *font,
  const RectF &      layoutRect,
  const StringFormat *stringFormat,
  const Brush        *brush
);

Paramètres

string

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

length

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.

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.

layoutRect

Référence à un rectangle qui limite la chaîne.

stringFormat

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

brush

Pointeur vers un objet Brush utilisé pour remplir la chaîne.

Valeur retournée

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 dans un rectangle de disposition.

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

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

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

   // Draw layoutRect.
   graphics.DrawRectangle(&Pen(Color::Black, 3), layoutRect);
}

Configuration requise

En-tête	gdiplusgraphics.h

Voir aussi

Graphismes

Police

Stylet

RectF

StringFormat