## Controls Components

The Controls components includes components related to the SDK used for the current project. Depending on the SDK used with a project, components may include the following:

- Button - used in toolbar, status pane, and touch pane. The button can also be placed in a Basic container (CCoeControl) of a ui design. It can contain text or image, or both. To add a Button component into a Toolbar, first add the Toolbar component and select it in the design. Buttons can be observed through MCoeControlObserver observer interface. If the button has an icon, the same icon can be used for both pressed and non-pressed states, however for dimmed state another icon is recommended. If a dimmed icon is not provided one is generated automatically from the non-pressed state’s icon. A 30% transparency is applied to the icon.
- Binary Popup Setting Item
- Choice List - used in popup lists, toolbars, and virtual keyboard, and can be shown as a button (via property setting). Choice list items can be added either dynamically or from resource structure. Choice List component must show current selection if it is part of a Toolbar; and must also add array items in property settings.
- Image - an image widget
- Label - a label control
- List Box - a list that maps to the baisc S60 list boxes
- List Box Item - the content of a single item in a list control
- Popup Field Text - popups a selection list
- Slider - graphically displays a bounded value
- Toolbar - adds a toolbar for buttons, text items, and/or Choice List
- Volume Setting Item - volume control

Figure 1 - The Controls subsection of the Palette Pane of the UI Design Editor

NOTE Components visible in the palette are related to what is allowed in the current UI design container. Click the palette filter button to toggle between all components and those allowed in current container.

##### Related references

- UI Design Editor
- Toolbar Pane
- Layout Pane
- Non-layout Pane
- Component Palette Pane
- Component Information Pane
- Edit Multi-Image Property Dialog