peControlType - cCJMenuItem
Determines the type of the control (Button, Popup, combo, etc.)
Type: Property
Access: Read/Write
Data Type: Integer
Parameters: None
Syntax
Property Integer peControlType
| Access Type | Syntax |
|---|---|
| Read Access: | Get peControlType to IntegerVariable |
| Write Access: | Set peControlType to IntegerVariable/Value |
Description
peControlType allows you to set a menu or toolbar item's control type. This lets you specify that a control is a button (a normal menu/toolbar item), a popup, a split popup, a combo, etc. The following values are allowed:
| Constant | Meaning |
|---|---|
| xtpControlButton | Specifies the button control style. This is a normal commandbar button that is used in the menubar and toolbars. |
| xtpControlPopup | Specifies the popup control style. This is used for popup menus in menus and toolbars. When clicked, a popup menu will display any added controls. |
| xtpControlButtonPopup | Specifies the button popup control style. This will add a control that displays an image with no caption. When clicked, a popup menu will display any added controls. |
| xtpControlSplitButtonPopup | Specifies the split button popup control style. |
| xtpControlComboBox | Specifies the combobox control style. This will add a combobox control to your commandbar. |
| xtpControlEdit | Specifies the edit control style. This will add an edit box control to your commandbar. |
| xtpControlCustom | Specifies the custom control style. This allows you to add any control you want to your commandbar. For example, you can add a progress bar or slider control to your commandbar. |
| xtpControlLabel | Specifies the Label control style. This will add a control that is used for informational purposes only. This command will not respond to the mouse and cannot receive focus. The background will be displayed in a different color. You can use this to display helpful information about your popup menu. |
| xtpControlCheckBox | Specifies the checkbox control style. When using this style the control's checked property is used to determine whether the checkbox is checked or un-checked. |
| xtpControlGallery | Specifies the Gallery control style. Galleries can be placed in normal toolbars, popup menus, and ribbon groups. |
| xtpControlRadioButton | Specifies the Radio/Option button control style. This will add a Radio/Option button control to your commandbar. |
Default is xtpControlButton
The two most commonly used types are xtpControlButton and xtpControlPopup. You must always remember to specify a popup menu by setting peControlType to one of the popup menu types.
| Col 1 | Col 2 |
|---|---|
| Note: | This is a design-time only property. This property is applied when the COM control is created. You should not change this property after the control is created. Changing the property will have no effect on the existing control. |
See Also