Graphics ::D rawString(constWCHAR*,INT,constFont*,constPointF&,constStringFormat*,constBrush*) , méthode (gdiplusgraphics.h)
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 |