Funzioni di formato stringa

Windows GDI+ espone un'API flat costituita da circa 600 funzioni, implementate in Gdiplus.dll e dichiarate in Gdiplusflat.h. Le funzioni nell'API flat GDI+ sono incapsulate da una raccolta di circa 40 classi C++. È consigliabile non chiamare direttamente le funzioni nell'API flat. Ogni volta che si effettuano chiamate a GDI+, è necessario chiamare i metodi e le funzioni forniti dai wrapper C++. Il Servizio Supporto Tecnico Clienti Microsoft non fornirà supporto per il codice che chiama direttamente l'API flat. Per altre informazioni sull'uso di questi metodi wrapper, vedere API GDI+ Flat.

Le funzioni API flat seguenti vengono incluse nella classe StringFormat C++.

Funzioni StringFormat e metodi wrapper corrispondenti

Funzione flat	Wrapper, metodo	Osservazioni:
GpStatus WINGDIPAPI GdipCreateStringFormat( INT formatAttributes, LANGID language, GpStringFormat **format )	StringFormat::StringFormat( INT formatFlags = 0, IN LANGID language = LANG_NEUTRAL )	Crea un oggetto StringFormat basato su flag di formato stringa e una lingua.
GpStatus WINGDIPAPI GdipStringFormatGetGenericDefault(GpStringFormat **format)	StringFormat* StringFormat::GenericDefault()	Crea un oggetto StringFormat generico predefinito.
GpStatus WINGDIPAPI GdipStringFormatGetGenericTypographic(GpStringFormat **format)	StringFormat* StringFormat::GenericTypographic()	Crea un oggetto StringFormat generico tipografico.
GpStatus WINGDIPAPI GdipDeleteStringFormat(GpStringFormat *format)	StringFormat::~StringFormat()	Rilascia le risorse utilizzate dall'oggetto StringFormat .
GpStatus WINGDIPAPI GdipCloneStringFormat(GDIPCONST GpStringFormat *format, GpStringFormat **newFormat)	StringFormat::StringFormat( IN const StringFormat *format )	Crea un oggetto StringFormat da un altro oggetto StringFormat .
GpStatus WINGDIPAPI GdipSetStringFormatFlags(GpStringFormat *format, flag INT)	Status StringFormat::SetFormatFlags(INT flags)	Imposta i flag di formato per questo oggetto StringFormat. I flag di formato determinano la maggior parte delle caratteristiche di un oggetto StringFormat .
GpStatus WINGDIPAPI GdipGetStringFormatFlags(GDIPCONST GpStringFormat *format, INT *flags)	INT StringFormat::GetFormatFlags() const	Ottiene i flag di formato stringa per questo oggetto StringFormat.
GpStatus WINGDIPAPI GdipSetStringFormatAlign(GpStringFormat *format, StringAlignment align)	Status StringFormat::SetAlignment(IN StringAlignment align)	Imposta l'allineamento della linea di questo oggetto StringFormat in relazione all'origine del rettangolo di layout. L'impostazione di allineamento della linea specifica come allineare la stringa verticalmente nel rettangolo di layout. Il rettangolo di layout viene usato per posizionare la stringa visualizzata.
GpStatus WINGDIPAPI GdipGetStringFormatAlign(GDIPCONST GpStringFormat *format, StringAlignment *align)	StringAlignment StringFormat::GetAlignment() const	Ottiene un elemento dell'enumerazione StringAlignment che indica l'allineamento dei caratteri di questo oggetto StringFormat in relazione all'origine del rettangolo di layout. Un rettangolo di layout viene usato per posizionare la stringa visualizzata.
GpStatus WINGDIPAPI GdipSetStringFormatLineAlign(GpStringFormat *format, StringAlignment align)	Status StringFormat::SetLineAlignment(IN StringAlignment align)	Imposta l'allineamento della linea di questo oggetto StringFormat in relazione all'origine del rettangolo di layout. L'impostazione di allineamento della linea specifica come allineare la stringa verticalmente nel rettangolo di layout. Il rettangolo di layout viene usato per posizionare la stringa visualizzata.
GpStatus WINGDIPAPI GdipGetStringFormatLineAlign(GDIPCONST GpStringFormat *format, StringAlignment *align)	StringAlignment StringFormat::GetLineAlignment() const	Ottiene un elemento dell'enumerazione StringAlignment che indica l'allineamento della riga di questo oggetto StringFormat in relazione all'origine del rettangolo di layout. L'impostazione di allineamento della linea specifica come allineare la stringa verticalmente nel rettangolo di layout. Il rettangolo di layout viene usato per posizionare la stringa visualizzata.
GpStatus WINGDIPAPI GdipSetStringFormatTrimming( GpStringFormat *format, StringTrimming trimming )	Status StringFormat::SetTrimming(IN StringTrimming trimming)	Imposta lo stile di taglio per questo oggetto StringFormat. Lo stile di taglio determina come tagliare una stringa in modo che si adatti al rettangolo di layout.
GpStatus WINGDIPAPI GdipGetStringFormatTrimming( GDIPCONST GpStringFormat *format, StringTrimming *trimming )	StringTrimming StringFormat::GetTrimming() const	Ottiene un elemento dell'enumerazione StringTrimming che indica lo stile di taglio di questo oggetto StringFormat. Lo stile di taglio determina come tagliare i caratteri da una stringa troppo grande per adattarsi al rettangolo di layout.
GpStatus WINGDIPAPI GdipSetStringFormatHotkeyPrefix(GpStringFormat *format, INT hotkeyPrefix)	Status StringFormat::SetHotkeyPrefix(IN HotkeyPrefix HotkeyPrefix)	Imposta il tipo di elaborazione che viene eseguito su una stringa quando viene rilevato il prefisso del tasto di scelta rapida, viene rilevata una e commerciale (&). L'e commerciale viene chiamato prefisso del tasto di scelta rapida e può essere usato per designare determinati tasti come tasti di scelta rapida.
GpStatus WINGDIPAPI GdipGetStringFormatHotkeyPrefix(GDIPCONST GpStringFormat *format, INT *hotkeyPrefix)	HotkeyPrefix StringFormat::GetHotkeyPrefix() const	Ottiene un elemento dell'enumerazione HotkeyPrefix che indica il tipo di elaborazione eseguito su una stringa quando viene rilevato un prefisso di tasto di scelta rapida, un e commerciale (&).
GpStatus WINGDIPAPI GdipSetStringFormatTabStops(GpStringFormat *format, REAL firstTabOffset, INT count, GDIPCONST REAL *tabStops)	Status StringFormat::SetTabStops( IN REAL firstTabOffset, IN INT count, IN const REAL *tabStops )	Imposta gli offset per le tabulazioni in questo oggetto StringFormat .
GpStatus WINGDIPAPI GdipGetStringFormatTabStops(GDIPCONST GpStringFormat *format, INT count, REAL *firstTabOffset, REAL *tabStops)	Status StringFormat::GetTabStops( INT count, OUT REAL *firstTabOffset, OUT REAL *tabStops ) const	Ottiene gli offset delle tabulazioni in questo oggetto StringFormat .
GpStatus WINGDIPAPI GdipGetStringFormatTabStopCount(GDIPCONST GpStringFormat *format, INT * count)	INT StringFormat::GetTabStopCount() const	Ottiene il numero di offset di tabulazione in questo oggetto StringFormat.
GpStatus WINGDIPAPI GdipSetStringFormatDigitSubstitution(GpStringFormat *format, LANGID language, StringDigitSubstitute substitute)	Status StringFormat::SetDigitSubstitution( IN LANGID language, IN StringDigitSubstitute substitute )	Imposta il metodo di sostituzione delle cifre e la lingua che corrisponde ai sostituti delle cifre.
GpStatus WINGDIPAPI GdipGetStringFormatDigitSubstitution(GDIPCONST GpStringFormat *format, LANGID *language, StringDigitSubstitute *substitute)	StringDigitSubstitute StringFormat::GetDigitSubstitutionMethod( ) const	ottiene un elemento dell'enumerazione StringDigitSubstitute che indica il metodo di sostituzione delle cifre utilizzato da questo oggetto StringFormat. Il parametro language nella funzione flat è un valore a 16 bit che specifica la lingua da usare.
GpStatus WINGDIPAPI GdipGetStringFormatMeasurableCharacterRangeCount( GDIPCONST GpStringFormat *format, INT *count )	INT StringFormat::GetMeasurableCharacterRangeCount()	ottiene il numero di intervalli di caratteri misurabili attualmente impostati. Gli intervalli di caratteri impostati possono essere misurati in una stringa usando il metodo Graphics::MeasureCharacterRanges.
GpStatus WINGDIPAPI GdipSetStringFormatMeasurableCharacterRanges( GpStringFormat *format, INT rangeCount, GDIPCONST CharacterRange *ranges )	Status StringFormat::SetMeasurableCharacterRanges( IN INT rangeCount, IN const CharacterRange *ranges )	Imposta una serie di intervalli di caratteri per questo oggetto StringFormat che, quando in una stringa, può essere misurata dal metodo Graphics::MeasureCharacterRanges.