Property Types

 Top  Previous  Next

boolean (Boolean)

User may choose between "true" and "false".

 

charset (Character Set)

User may choose a character set from a dropdown list

 

color (Color)

User enters color data directly or chooses from a color palette.

 

combo (Combo Box)

User either chooses an option from the list or types in another. Options are defined with options attribute. e.g. options="A,B,C"

 

csscode (CSS Code)

User enters CSS codes in a pop-up editor that highlights CSS reserved words.

 

datasource (Datasource)

User may enter directly a datasource name or uses the dialog that pops-up when [...] is clicked to select one.

 

dslist (Datasource List)

User may select a datasource from a datasource list of type in a datasource name.

 

dropdown (Dropdown List)

User must choose an option from the list. Options are defined with options attribute.

Example:

options="1,2,3"

 

elmselect (Element Select)

With this property type we can setup relations between the elements existing on a page. Using restr attribute we can define which types of elements can be selected as the value for this property.

Defining the value of restr attribute that is used together with elmselect property type requires special attention.

<prop name="abc" type="elmselect" restr="scope;elmtype"/>

 

scope

The scope of the elements to select. In other words this parameter is the path of the container element that in which the selectable elements reside. The definition can be relative i.e. "../Form1" or absolute "/Panel1/Form1".

elmtype

The type of the elements to select

 

Examples:

<prop name="abc" type="elmselect" restr="../..;SelectionBox"/>

 

This definition will let the users to select an element with type "SelectionBox" that exist in the parent of the parent of the current element.

<prop name="abc" type="elmselect" restr="@ProcessForm;ProcessDef"/>

 

This definition will let the users to select an element with type "ProcessDef" that exist in the closest parent of the current element who has the element type "ProcessForm".

 

file (File)

User may type in a file name or choose one from the File dialog. With restr attribute file selection can be filtered. e.g. restr="*.txt"

 

Example:

<prop name="propx" type="file" restr="*.xml;*.xsl"/>

 

 

font (Font)

User may choose a font from the font dialog that pops up.

 

fontfamily (Font Family)

User may choose a font-family from the combobox that lists the defined font-families or type in a new one.

 

htmlcode (HTML Code)

User enters HTML code in a pop-up editor that highlights HTML syntax.

 

imgfile (Image File)

Lets the user to choose an image file with a file dialog.

 

imgvariant (Image Variant)

This is a special kind of property type that is used in "Graphic Text" element and lets the user to define Image alternatives for the elemen

 

integer (Integer)

Accepts only integer number values.

 

embscript (Java Script)

User enters Java Script code in a pop-up editor that highlights Java Script reserved words.

 

 

lookup (Selecting elements that has specified element types)

This property type makes it possible to select the elements that have element types (via elmtype attribute) within the current page or within the project pages that have true in their "Enable LookUp" properties.

The usage of restr attribute of the lookup property

<prop name="abc" type="lookup" restr="element-type;search-definition;value-pattern;selection-method;columns"/>

 

element-type

The types of the elements to select from. The dialog that pops-up when the [...] button on the right side of the property in the property editor is clicked, shows the elements with this type existing in the current page or in the "LookUp Enabled" project pages.

One or more element types can specified.

Example:: RefreshableArea,SourceArea

If more that one element type should be specified and some of these types supposed to be selected only from the current page then these types must be prefixed with "*" characters.

Example: *RefreshableArea,SourceArea
 

search-definition

In search definition one or more of the following keywords can be used.

•*ps : The search is done in the current and "LookUp Enabled" project pages. "Definitions of this page only" checkbox is visible on the LookUp dialog. If not defined this checkbox becomes invisible.
•*co : The search is done only in the configuration pages (The pages that have "true" in their "Configuration Pages" properties)
•*un : Unique name. It is meaningful together with *ps keyword and causes that from the identically named elements the ones in the current page can only be selected.
•If search definition is not empty and contains none of the above keywords then the search is done in the current page only. The value of the search definition is the path of the element to start the search.

Examples:

*ps*co

In the current page, LookUp Enabled pages and configuration pages.

/

In the current page

/Header/Menu

In the "/Header/Menu" element of the current page.

../../

In the two-level outer element from the current element.

@ProcessForm

In the enclosing element that has the element type "ProcessForm".

value-pattern

When a selection is made by clicking on a listed element on the LookUp Dialog, the value of the property is assigned according to this pattern.

The special symbols that can be used in the value pattern are as follows:

%n

The name of the element

%e

The full name of the element

%i

The Html Id of the element

%p

The name of the page that the element is in

%f

The name of the enclosing process form.

 

selection-method

The following keywords can be used in the selection method definition.

•*ms : Multiple selection. To allow making multiple selection on the dialog.
•*as : Automatic selection. When the element is placed into the page a value is selected automatically if there is only one element in the list. If more than one element exist in the list then the dialog stays visible to force the user make a selection.

columns

The columns to display in the dialog is chosen automatically according to the value-pattern definition. The columns to display can be precisely determined by setting a value in this definition

Each column is represented with a specific character. By using "+" (display) or "-" (hide) before the characters the default column selection can be changed.

Columns:

n

The name of the element

e

The full name of the element

i

The Html Id of the element

p

The name of the page that the element is in

f

The name of the page that the element is in

u

Element location

Example:

-n-u+e  : Hide element name and element location. Display full name.

 

 

If CScript functions are used in the restr definitions, they are resolved before the definitions are evaluated.
Example:
restr="../;%vof(@ProcessForm/name != '' ? 'ProcessDef,')AjaxProcessDef"

 

 

language (Language)

User may choose a language from a dropdown list.

 

memoex (Memo)

User may enter data for this property directly in the property editor or click on [...] to open the Memo Editor.

 

note (Note)

Lets the use enter data in Notes editor.

 

pagelist (Page List)

Lets the user to choose a page from the combobox or enter a new one.

 

password (Password)

Used for password entry. The data is encrypted immediately .

 

proclist (Process List)

Lets the user to select a series of Process Definitions through the dialog that pops up. The scope for the elements and the type of the process definitions are given with restr attribute.

restr="scope;element-type"

 

scope: The scope of the elements to select

element-type: The type of the element to select

 

Example:

  <prop name="proclist" caption="Process List" type="proclist"
        restr="@ProcessForm/;ProcessDef"/>

 

 

 

propgroup (Property Group)

Used to group sub-properties.

 

sitelist (Site List)

Displays the list of the Sites existing in the project and lets the user make a selection.

 

sql (SQL)

User enters SQL code in a popup window

 

string (String)

Accepts string type data

 

xmldata (XML Data)

User enters XML in the popping-up editor that highlights XML Syntax.

 

xslcode (XSL Code)

User enters XSL code in the popping-up editor that highlights XML syntax and XSL instructions.

 

See Properties Exclusive to Library Elements.