Windows GDI+ は、約 600 個の関数で構成されるフラット API を公開しています。これは、Gdiplus.dll で実装され、Gdiplusflat.h で宣言されています。 GDI+ フラット API の関数は、約 40 個の C++ クラスのコレクションによってラップされます。 フラット API で関数を直接呼び出さないでください。 GDI+ を呼び出す場合は常に、C++ ラッパーによって提供されるメソッドと関数を呼び出すことで行う必要があります。 Microsoft 製品サポート サービスは、フラット API を直接呼び出すコードのサポートを提供しません。 これらのラッパー メソッドの使用方法の詳細については、「GDI+ Flat API を参照してください。
次のフラット API 関数は、StringFormat C++ クラスによってラップされます。
StringFormat 関数と対応するラッパー メソッド
| フラット関数 | ラッパー メソッド | 備考 |
|---|---|---|
| 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) |
状態 StringFormat::SetFormatFlags(INT フラグ) |
この 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 トリミング ) |
状態 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) |
StringDigit置換 StringFormat::GetDigitSubstitutionMethod( ) const |
この StringFormat オブジェクトで使用される桁置換メソッドを示す、StringDigit Substitution 列挙体の要素を取得します。 フラット関数の 言語 パラメーターは、使用する言語を指定する 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 ) |
文字列内の場合、Graphics::MeasureCharacterRanges メソッドで測定できる、この StringFormat オブジェクトの一連の文字範囲を設定します。 |