Previous Next

Displays a dialog window on the screen. You can use this window to ask the user interactively for information that your Blend script needs.

Returns embedded XML describing the runtime state of the dialog. See the "Return value" section.


     variable = "xpath >> (any)"
  [  variable = "xpath >> (any)" ... ]  >

The optional variable assignments can be used to catch user input. See the "Catching user input" section below.

The required embedded-xml describes the look and behaviour of the dialog you want to produce. For the concept, go to Embedded XML. You can code embedded-xml inline, or you can read it from a file, or you can have a different script section supply it.

To determine what a dialog looks like and what it does, your embedded XML should specify dialog controls. A dialog control is a screen element with a specific look and function. For aspects of visual appearance, such as position, size and colour, you can use visual attributes.


<example xmlns:pc="Processing.Command" xmlns:assign="Processing.Command.Assign" pc:hideme="true">
    <Form w="250">
      <Title>USoft Blend dialog</Title>
      <Label dx="5" dy="10" w="40" >This is a USoft Blend dialog.</Label>      
      <Button dy="20" newline="true"><Result>OK</Result>OK</Button>



collapseDialog controls
collapseVisual attributes
collapseCatching user input
collapseHiding password input
collapseReacting to button events
collapseReturn value



See also