User Tools

Site Tools


layout

Sometimes guiding a user may depend on the interface being configured according to a particular Layout. Prompting the user to change the layout is accomplished by defining an instruction of the layout type. The value of the type member is a String that represents the name of the layout to be selected. Success of a layout instruction is dependent on the specified layout actually existing - you can use the scripting API to ensure that a given layout exists.

The following example demonstrates how to prompt the user to apply the “City Limits Lite” layout:

Click the name of the example below to save it as a file.

Interactive_Lesson_Layout_Example.dsa
var oLessonMgr = MainWindow.getInteractiveLessonMgr();
oLessonMgr.begin([
	{
	"layout": "City Limits Lite",
	"info": [
		"<html><body><table width=400><tr><td>",
		"<h3 align='center'>Interface Layout</h3>",
		"<hr>",
		"This guide was written with a specific <em>layout</em> in mind. ",
		"Please change your workspace to the <b>City Limits Lite</b> layout to continue.",
		"<br/><br/>",
		"Changing the layout for your workspace can be accomplished by selecting the ",
		"<em>Window > Workspace > Select Layout...</em> action from the Main Menu.",
		"<br/><br/>",
		"Click <a href='http://docs.daz3d.com/doku.php/public/software/dazstudio/4/referenceguide/interface/layout/start'>here</a> for more information about layouts.",
		"</td></tr></table></body></html>"
		].join("")
	}
]);