Add Widget

From InstallJammer Wiki

The Add Widget action will add a new widget to an install pane. Widgets are any type of control that is drawn on a pane, which includes: buttons, checkbuttons, labels, radiobuttons and more. This action is supported on all platforms.

Contents 1 Standard Properties 2 Advanced Properties 2.1 Action 2.2 Background 2.3 Browse Type 2.4 Checked 2.5 Foreground 2.6 Label Side 2.7 Label Width 2.8 Off Value 2.9 On Value 2.10 Height 2.11 Text 2.12 Type 2.13 Value 2.14 Virtual Text 2.15 Width 2.16 X 2.17 Y 3 Text Properties 3.1 Text

[edit] Standard Properties

See Standard Action Properties.

[edit] Advanced Properties

[edit] Action

This property specifies an action that should be executed if the user clicks a button or modifies the value of a checkbutton or radiobutton. It does nothing for any other type of widget.

[edit] Background

The background color of the new widget. The most common are system, which is the main system color for the background of windows, and white.

[edit] Browse Type

If the widget is a browse entry, this property specifies what you are browsing for. A directory will use a choose directory dialog. An open file will use a file dialog that is expecting a file that already exists. A save file will use a file dialog that will tell the user the file will be overwritten if it already exists.

[edit] Checked

When adding a radiobutton or checkbutton, this property tells InstallJammer that the button should be checked on by default when displayed. If this property is left blank, the status of the button will depend on the virtual text property attached to it. In the case of a checkbutton, if the virtual text property is true, the checkbutton will be checked. In the case of a radiobutton, the radiobutton whose value matches the current value of the virtual text will be checked.

[edit] Foreground

The foreground color of the new widget. The most common are system, which is the main system color for the foreground text of windows, and black.

[edit] Label Side

On any widget that is not a label, setting the Text property will cause a label to be drawn with the corresponding widget. This property tells InstallJammer where you want the label to appear in relation to the widget. The choices are on top or to the left.

[edit] Label Width

This property specifies the width of the text label when it is present next to another widget. Using this property with your label on the left side, you can make all of your labels line up evenly by giving them all the same width.

[edit] Off Value

This is the value the virtual text will be set to when a checkbutton is off. This is only valid for checkbuttons.

[edit] On Value

This is the value the virtual text will be set to when a checkbutton is on. This is only valid for checkbuttons.

[edit] Height

The height of the widget. Usually, this option should be left blank, and InstallJammer will make the widget as tall as it needs to be.

[edit] Text

If the widget type is a label, the text property specifies what should be displayed in the label. If the widget is not a label, setting the text property to any string will cause a label to be drawn with the given widget.

[edit] Type

The type of widget to add. The list currently includes: browse entry, button, checkbutton, entry, label, label frame, password entry, radiobutton or text.

[edit] Value

For a radiobutton, this is the value stored in the virtual text when this radiobutton is selected. Please read the section titled Boolean Values in Virtual Text in What is Virtual Text? for information on using boolean-type values as a value for a radiobutton.

Setting the value on an entry or browse entry will set the default value of the virtual text to the given value,
which will make the value appear in the entry box.

[edit] Virtual Text

The virtual text variable to store the result in. Radiobuttons are grouped together by all sharing the same virtual text variable. The selected radiobutton will set the value of the virtual text.

[edit] Width

The width of the widget. If this option is left blank, InstallJammer will make the widget as wide as it needs to be.

[edit] X

The x coordinate on the pane to place this widget.

[edit] Y

The y coordinate on the pane to place this widget.

[edit] Text Properties

[edit] Text

Setting the text on any widget type other than a label will cause a label to be drawn in combination with the specified widget. This is the easiest way to add a label with a widget rather than having to add a separate label widget.