Tutorial: EqualContainer - Expose the New Container in the Design Wizard

Finally, add the example EqualContainer component to the S60 UI Design wizard.

Attributes

Define this attribute so that the wizard presents the container on the main page.

<attributes>
   <attribute  key="is-initial-content">true</attribute>
</attributes>

CCoeControl defines the attribute “is-top-level-content”, which our container inherits. This means the wizard will make this the root of the design (except for CAknView, if that option is enabled).

If this attribute is not set, then the UI design wizard iterates all available containers and invokes the IQueryContainment interface to find which ones will accept this content. This defines the choices available in the Containers dropdown on the near-last wizard page.

Component Image and Description

A thumbnail image for the content selection page of the UI design wizard is needed, though you may omit this to display a blank box for your component.

<designerImages
 …
thumbnailFile="EqualContainer_tn.png"/>

A description of the component is also required. The localized string (%information) is provided in the EqualContainer.properties file.

<documentation>
  …
  <wizardDescription>%information</wizardDescription>
</documentation>

Select Custom Component Project

To add the custom container to the UI Design wizard, select Components > Select Custom Component Projects... and check the project you created for the EqualContainer example files. Click Ok and the UI Designer will add the custom container to the S60 UI Design wizard; accessible by choosing File > New > S60 UI Design.

Step 5 of 5

Create UI Design for UI Designer Project