Form

Form

The Control

Category: Containers Type: pf.Form
The root (top-level) container of every control in Openous. It is the first element created by default when you select to customize a SharePoint form for a list or document library. The Form Control exposes all necessary methods for programmatically applying your rules and business logic to your Openous implementation.



Actions

When the Form Control is selected in the Central pane, the Actions section on the ribbon is updated to display the following items:
Move Up This action is applicable to controls that are immediate children of Container Controls. When pressed, it moves the selected control above its current position (shifting the above control below it).
Move Down This action is applicable to controls that are immediate children of Container Controls. When pressed, it moves the selected control below its current position (shifting the below control above it).

Events

Occurs before form deserialization begins.
Args: (form: pf.Form, args: pf.IFormDefinitionLoadedArgs): any
Occurs before the form is deserialized and instanciated.
Args: (form: pf.Form, args: pf.IEventArgs)
Occurs when the control's value is being evaluated
Args: (form: pf.Form, args: pf.IEventArgs)
Occurs after the form is deserialized and instanciated.
Args: (form: pf.Form, args: pf.IEventArgs)
Occurs after OnLoadCompleted (formula evaluations, visibility/enabled formulas are completed)
Args: (form: pf.Form, args: pf.IEventArgs)
Occurs after OnFormDeserialized
Args: (form: pf.Form, args: pf.IEventArgs)
Occurs after OnFormInitializing (Includes are loaded, Control Events are handled)
Args: (form: pf.Form, args: pf.IEventArgs)
Occurs when the control is resized.
Args: (form: pf.Form, args: pf.IEventArgs)
Occurs during form validation. Code should return an array of errors (Field, Type, Control, Message}
Args: (form: pf.Form, args: pf.IValidationArgs): any
Occurs after the Value of a control has changed.
Args: (form: pf.Form, args: pf.IValueChangedEventArgs)
This event is being called, each time the user changes the value.
Args: (form: pf.Form, args: pf.IValueChangedEventArgs)
Occurs before the Value of a control changes. You can cancel the change by setting args.Cancel to true.
Args: (form: pf.Form, args: pf.IValueChangingEventArgs)
Occurs after the value provider retrieved data for this control.
Args: (form: pf.Form, args: pf.IEventArgs)

Properties

Appearance

Gets or sets a color that describes the background of a control
The CSS Clear Property specifies what elements can float beside the cleared element and on which side.
The float CSS property places an element on the left or right side of its container, allowing text and inline elements to wrap around it.
Changes the font weight of the control, to either regular when not selected or bold when selected.
This font-style property allows you to make text appear italicized (i.e. sloped, or slanted)
Changes the font size of the control.
Sets the foreground color of the control.
The text-align property specifies the horizontal alignment of the text displayed
Sets what will be displayed in a tooltip when the user hovers over the control.

Behavior

Gets or sets if the ValueChange event triggers the ValueChange event of the parent form.
Specifies whether this control should be disabled when form is offline.
Specifies whether this control should be hidden when form is offline.
Specifies whether this control is required when form is offline.
Specifies whether this control is required when form is offline.
Sets the item visible or not during initialization

Data Binding

This is a free text field, where one can enter comments or other notes. Comments are only visible in the designer.
Gets or sets the code that returns the default value for this control.
The name which will hold the control's stored value
Allows you to change the value returned by the control (when GetValue() is called).
Allows you to change the value set to the actual control (when SetValue(value) is called).

Layout

Sets the margin applied to the control, that is, the spacing between the control and the cell borders.
Sets the maximum height.
Sets the maximum width.
Sets the minimum height.
Sets the minimum width.
Sets the padding of the control

Miscellaneous

Specify the conditions under which the control will be enabled/disabled.
Specify the conditions under which the control will be visible/hidden