Legacy Documentation: Version 4.6.2
Language: English
  • C#
  • JS
  • Boo

Script language

Select your preferred scripting language. All code snippets will be displayed in this language.

EditorGUILayout.BeginScrollView

Suggest a change

Success!

Thank you for helping us improve the quality of Unity Documentation. Although we cannot accept all submissions, we do read each suggested change from our users and will make updates where applicable.

Close

Sumbission failed

For some reason your suggested change could not be submitted. Please try again in a few minutes. And thank you for taking the time to help us improve the quality of Unity Documentation.

Close

Cancel

public static function BeginScrollView(scrollPosition: Vector2, params options: GUILayoutOption[]): Vector2;
public static Vector2 BeginScrollView(Vector2 scrollPosition, params GUILayoutOption[] options);
public static def BeginScrollView(scrollPosition as Vector2, *options as GUILayoutOption[]) as Vector2
public static function BeginScrollView(scrollPosition: Vector2, alwaysShowHorizontal: bool, alwaysShowVertical: bool, params options: GUILayoutOption[]): Vector2;
public static Vector2 BeginScrollView(Vector2 scrollPosition, bool alwaysShowHorizontal, bool alwaysShowVertical, params GUILayoutOption[] options);
public static def BeginScrollView(scrollPosition as Vector2, alwaysShowHorizontal as bool, alwaysShowVertical as bool, *options as GUILayoutOption[]) as Vector2
public static function BeginScrollView(scrollPosition: Vector2, horizontalScrollbar: GUIStyle, verticalScrollbar: GUIStyle, params options: GUILayoutOption[]): Vector2;
public static Vector2 BeginScrollView(Vector2 scrollPosition, GUIStyle horizontalScrollbar, GUIStyle verticalScrollbar, params GUILayoutOption[] options);
public static def BeginScrollView(scrollPosition as Vector2, horizontalScrollbar as GUIStyle, verticalScrollbar as GUIStyle, *options as GUILayoutOption[]) as Vector2
public static function BeginScrollView(scrollPosition: Vector2, alwaysShowHorizontal: bool, alwaysShowVertical: bool, horizontalScrollbar: GUIStyle, verticalScrollbar: GUIStyle, background: GUIStyle, params options: GUILayoutOption[]): Vector2;
public static Vector2 BeginScrollView(Vector2 scrollPosition, bool alwaysShowHorizontal, bool alwaysShowVertical, GUIStyle horizontalScrollbar, GUIStyle verticalScrollbar, GUIStyle background, params GUILayoutOption[] options);
public static def BeginScrollView(scrollPosition as Vector2, alwaysShowHorizontal as bool, alwaysShowVertical as bool, horizontalScrollbar as GUIStyle, verticalScrollbar as GUIStyle, background as GUIStyle, *options as GUILayoutOption[]) as Vector2

Parameters

scrollPosition The position to use display.
alwayShowHorizontal Optional parameter to always show the horizontal scrollbar. If false or left out, it is only shown when the content inside the ScrollView is wider than the scrollview itself.
alwayShowVertical Optional parameter to always show the vertical scrollbar. If false or left out, it is only shown when content inside the ScrollView is taller than the scrollview itself.
horizontalScrollbar Optional GUIStyle to use for the horizontal scrollbar. If left out, the horizontalScrollbar style from the current GUISkin is used.
verticalScrollbar Optional GUIStyle to use for the vertical scrollbar. If left out, the verticalScrollbar style from the current GUISkin is used.

Returns

Vector2 The modified scrollPosition. Feed this back into the variable you pass in, as shown in the example.

Description

Begin an automatically layouted scrollview.

These work just like GUILayout.BeginScrollView but feel more application-like and should be used in the editor


Label inside a scroll view.

	// Simple Editor Window that creates a scroll view with a Label inside
	
	class BeginEndScrollView extends EditorWindow {
	
		var scrollPos : Vector2;
		var t : String = "This is a string inside a Scroll view!";
	
		@MenuItem("Examples/Write text on ScrollView")
		static function Init() {
			var window = GetWindow(BeginEndScrollView);
			window.Show();
		}
	
		function OnGUI() {
			EditorGUILayout.BeginHorizontal();
				scrollPos = 
				EditorGUILayout.BeginScrollView(scrollPos, GUILayout.Width (100), GUILayout.Height (100));
					GUILayout.Label(t);
				EditorGUILayout.EndScrollView();
				if(GUILayout.Button("Add More Text", GUILayout.Width (100), GUILayout.Height (100)))
					t += " \nAnd this is more text!";
			EditorGUILayout.EndHorizontal();
			if(GUILayout.Button("Clear"))
				t = "";
		}
	}