Inserting an ADF Label Component

Working with ADF Desktop Integration Form-Type Components 6-3

5. Click OK.

If you want to add navigation buttons in your integrated Excel workbook to navigate to previous or next record, see Section 6.9, Using Navigation Buttons.

6.3 Inserting an ADF Label Component

The ADF Label component is a component that you can insert into the active worksheet to display a static string value. You specify a value in the input field for Label in the property inspector or alternatively you invoke the expression builder to write an EL expression that resolves to a string at runtime. The retrieved string can be Table 6–1 ADF Button component properties For this property... Specify... Label A string or an EL expression that resolves to a label at runtime to indicate the purpose of the ADF Button component. For example, the Label property for the Advanced Search button in the runtime EditPriceList-DT.xlsx workbook of the Master Price List module has the following value in design mode: {res[excel.advSearchButton.label]} This EL expression references a string key in the res resource bundle. For more information about resource bundles, see Section 10.2, Using Resource Bundles in an Integrated Excel Workbook. For more information about using labels in integrated Excel workbooks, see Section 9.4, Using Labels in an Integrated Excel Workbook. If you want to include the ampersand character in the label, you must use . A single character acts as a special character and is not displayed in the label. ClickActionSet Specify one or more actions in the Actions array of the ClickActionSet that the end user invokes when he or she clicks the ADF Button component. For more information about action sets, see Section 8.2, Using Action Sets. Notes: ■ If you change the view mode of the Excel worksheet to the Page Layout or Page Break mode, the ADF Button components may be rendered in an unexpected position. You must return back to Normal mode without saving the workbook, and then Run and stop the integrated Excel workbook to render the buttons to their original positions. ■ You can modify the properties of the component at a later time by selecting the cell in the worksheet that anchors the component and then displaying the property inspector. ■ The ADF Button components are active at 100 zoom only, and are disabled when the end user zooms in or out on an integrated Excel worksheet. Tip: In design mode, you can click the button, or press the spacebar when the button is in focus, to open the property inspector. The right-click context menu is disabled for a button. 6-4 Desktop Integration Developers Guide for Oracle Application Development Framework defined in a resource bundle or in an attribute control hint for an entity or view object. For example, the following EL expression resolves to the value of a string key defined in a resource bundle at runtime: {bindings.ProductList.label} The value that you specify for the Label property in an ADF Label component or other Oracle ADF components is evaluated after the worksheet that hosts the Oracle ADF component is initialized opened for the first time. You can configure a number of properties for the component, such as style and position, in the worksheet using the property inspector. Figure 6–2 shows an ADF Label component with its property inspector in the foreground. The ADF Label component references an EL expression that resolves to the value of a string key defined in the res resource bundle at runtime. Figure 6–2 ADF Label Component To insert an ADF Label component: 1. Open the integrated Excel workbook. 2. Select the cell in the Excel worksheet where you want to anchor the component.

3. In the components palette, select ADF Label and click Insert Component.

Alternatively, in the Oracle ADF tab, select ADF Label from the Insert Component dropdown list 4. Configure properties in the property inspector to determine the appearance, design, and layout of the component.

5. Click OK.

Note: You can modify the properties of the component at a later time by selecting the cell in the worksheet that anchors the component and then displaying the property inspector. You can also right-click in the cell and choose Edit Component from the context menu to open the property inspector. Working with ADF Desktop Integration Form-Type Components 6-5 For more information about using labels in an integrated Excel workbook, see Section 9.4, Using Labels in an Integrated Excel Workbook.

6.4 Inserting an ADF Input Text Component