PowerTools PlusPak for Windows Forms 8.0J
文字の配置と特殊効果

本項ではGcButton コントロールの文字の配置や特殊効果について解説します。

GcButton コントロールの外観
GcButton コントロールは、Visual Studio 標準のボタンコントロールの機能に加えて、文字の均等割付や方向の回転など高度な機能を追加しました。これらの機能はTextAppearanceプロパティを使って設定できます。

TextAppearanceの値 説明
OrientationTextAppearance 文字を均等割付、または縦方向に表示します。
RotationTextAppearance 文字を均等割付、または方向を回転して表示します。
文字の縦表示と均等割付
文字を縦表示にするには、OrientationTextAppearanceTextOrientationプロパティを使って設定できます。TextOrientation プロパティに設定可能な値は次の通りです。

TextOrientationの値 説明 外観
Horizontal 文字を水平方向に配置します。
Downward 文字を上から下へと配置します。
Upward 文字を下から上へと配置します。
VerticalFarEast 文字を縦方向に配置します。
HorizontalRotatedFarEast 日本語文字を90度回転して水平方向に配置します。

文字を均等割付に配置するには、OrientationTextAppearance のTextHorizontalAdjustmentプロパティをDistributed (均等割付)か、または DistributedWithSpace (両端にスペースを残した均等割付)に設定します。


均等割付(Distributed)


スペース入りの均等割付(DistributedWithSpace)


下記は、ボタンの文字を縦方向のスペース入りの均等割付に設定するサンプルコードです。
Imports GrapeCity.Win.Buttons

' 文字の表示スタイルを作成します。
Dim OrientationTextAppearance1 As New OrientationTextAppearance

' スペース入りの均等割付と縦表示を設定します。
OrientationTextAppearance1.TextHorizontalAdjustment = TextAdjustment.DistributeWithSpace
OrientationTextAppearance1.TextOrientation = GrapeCity.Win.Common.TextOrientation.VerticalFarEast

' スタイルをボタンに設定します。
GcButton1.TextAppearance = OrientationTextAppearance1
using GrapeCity.Win.Buttons;

// 文字の表示スタイルを作成します。
OrientationTextAppearance OrientationTextAppearance1 = new OrientationTextAppearance();

// スペース入りの均等割付と縦表示を設定します。
OrientationTextAppearance1.TextHorizontalAdjustment = TextAdjustment.DistributeWithSpace;
OrientationTextAppearance1.TextOrientation = GrapeCity.Win.Common.TextOrientation.VerticalFarEast;

// スタイルをボタンに設定します。
gcButton1.TextAppearance = OrientationTextAppearance1;
文字の回転
文字を回転するには、RotationTextAppearanceを使用します。回転の角度はAngleプロパティで設定します。設定可能な範囲は -90 〜 90 です。

Imports GrapeCity.Win.Buttons

' 文字の表示スタイルを作成します。
Dim RotationTextAppearance1 As New RotationTextAppearance

' スペース入りの均等割付と30度の回転を設定します。
RotationTextAppearance1.Angle = 30
RotationTextAppearance1.TextHorizontalAdjustment = TextAdjustment.DistributeWithSpace
RotationTextAppearance1.TextVerticalAdjustment = TextAdjustment.None

' スタイルをボタンに設定します。
GcButton1.TextAppearance = RotationTextAppearance1
using GrapeCity.Win.Buttons;

// 文字の表示スタイルを作成します。
RotationTextAppearance RotationTextAppearance1 = new RotationTextAppearance();

// スペース入りの均等割付と30度の回転を設定します。
RotationTextAppearance1.Angle = 30;
RotationTextAppearance1.TextHorizontalAdjustment = TextAdjustment.DistributeWithSpace;
RotationTextAppearance1.TextVerticalAdjustment = TextAdjustment.None;

// スタイルをボタンに設定します。
gcButton1.TextAppearance = RotationTextAppearance1;
文字の立体表示
OrientationTextAppearance のTextEffectプロパティや RotationTextAppearance のTextEffectプロパティで文字を立体的に表示することができます。立体表示には Inset(強いくぼみ)、InsetLite(軽いくぼみ)、Raised(強い浮き出し)、RaisedLite(軽い浮き出し)があります。

TextEffectの値 説明 外観
Flat テキストを3D効果なしで描画します。
Inset テキストは強くくぼんで表示されます。
Raised テキストは強く浮き出して表示されます。
InsetLite テキストは軽くくぼんで表示されます。
RaisedLite テキストは軽く浮き出して表示されます。

下記のサンプルコードは、文字の強いくぼみを設定します。

Imports GrapeCity.Win.Buttons

' 文字の表示スタイルを作成します。
Dim OrientationTextAppearance1 As New OrientationTextAppearance

' 強いくぼみ表示を設定します。
OrientationTextAppearance1.TextEffect = GrapeCity.Win.Common.TextEffect.InsetLite

' スタイルをボタンに設定します。
GcButton1.TextAppearance = OrientationTextAppearance1
using GrapeCity.Win.Buttons;

// 文字の表示スタイルを作成します。
OrientationTextAppearance OrientationTextAppearance1 = new OrientationTextAppearance();

// 強いくぼみ表示を設定します。
OrientationTextAppearance1.TextEffect = GrapeCity.Win.Common.TextEffect.InsetLite;

// スタイルをボタンに設定します。
gcButton1.TextAppearance = OrientationTextAppearance1;

参照