MESCIUS InputMan for Windows Forms 12.0J
外観の設定

キャラクタボックスコントロールでは、外観について下記の項目をカスタマイズできます。

マス目のスタイル

コントロール内に表示するマス目のスタイルは、CharBoxオブジェクトのStyle プロパティで設定できます。
CharBoxオブジェクトは、CharBoxes プロパティが参照するコレクション内に保持されているマス目です。


(図)Style プロパティによるスタイル

マス目の配置

コントロール内に配置するマス目の位置は次の4つのプロパティを使って、ピクセル単位で位置を調整することができます。


また、コントロール内に表示されるマス目は、コントロールのContentAlignment プロパティを使って配置を設定することができます。


マス目内のデータ入力領域はCharBox クラスのContentAlignment プロパティで配置を設定します。

マス目のサイズ

マス目のサイズは、CharBox クラスのSize プロパティを使用して高さと幅をピクセル単位で設定することができます。また、CharBox クラスのAutoSize プロパティをTrueに設定すると、マス目のサイズはフォントの大きさに応じて自動で設定されます。

マス目の境界線と色

CharBox クラスのBorder プロパティが参照するCharBoxBorder オブジェクトを使用することで、マス目の上下左右それぞれ個別に枠の色と線種を設定することができます。 CharBoxBorder オブジェクトは、マス目の境界線の四辺を表すプロパティ(BottomTopLeftRight プロパティ)を持ちます。各境界線はLine クラスを参照しています。

状態ごとの外観

キャラクタボックスコントロールでは、以下の状態についてそれぞれ文字色と背景色を設定することが可能です。

状態 プロパティ
フォーカスを持っている ActiveBackColorActiveForeColor
無効(EnabledプロパティがFalse) DisabledBackColorDisabledForeColor
読み取り専用(ReadOnlyプロパティがTrue) ReadOnlyBackColorReadOnlyForeColor

次のサンプルコードは、コントロールがフォーカスを取得したときの背景色および文字色を設定する例です。

' フォーカス取得時の背景色を設定します。
GcCharMask1.ActiveBackColor = Color.Yellow
' 背景色の適用範囲を指定します。
GcCharMask1.ActiveBackColorArea = GrapeCity.Win.Editors.ActiveBackColorArea.Control
' フォーカス取得時の文字色を設定します。
GcCharMask1.ActiveForeColor = Color.Blue
// フォーカス取得時の背景色を設定します。
gcCharMask1.ActiveBackColor = Color.Yellow;
// 背景色の適用範囲を指定します。
gcCharMask1.ActiveBackColorArea = GrapeCity.Win.Editors.ActiveBackColorArea.Control;
// フォーカス取得時の文字色を設定します。
gcCharMask1.ActiveForeColor = Color.Blue;
スタイル

FlatStyle プロパティを使用すると、コントロールの外観のスタイルを変更することができます。

FlatStyleの値 説明 外観
Flat フラットに(平面的に)表示されます。
Popup マウスポインタをボタン上に移動すると外観がフラットから3Dに変わります。
Standard 3Dで(立体的に)表示されます。
System オペレーティングシステムによって決定されます。
ActiveFlat Office XP形式のフラットスタイルが適用されます。
Professional ToolStripに適用される視覚スタイルが適用されます。
Office2007Blue Office2007Blue形式のスタイルが適用されます。
Office2007Black Office2007Black形式のスタイルが適用されます。
Office2007Silver Office2007Silver形式のスタイルが適用されます。
Office2021DarkGray Office2021DarkGray形式のスタイルが適用されます。
Office2021Black Office2021Black形式のスタイルが適用されます。
Office2021White Office2021White形式のスタイルが適用されます。

FlatStyle プロパティの値が、Flat、PopUp、Standard、Systemのときは、BorderStyle プロパティを使用して境界線のスタイル変更することができます。
また、BorderStyle プロパティがFixedSingle のときは、SingleBorderColor プロパティを使用して境界線の色を設定することができます。

関連トピック

 

 


© MESCIUS inc. All rights reserved.