Specifies the different types of controls (i.e. widgets) supported on a Softimage Property Page. Controls on a Property Page usually display and control the value of a Parameter on an inspected object.
StringModule.siControlBitmap // BitmapWidget StringModule.siControlBoolean // Boolean StringModule.siControlButton // commandbutton StringModule.siControlCheck // Check StringModule.siControlCombo // Combo StringModule.siControlEdit // edit StringModule.siControlFCurve // FCurveWidget StringModule.siControlFilePath // FilePath StringModule.siControlFolder // Folder StringModule.siControlGradient // gradient StringModule.siControlGrid // GridWidget StringModule.siControlIconList // IconList StringModule.siControlImageClip // ImageClipWidget StringModule.siControlListBox // ListBox StringModule.siControlNumber // Number StringModule.siControlRadio // Radio StringModule.siControlRGB // RGB StringModule.siControlRGBA // RGBA StringModule.siControlStatic // Static StringModule.siControlString // String StringModule.siControlSynoptic // SynopticWidget StringModule.siControlTextEditor // TextEditorWidget StringModule.siControlTextureSpace // TextureSpaceItem.TextureSpaceItem.1 |
| Constant | Value | Description |
|---|---|---|
| siControlBitmap | BitmapWidget |
A static bitmap control. The control needs to be associated with a
real parameter on the inspected object, but the value is neither read nor changed. This control is often used
for displaying a logo. The path is specified using siUIFilePath. For more
information, see the Bitmap Widget
topic.
For Image Clip control, use the siControlImageClip control. |
| siControlBoolean | Boolean | A simple check box. This is the default control for Boolean parameters. For more information, see the Check Box topic. |
| siControlButton | commandbutton |
A button is a special kind of control which is not associated with any
parameter of the inspected object. See PPGLayout.AddButton.
Supported attributes are siUICX and siUICY. For more information, see the Command Button topic. |
| siControlCheck | Check | Bitfield control, showing separate check boxes for each item in the PPGItem.UIItems list. The value of the parameter will be equal to the sum of all the checked items. This control is useful for packing many flags into a single integer while still having a convenient user interface to set or view which flags have been set. For more information, see the Bitfield topic. |
| siControlCombo | Combo |
A read-only edit control, with a drop down menu showing items out of the
PPGItem.UIItems list.
Supported attributes are siUICX and siUICY. For more information, see the Combo/Drop-Down Box topic. |
| siControlEdit | Edit | An edit box control. It is similar to siControlString, however it supports the siUICX, siUICY and siUIStyle attributes and is used as a multi-line string edit box. For more information, see the Multi-line Text topic. |
| siControlFCurve | FCurveWidget |
A control for displaying an FCurve (see
PPGLayout.AddFCurve).
Supported optional attributes are siUICX, siUICY, siUIFCurveLabelX, siUIFCurveLabelY, siUIFCurveViewMinX, siUIFCurveViewMaxX, siUIFCurveViewMinY, siUIFCurveViewMaxY, siUIFCurveGridSpaceX, siUIFCurveGridSpaceY, siUIFCurveNoGrid, siUIFCurveNoRulerX, and siUIFCurveNoRulerY. For more information, see the FCurve Widget topic. |
| siControlFilePath | FilePath |
A control for driving a string Parameter containing a file name. The control
provides an edit box and a button that launches a file browser (similar to XSIUIToolkit.FileBrowser).
Supported attributes are siUIFileFilter, siUIInitialDir, siUISubFolder, siUIAudioFile, siUIImageFile, siUIOpenFile, siUIFileMustExist, siUIStyle. For more information, see the File Browser Widget topic. |
| siControlFolder | Folder |
A control for driving a string Parameter with an edit box and a button that
launches a directory picker.
Supported attributes are siUIInitialDir and siUISubFolder. For more information, see the Folder Widget topic. |
| siControlGradient | gradient | A control that shows a fully featured gradient editor. |
| siControlGrid | GridWidget |
A control of type GridWidget which displays the data from
a GridData object. It shows a multi-column list control, similar to a spreadsheet. See
CustomProperty.AddGridParameter.
Supported optional attributes are siUICX, siUICY, siUIGridColumnWidths, siUIGridLockColumnHeader, siUIGridLockRowHeader, siUIGridHideColumnHeader, siUIGridReadOnlyColumns, siUIGridHideRowHeader and siUIGridSelectionMode. For more information, see the GridData Widget topic. Note: This control has no relationship to the geometric shape called a "Grid". |
| siControlIconList | IconList |
Similar to a siControlRadio, except each
item is represented by a bitmap on the screen rather than by a text label. Only .bmp files are supported, and the
filenames of these files are specified in the PPGItem.UIItems list.
Supported attributes are siUIColumnCnt, siUILineCnt, siUIColumnGap, siUILineGap, siUISelectionColor, and siUIUseSelectionIcon. For more information, see the Icon Buttons topic. |
| siControlImageClip | ImageClipWidget |
A control that shows an Image Clip. You use this control with a
string parameter whose value is the Image Clip full name.
Supported attribute is siUIShowClip. For static bitmap control, use the siControlBitmap control. |
| siControlListBox | ListBox |
This control is functionally similar to
siControlRadio and siControlCombo in that it
shows a list of possible items. However, unlike those other controls, you have the option to use the ListBox in a
multi-selection mode by using the attribute siUIMultiSelectionListBox.
The siUICX and siUICY attributes can be set to change the size. If no siUIStyle attribute is assigned and the list is too large to fit, the ListBox will display a vertical scroll bar. For more information, see the List Box topic. |
| siControlNumber | Number |
A numeric control, normally with both an edit control and a slider. This is the
default control for all numeric parameters.
Supported attributes are siUICX, siUICY, siUISyncSlider, siUILogarithmic, siUIDecimals, siUINoSlider, siUITreadmill and siUIThumbWheel. For more information, see the Numeric Edit Box with Slider topic. |
| siControlRadio | Radio | Radio control, allowing you to select a single item out of the PPGItem.UIItems list. This is the same behavior as the siControlCombo control, except that all the options are displayed on the screen. Hence a Combo box is best suited for large lists of items. For more information, see the Radio Buttons topic. |
| siControlRGB | RBG | A Color control with no "Alpha" channel. This control is associated with three parameters in the underlying object. See PPGLayout.AddColor. For more information, see the RGB Color Control topic. |
| siControlRGBA | RBGA | A Color control that includes the "Alpha" channel. This control is associated with four parameters in the underlying object. See PPGLayout.AddColor. For more information, see the RGBA Color Control topic. |
| siControlStatic | Static |
Static text on the property page, see PPGLayout.AddStaticText.
If the PPGItem.Name of the associated item is "Static" the PPGItem.Label will be
displayed as the static text. Otherwise the name is assumed to refer to an actual string Parameter
and its value is shown.
Tip: To break the text onto multiple lines, include line return characters in the text (vbCrLf in vbscript and "\n" in JScript). Supported attributes are siUICX and siUICY. For more information, see the Static Text topic. |
| siControlString | String |
A single line edit box for displaying text. This is the default control for
String parameters.
Supported attributes are siUICX and siUICY. For multi-line strings use the siControlEdit instead. For more information, see the Single-line Text topic. |
| siControlSynoptic | SynopticWidget | A control that shows a synoptic view. You use this control with a string parameter whose value is the full path to the synoptic file. The size of the synoptic view determines the size of the control. For an example of the synoptic control, see the PPGDemos example. For more information, see the Synoptic Widget topic. |
| siControlTextEditor | TextEditorWidget | A control that shows a full-featured text editor. You use this control with a string parameter whose value will be set to the text in the editor. For more information, see the Text Editor Widget topic. |
| siControlTextureSpace | TextureSpaceItem.TextureSpaceItem.1 | A control that shows a texture space combo box. |
PPGItem.Type PPGLayout.AddEnumControl PPGLayout.AddItem PPGItem::GetType PPGItem::PutType PPGLayout::AddEnumControl PPGLayout::AddItem