## siPPGControlType

### Description

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.

### C# Syntax

    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.

### Applies To

PPGItem.Type PPGLayout.AddEnumControl PPGLayout.AddItem PPGItem::GetType PPGItem::PutType PPGLayout::AddEnumControl PPGLayout::AddItem

### See Also

PPGLayout siPPGItemAttribute Property Page Controls Setting Control Attributes