Adding UI controls to editable areas in custom controls

Add controls to editable areas in the custom control. You can set properties for these controls in the Properties view, just as you would set properties for any other controls that you add to XPages. You can also change the facet name of controls in editable areas if you are computing the value at run time.

Before you begin

Note: A green-circle image in the editable area means that you have not added a UI control to the editable area yet. As soon as you add a UI control, the image disappears.

To add UI controls to editable areas in custom controls, do the following steps:

Procedure

  1. Open the XPage that contains the custom control.
  2. Place your cursor inside the editable area in the custom control.
  3. Click Create > Other, Create > Core Control, Create > Container Control, or Create > Custom Control and select a UI control.
  4. If you are computing the value of the editable area at run time, then continue inserting UI controls into the editable area until you are finished.
  5. For each UI control, click the Facet tab in the Properties view and type the name of the facet in the Facet Name field.
    • If the facet name of the editable area is static (not computed), then the UI control has the same facet name by default. If you change the facet name, the UI control will not display in the editable area at run time.
    • If the facet name is computed, change the facet name to meet the conditions of the script you wrote to compute the value of the editable area's facet name at run time.
  6. Click File > Save to save your changes.

What to do next

You can also add UI controls to editable areas by dragging them from the Controls palette and dropping them onto the editable area, on either the Source tab or the Design tab.