

Managing control‐related data and for creating associated help for each control.įrom the script side, the interaction between the user and the dialog box is viewed as a series of events. Along with definition functions forĮach control, scripts can provide functions for defining and managing the dialog box layout, as well as functions for Scripting provides a rich set of predefined controls for use in custom dialog boxes. Process information contained in the dialog box as well as facilitating data entry into the dialog box. The dialog box layout provides a logical structure for the controls, allowing the user to quickly

Interactive feedback for the user which guides and informs them as they interact with the dialog box.Ĭontrols are organized within the dialog box by means of a dialog box layout, which positions and orients theĬontrols for display. Quickly enter data and define complex combinations of settings for a given task. Once the user understands these simple concepts, it becomes easy for the user to Using in creating custom dialog boxes for your scripts.Įvery custom dialog box is comprised of dialog box controls, items which accept user input of one kind or another.ĭialog box controls are designed using easily understood metaphors which allow the user to quickly comprehend These dialog boxes use the same underlying concepts that you will be Whose interface is tailored to a specific task (such as creating a layer or setting document scale) and which provideįeedback based on the data you have entered. Using Vectorworks software, you have probably encountered dialog boxes Order to do this, dialog boxes need to be able accept data entry (in various formats) and provide meaningful Custom Dialog Box Conceptsĭialog box interfaces are a means of retrieving information from the user for use by the script during execution. These functions are referred to as “Classic Dialogs” in the Function Reference. For a limited time, Vectorworks will continue to support existing scripts which may use the previous dialog box system. It is sometimes referred to as the “Modern Dialog” system or the “Layout Manager” dialog system. The custom dialog system that was introduced with Vectorworks 8.x is covered here.
Vectorworks viewer show navigation pane how to#
The section also addresses the use of external resource files for storing image and string dataĪnd how to use them in creating custom dialog boxes.

Topics discussed in this section include the dialog box control components, dialog box definition and layout, as well as All theĬomponents required to build and manage dialog boxes for handling complex data entry and user interaction are ScriptingĪllows up to 32 dialog boxes per script, which create sophisticated interfaces for menu commands and tools. (up to 10,000 controls per dialog box) in layouts that can be tailored to meet your specific interface needs. Scripts may create dialog boxes using any combination of controls Predefined dialog boxes available in the language. Scripting provides the custom dialog box API for scripts whose interface needs may exceed what is provided by the More complex dialog boxes can have the appearance of an alert with the Standard Icon control.(See VS:User_Interface#Standard Icon ). See the Function Reference for aĬomplete list of these predefined alert functions. To enter a string and the function PtDialog allows the user to enter a point value. For example, the function StrDialog allows the user There are several functions that allow the user to enter values. Response := YNDialog( 'Do you wish to continue?') For example:ĪlrtDialog( 'You must select an object first.') Īnother predefined alert will display a string which is typically a question, and provide “Yes” and “No” buttons: User’s attention before he or she can continue. With one function call the script can easily present a modal alert dialog box which requires the To notify the user of an error condition, provide a warning, or ask for confirmation, a script can use one of the several Since it is a palette, not an alert, it does not This feature can be used for status or progress information. The function takes multiple arguments, and will concatenate the pieces A script can call the “Message()” function toĭisplay one line of information to the user. The “Script Message” palette is another simple user interface feature. Identifies the plug‐in by name (and an additional short description) when the user hovers the cursor over a tool icon or The simplest user interface feature that script plug‐ins should support is Help Tags or Tool Tips. These features, and then describes Custom Dialog boxes in detail. Include Help Tags, Tool Tips, Messages, Predefined Alerts, and Custom Dialog boxes. There are several ways to present a scripted user interface to display or gather information from the user.

