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 |