GUI Style (GUI スタイル) は、IMGUI で使用するためのカスタム属性の集合です。1 つの GUI スタイルは、IMGUI __コントロール__の外観を定義します。
スタイルを複数のコントロールに加えたい場合、GUI スタイルの代わりに、GUI スキンを使用します。IMGUI の詳細については、GUI スクリプティングガイドを参照してください。
ノート: このページでは、スクリプティングのみの UI システムである IMGUI システムの一部について説明します。Unity には、完全にゲームオブジェクトベースの UI システムが用意されており、必要に応じて使用できます。ゲームオブジェクトベースの UI システムでは、ユーザーインターフェースの要素を可視のオブジェクトとしてシーンビューで設計したり、編集したりすることができます。詳細については、UI システムマニュアルを参照してください。
| プロパティ: | 機能: |
|---|---|
| 名前 | この特定のスタイルを参照するためのテキスト文字列。 |
| Normal | デフォルト状態のコントロールの背景画像とテキスト色。 |
| Hover | コントロールにマウスカーソルを合わせたときの背景画像とテキスト色。 |
| アクティブ | コントロールをクリックしたときの背景画像とテキスト色。 |
| Focused | コントロールにキーボードフォーカスを合わせたときの背景画像とテキスト色。 |
| On Normal | コントロールが有効な状態にあるときの背景画像とテキスト色。 |
| On Hover | 有効なコントロールにマウスカーソルを合わせたときの背景画像とテキスト色。 |
| On Active | 有効なコントロールをクリックしたときのプロパティ。 |
| On Focused | 有効なコントロールにキーボードフォーカスを合わせたときの背景画像とテキスト色。 |
| ボーダー | コントロールの形状のスケールによって影響されない__背景__画像の各辺のピクセル数。 |
| パディング | コントロールの各端からコンテンツの開始点までのスペース (単位ピクセル)。 |
| マージン | このスタイルでレンダリングされる要素とその他の GUI コントロールとの間の余白。 |
| Overflow | 背景画像に追加される余分のスペース。 |
| Font | このスタイルですべてのテキストに使用されるフォント。 |
| Image Position | 背景画像とテキストの結合のされ方。 |
| Alignment | 標準のテキスト整列オプション。 |
| Word Wrap | 有効にすると、コントロールの境界に達したテキストが次の行に折り返されます。 |
| Text Clipping | Word Wrap が有効の場合、 コントロールの境界を超えたテキストの処理方法を選択します。 |
| __Overflow__ | コントロールの境界を超えたテキストは境界を超えても表示されます。 |
| __クリップ__ | コントロールの境界を超えたテキストは非表示になります。 |
| Content Offset | その他のプロパティに加え、X 軸と Y 軸に沿ってコンテンツが移動されるピクセル数。 |
| __X__ | 左/右のオフセット。 |
| __サポート__ | 上/下のオフセット。 |
| Fixed Width | コントロールの幅のピクセル数で、与えられたいかなる Rect() 値も無効にします。 |
| Fixed Height | コントロールの高さのピクセル数で、与えられたいかなる Rect() 値も無効にします。 |
| Stretch Width | 有効にすると、このスタイルを使用するコントロールが水平に引き伸ばされ、レイアウトが改善されます。 |
| Stretch Height | 有効にすると、このスタイルを使用するコントロールが垂直に引き伸ばされ、レイアウトが改善されます。 |
GUIStyle は、スクリプトから宣言され、インスタンスごとに修正されます。カスタムスタイルで 1 つまたは 2–3 のコントロールを使用したい場合、スクリプトでこのスタイルを宣言し、Control 関数の引数としてそのスタイルを渡します。このようにすると、定義したスタイルでコントロールを表示できます。
まず、スクリプトで GUI スタイルを宣言する必要があります。
/* Declare a GUI Style */
var customGuiStyle : GUIStyle;
...
ゲームオブジェクトにこのスクリプトをアタッチすると、Inspector に修正可能なカスタムスタイルが表示されます。
このスタイルを特定のコントロールに対して使用させたい場合に、関数の最後の引数に、スタイルの名前を渡します。
...
function OnGUI () {
// Provide the name of the Style as the final argument to use it
GUILayout.Button ("I am a custom-styled Button", customGuiStyle);
// If you do not want to apply the Style, do not provide the name
GUILayout.Button ("I am a normal IMGUI Button without custom style");
}
IMGUI の使用に関する詳細は、GUI スクリプティングガイドを参照してください。
GUIStyle