文字列書式指定関数

Windows GDI+ は、約 600 個の関数で構成されるフラット API を公開します。これは、Gdiplus.dllで実装され、Gdiplusflat.h で宣言されています。 GDI+ フラット API の関数は、約 40 個の C++ クラスのコレクションによってラップされます。 フラット API で関数を直接呼び出さないでください。 GDI+ の呼び出しを行う場合は常に、C++ ラッパーによって提供されるメソッドと関数を呼び出して呼び出す必要があります。 Microsoft 製品サポート サービスは、フラット API を直接呼び出すコードのサポートを提供しません。 これらのラッパー メソッドの使用の詳細については、「 GDI+ Flat API」を参照してください。

次のフラット API 関数は 、StringFormat C++ クラスによってラップされます。

StringFormat 関数と対応するラッパー メソッド

フラット関数	Wrapper メソッド	解説
GpStatus WINGDIPAPI GdipCreateStringFormat( INT formatAttributes, LANGID language, GpStringFormat **format )	StringFormat::StringFormat( INT formatFlags = 0, IN LANGID language = LANG_NEUTRAL )	文字列書式フラグと言語に基づいて StringFormat オブジェクトを作成します。
GpStatus WINGDIPAPI GdipStringFormatGetGenericDefault(GpStringFormat **format)	StringFormat* StringFormat::GenericDefault()	汎用の既定の StringFormat オブジェクトを 作成します。
GpStatus WINGDIPAPI GdipStringFormatGetGenericTypographic(GpStringFormat **format)	StringFormat* StringFormat::GenericTypographic()	汎用の文字体裁 StringFormat オブジェクトを 作成します。
GpStatus WINGDIPAPI GdipDeleteStringFormat(GpStringFormat *format)	StringFormat::~StringFormat()	StringFormat オブジェクトで使用されるリソースを解放します。
GpStatus WINGDIPAPI GdipCloneStringFormat(GDIPCONST GpStringFormat *format, GpStringFormat **newFormat)	StringFormat::StringFormat( IN const StringFormat *format )	別の StringFormat オブジェクトから StringFormat オブジェクトを 作成します。
GpStatus WINGDIPAPI GdipSetStringFormatFlags(GpStringFormat *format, INT flags)	Status StringFormat::SetFormatFlags(INT flags)	この StringFormat オブジェクトの書式フラグを設定します。 書式フラグは 、StringFormat オブジェクトのほとんどの特性を決定します。
GpStatus WINGDIPAPI GdipGetStringFormatFlags(GDIPCONST GpStringFormat *format, INT *flags)	INT StringFormat::GetFormatFlags() const	この StringFormat オブジェクトの文字列書式フラグを取得します。
GpStatus WINGDIPAPI GdipSetStringFormatAlign(GpStringFormat *format, StringAlignment align)	Status StringFormat::SetAlignment(IN StringAlignment align)	レイアウト四角形の原点を基準にして、この StringFormat オブジェクトの線の配置を設定します。 線の配置設定では、レイアウトの四角形で文字列を垂直方向に配置する方法を指定します。 レイアウト四角形は、表示される文字列を配置するために使用されます。
GpStatus WINGDIPAPI GdipGetStringFormatAlign(GDIPCONST GpStringFormat *format, StringAlignment *align)	StringAlignment StringFormat::GetAlignment() const	レイアウト四角形の原点を基準にして、この StringFormat オブジェクトの文字の配置を示す StringAlignment 列挙体の要素を取得します。 レイアウト四角形を使用して、表示される文字列を配置します。
GpStatus WINGDIPAPI GdipSetStringFormatLineAlign(GpStringFormat *format, StringAlignment align)	Status StringFormat::SetLineAlignment(IN StringAlignment align)	レイアウト四角形の原点を基準にして、この StringFormat オブジェクトの線の配置を設定します。 線の配置設定では、レイアウトの四角形で文字列を垂直方向に配置する方法を指定します。 レイアウト四角形は、表示される文字列を配置するために使用されます。
GpStatus WINGDIPAPI GdipGetStringFormatLineAlign(GDIPCONST GpStringFormat *format, StringAlignment *align)	StringAlignment StringFormat::GetLineAlignment() const	レイアウト四角形の原点に対するこの StringFormat オブジェクトの線の配置を示す StringAlignment 列挙体の要素を取得します。 線の配置設定では、レイアウトの四角形で文字列を垂直方向に配置する方法を指定します。 レイアウト四角形は、表示される文字列を配置するために使用されます。
GpStatus WINGDIPAPI GdipSetStringFormatTrimming( GpStringFormat *format, StringTrimming トリミング )	Status StringFormat::SetTrimming(IN StringTrimming トリミング)	この StringFormat オブジェクトのトリミング スタイルを設定します。 トリミング スタイルは、レイアウトの四角形に収まるように文字列をトリミングする方法を決定します。
GpStatus WINGDIPAPI GdipGetStringFormatTrimming( GDIPCONST GpStringFormat *format, StringTrimming *トリミング )	StringTrimming StringFormat::GetTrimming() const	この StringFormat オブジェクトのトリミング スタイルを示す StringTrimming 列挙体の要素を取得します。 トリミング スタイルは、レイアウトの四角形に収まらない大きすぎる文字列から文字をトリミングする方法を決定します。
GpStatus WINGDIPAPI GdipSetStringFormatHotkeyPrefix(GpStringFormat *format, INT hotkeyPrefix)	Status StringFormat::SetHotkeyPrefix(IN HotkeyPrefix hotkeyPrefix)	ホット キー プレフィックスアンパサンド (&) が検出されたときに文字列に対して実行される処理の種類を設定します。 アンパサンドはホット キー プレフィックスと呼ばれ、特定のキーをホット キーとして指定するために使用できます。
GpStatus WINGDIPAPI GdipGetStringFormatHotkeyPrefix(GDIPCONST GpStringFormat *format, INT *hotkeyPrefix)	HotkeyPrefix StringFormat::GetHotkeyPrefix() const	ホット キー プレフィックスアンパサンド (&) が検出されたときに文字列に対して実行される処理の種類を示す HotkeyPrefix 列挙体の要素を取得します。
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 )	この 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	この StringFormat オブジェクトのタブ位置のオフセットを取得します。
GpStatus WINGDIPAPI GdipGetStringFormatTabStopCount(GDIPCONST GpStringFormat *format, INT * count)	INT StringFormat::GetTabStopCount() const	この StringFormat オブジェクトのタブ位置オフセットの数を取得します。
GpStatus WINGDIPAPI GdipSetStringFormatDigitSubstitution(GpStringFormat *format, LANGID 言語, StringDigit Substitute substitute)	Status StringFormat::SetDigitSubstitution( IN LANGID language, IN StringDigit Substitute substitute )	数字置換メソッドと、数字の置換に対応する言語を設定します。
GpStatus WINGDIPAPI GdipGetStringFormatDigitSubstitution(GDIPCONST GpStringFormat *format, LANGID *language, StringDigit Substitute *substitute)	StringDigitCondition StringFormat::GetDigitSubstitutionMethod( ) const	は、この StringFormat オブジェクトで使用される数字置換メソッドを示す StringDigit Substitution 列挙体の要素を取得します。 フラット関数の language パラメーターは、使用する言語を指定する 16 ビット値です。
GpStatus WINGDIPAPI GdipGetStringFormatMeasurableCharacterRangeCount( GDIPCONST GpStringFormat *format, INT *count )	INT StringFormat::GetMeasurableCharacterRangeCount()	は、現在設定されている測定可能な文字範囲の数を取得します。 設定された文字範囲は、 Graphics::MeasureCharacterRanges メソッドを使用して文字列内で測定できます。
GpStatus WINGDIPAPI GdipSetStringFormatMeasurableCharacterRanges( GpStringFormat *format, INT rangeCount, GDIPCONST CharacterRange *ranges )	Status StringFormat::SetMeasurableCharacterRanges( IN INT rangeCount, IN const CharacterRange *ranges )	この StringFormat オブジェクトの一連の文字範囲を設定します。文字列内の場合は、 Graphics::MeasureCharacterRanges メソッドで測定できます。