Version: Unity 6.0 (6000.0)
言語 : 日本語
GUI スキン (IMGUI)
IMGUI でエディターを拡張する

GUI Style (IMGUI)

Switch to Scripting

GUI Style (GUI スタイル) は、IMGUI で使用するためのカスタム属性の集合です。1 つの GUI スタイルは、IMGUI __コントロール__の外観を定義します。

Inspector の GUI スタイル
Inspector の GUI スタイル

スタイルを複数のコントロールに加えたい場合、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");
}


コードサンプルで作成された 2 つのボタン (1 つはスタイルあり)
コードサンプルで作成された 2 つのボタン (1 つはスタイルあり)

IMGUI の使用に関する詳細は、GUI スクリプティングガイドを参照してください。

GUIStyle

GUI スキン (IMGUI)
IMGUI でエディターを拡張する