GUI Style

GUI Styles are a collection of custom attributes for use with UnityGUI. A single GUI Style defines the appearance of a single UnityGUI Control.


A GUI Style in the Inspector

If you want to add style to more than one control, use a GUI Skin instead of a GUI Style. For more information about UnityGUI, please read the GUI Scripting Guide.

Properties

NameThe text string that can be used to refer to this specific Style
NormalBackground image & Text Color of the Control in default state
HoverBackground image & Text Color when the mouse is positioned over the Control
ActiveBackground image & Text Color when the mouse is actively clicking the Control
FocusedBackground image & Text Color when the Control has keyboard focus
On NormalBackground image & Text Color of the Control in enabled state
On HoverBackground image & Text Color when the mouse is positioned over the enabled Control
On ActiveProperties when the mouse is actively clicking the enabled Control
On FocusedBackground image & Text Color when the enabled Control has keyboard focus
BorderNumber of pixels on each side of the Background image that are not affected by the scale of the Control' shape
PaddingSpace in pixels from each edge of the Control to the start of its contents.
MarginThe margins between elements rendered in this style and any other GUI Controls.
OverflowExtra space to be added to the background image.
FontThe Font used for all text in this style
Image PositionThe way the background image and text are combined.
AlignmentStandard text alignment options.
Word WrapIf enabled, text that reaches the boundaries of the Control will wrap around to the next line
Text ClippingIf Word Wrap is enabled, choose how to handle text that exceeds the boundaries of the Control
OverflowAny text that exceeds the Control boundaries will continue beyond the boundaries
ClipAny text that exceeds the Control boundaries will be hidden
Content OffsetNumber of pixels along X and Y axes that the Content will be displaced in addition to all other properties
XLeft/Right Offset
YUp/Down Offset
Fixed WidthNumber of pixels for the width of the Control, which will override any provided Rect() value
Fixed HeightNumber of pixels for the height of the Control, which will override any provided Rect() value
Stretch WidthIf enabled, Controls using this style can be stretched horizontally for a better layout.
Stretch HeightIf enabled, Controls using this style can be stretched vertically for a better layout.

Details

GUIStyles are declared from scripts and modified on a per-instance basis. If you want to use a single or few Controls with a custom Style, you can declare this custom Style in the script and provide the Style as an argument of the Control function. This will make these Controls appear with the Style that you define.

First, you must declare a GUI Style from within a script.

/* Declare a GUI Style */
var customGuiStyle : GUIStyle;

...

When you attach this script to a GameObject, you will see the custom Style available to modify in the Inspector.


A Style declared in a script can be modified in each instance of the script

Now, when you want to tell a particular Control to use this Style, you provide the name of the Style as the last argument in the Control function.

...

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 UnityGUI Button without custom style");
}

Two Buttons, one with Style, as created by the code example

For more information about using UnityGUI, please read the GUI Scripting Guide.

Page last updated: 2007-10-01