Home
HCL Domino Designer XPages User Guide
This guide focuses on the aspects of creating applications using XPages technology.
Designing XPages applications
HCL Domino® Designer provides the means to populate an XPage with controls and other artifacts, and to associate an XPage with data stores.
Adding controls from the XPages Extension Library
The XPages Extension Library provides additional controls ready to use. The controls include an application layout object, an improved dialog, pickers, in place forms, Dojo components, dynamic content, and much more. The controls support enhancements to the Domino(r)® templates.
@Functions (Extension Library)
Specified here are the XPages Extension Library @functions.
@ViewIconUrl (JavaScript)
Returns the relative path to a view icon.

HCL Domino Designer XPages User Guide
This guide focuses on the aspects of creating applications using XPages technology.
- Product overview
  HCL Domino® Designer supports applications development for the HCL Domino platform using XPages, forms, views, and other elements such as controls.
- Tutorials
  This section contains tutorials and information about tutorials.
- Administering applications
  HCL Domino Designer provides features for administering and managing your work and related files while developing your application projects.
- Designing XPages applications
  HCL Domino® Designer provides the means to populate an XPage with controls and other artifacts, and to associate an XPage with data stores.
  - Previewing and running XPages
    XPages run in Domino® server and Notes® client environments. From Domino Designer, you can preview XPages in both environments.
  - Adding controls
    Controls are visual elements such as edit boxes, buttons, images, and text that allow users to manipulate data on an XPage.
  - Adding controls from the XPages Extension Library
    The XPages Extension Library provides additional controls ready to use. The controls include an application layout object, an improved dialog, pickers, in place forms, Dojo components, dynamic content, and much more. The controls support enhancements to the Domino(r)® templates.
    - Using controls from the XPages Extension Library
      Here are guidelines for using some of the controls in the XPages Extension Library.
    - Using templates from the XPages Extension Library
      Extended versions of the discussion and team room templates are provided.
    - @Functions (Extension Library)
      Specified here are the XPages Extension Library @functions.
      - @AbsoluteUrl (JavaScript)
        Generates a prefix for a URL for a Domino® resource.
      - @EncodeUrl (JavaScript)
        Adds any necessary attributes to a Domino® URL, such as a session identifier or parameters.
      - @ErrorMessage (JavaScript)
        Posts a message to a message (Display Error) or messages (Display Errors) control.
      - @FullUrl (JavaScript)
        Generates the path of a Domino® resource relative to the server.
      - @InfoMessage (JavaScript)
        Posts a message to a message (Display Error) or messages (Display Errors) control.
      - @IsAbsoluteUrl (JavaScript)
        Specifies whether a resource name is an absolute URL.
      - @NormalizeSubject (JavaScript)
        Normalizes empty and lengthy text.
      - @TopParentID (JavaScript)
        Returns the Notes® identifier of the top parent of a document.
      - @TopParentUNID (JavaScript)
        Returns the universal identifier of the top parent of a document.
      - @ViewIconUrl (JavaScript)
        Returns the relative path to a view icon.
      - @WarningMessage (JavaScript)
        Posts a message to a message (Display Error) or messages (Display Errors) control.
    - Simple actions (Extension Library)
      Specified here are the XPages Extension Library simple actions.
    - Control reference (Extension Library)
      Specified here are the XPages Extension Library controls.
    - Property reference (Extension Library)
      Specified here are the XPages Extension Library properties.
  - Binding and submitting data
    The data store for XPages is Domino®. You can access the data store through Domino forms and views.
  - Adding images, styles, and themes
    You can enhance your design with images, styles, and themes.
  - Responsive web design support in XPages
    The XPages Extension Library supports Bootstrap, a Responsive Web Design (RWD) framework. This support comes in the form of an XPages Responsive Bootstrap plugin that you can use in your XPages applications.
- Designing composite applications
  You can create composite applications from XPages.
- Programming
  XPages uses JavaScript™ for programming while the forms-based design elements use the formula language, LotusScript®, Java™, and JavaScript.

@ViewIconUrl (JavaScript)

Returns the relative path to a view icon.

Defined in

Syntax

@ViewIconUrl(icon:int) : string

Table 1. Parameters
Parameter	Description
`icon:int`	The number of the icon. If there is no corresponding icon, 999 is used.

Table 2. Return value
Value	Description
`string`	The path to the icon.

Usage

For a view column that displays icons by an identifying number:

The icons are in domino\icons under the Domino® or Notes® data directory. In XPages, this directory can be accessed with the URL /.ibmxspres/domino/icons.
The icons are named vwicn001.gif, vwicn002.gif, and so on.

Examples

Here an image control displays the view icon /.ibmxspres/domino/icons/vwicn002.gif.

<xp:image url="#{javascript:@ViewIconUrl(2)}" id="image2" alt="folder icon"></xp:image>