Legacy Documentation: Version 4.5.0

Script language:

  • JS
  • C#
  • Boo
Script language

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

EditorUtility.DisplayDialog

static function DisplayDialog(title: string, message: string, ok: string, cancel: string = ""): bool;
static bool DisplayDialog(string title, string message, string ok, string cancel = "");
static def DisplayDialog(title as string, message as string, ok as string, cancel as string = "") as bool

Parameters

titleThe title of the message box.
messageThe text of the message.
okLabel displayed on the OK dialog button.
cancelLabel displayed on the Cancel dialog button.

Description

Displays a modal dialog.

Use it for displaying message boxes in the editor.

cancel and cancel are labels to be displayed on the dialog buttons. If cancel is empty (the default), then only one button is displayed. DisplayDialog returns true if ok button is pressed.

See Also: DisplayDialogComplex function.


Dialog box that shows info on the number of objects to be placed on the surface.

	// C# Example
	// Places the selected Objects on the surface of a terrain.

using UnityEngine; using UnityEditor;

public class PlaceSelectionOnSurface : ScriptableObject { [MenuItem ("Example/Place Selection On Surface")] static void CreateWizard () { Transform[] transforms = Selection.GetTransforms(SelectionMode.Deep | SelectionMode.ExcludePrefab | SelectionMode.Editable);

if (transforms.Length > 0 && EditorUtility.DisplayDialog("Place Selection On Surface?", "Are you sure you want to place " + transforms.Length + " on the surface?", "Place", "Do Not Place")) { foreach (Transform transform in transforms) { RaycastHit hit; if (Physics.Raycast(transform.position, -Vector3.up, out hit)) { transform.position = hit.point; Vector3 randomized = Random.onUnitSphere; randomized = new Vector3(randomized.x, 0F, randomized.z); transform.rotation = Quaternion.LookRotation(randomized, hit.normal); } } } } }