Graphics::D rawString(constWCHAR*,INT,constFont*,constRectF&,constStringFormat*,constBrush*) (gdiplusgraphics.h)
Il metodo Graphics::D rawString disegna una stringa basata su un tipo di carattere, un rettangolo di layout e un formato.
Sintassi
Status DrawString(
const WCHAR *string,
INT length,
const Font *font,
const RectF & layoutRect,
const StringFormat *stringFormat,
const Brush *brush
);
Parametri
string
Puntatore a una stringa di caratteri wide da disegnare.
length
Intero che specifica il numero di caratteri nella matrice di stringhe . Il parametro di lunghezza può essere impostato su -1 se la stringa è terminata null.
font
Puntatore a un oggetto Font che specifica gli attributi del tipo di carattere (il nome della famiglia, le dimensioni e lo stile del tipo di carattere) da usare.
layoutRect
Riferimento a un rettangolo che delimita la stringa.
stringFormat
Puntatore a un oggetto StringFormat che specifica le informazioni sul layout di testo e visualizza le manipolazioni da applicare alla stringa.
brush
Puntatore a un oggetto Brush utilizzato per riempire la stringa.
Valore restituito
Se il metodo ha esito positivo, restituisce Ok, ovvero un elemento dell'enumerazione Status .
Se il metodo ha esito negativo, restituisce uno degli altri elementi dell'enumerazione Status .
Commenti
Si noti che GDI+ non supporta tipi di carattere PostScript o tipi di carattere OpenType che non hanno struttura TrueType.
Quando si usa l'API GDI+, non è necessario consentire all'applicazione di scaricare tipi di carattere arbitrari da origini non attendibili. Il sistema operativo richiede privilegi elevati per garantire che tutti i tipi di carattere installati siano attendibili.
Esempio
Nell'esempio seguente viene usata la formattazione specificata per disegnare una stringa in un rettangolo di layout.
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);
}
Requisiti
| Intestazione | gdiplusgraphics.h |