WP SET VIEW PROPERTIES
WP SET VIEW PROPERTIES ( {* ;} wpArea ; wpViewProps )
| Parameter | Type | Description | |
|---|---|---|---|
| * | Operator | 🡒 | If specified, wpArea is a form object name (string). If omitted, wpArea is an object field or variable (document) |
| wpArea | String, Object | 🡒 | Form object name (if * is specified) or 4D Write Pro object variable or field (if * is omitted) |
| wpViewProps | Object | 🡒 | View properties to modify |
Description
The WP SET VIEW PROPERTIES command allows you to dynamically set one or more view properties of the 4D Write Pro wpArea area.
If you pass the optional * parameter, you indicate that wpArea is a form object name (string). If you do not pass this parameter, you indicate that wpArea is a 4D Write Pro document (object variable or field). This command can only be used if the wpArea is associated with a form object (i.e. it is displayed in the form), on any form page. If the 4D Write Pro document is displayed in several form objects, it is necessary to use the * parameter to define which view to set.
In wpViewProps, pass an object wherein each property is a view property that you want to modify in the 4D Write Pro area. View properties that are not included in the wpViewProps object will keep their previous values. You can use the following constants:
| Constant | Value | Comment |
|---|---|---|
| wk display formula as symbol | displayFormulaAsSymbol | Displays formula references as a  symbol. Works only if formulas are displayed as references (see wk visible references). Possible values: True/False |
| wk formula highlight | formulaHighlight | Formula highlight view mode. Possible values: wk references (default): Formulas displayed as references are highlighted wk values: Formulas displayed as values are highlighted wk always: Formulas are always highlighted, whatever their display mode wk never: Formulas are never highlighted, whatever their display mode Highlighted formula color can be set by wk formula highlight color. |
| wk formula highlight color | formulaHighlightColor | Color of highlighted formulas (see wk formula highlight). Possible values: a CSS color string ("#010101" or "#FFFFFF" or "red"). a 4D color longint value |
| wk page view mode | pageMode | Mode for displaying the 4D Write Pro document in the form area onscreen. Possible values (string): "draft": draft mode with basic document properties "page": most complete view mode, which includes page outlines, orientation, margins, breaks, headers and footers, etc. "embedded": view mode suitable for embedded areas |
| wk resolution | dpi | Screen resolution for the contents of the 4D Write Pro area. Possible values: wk auto (0) Number greater than 1 |
| wk spell enable | spellEnabled | Enables the auto spellcheck. Possible values: True/False |
| wk visible background and anchored elements | visibleBackground | Displays or exports background images/color, anchored images and text boxes (for display, visible effect in Page or Embedded view mode only). Possible values: True/False |
| wk visible empty images | visibleEmptyImages | Displays or exports a default black rectangle for images that cannot be loaded or computed (empty images or images in an unsupported format). Possible values: True/False. Default value: True If value is False, missing image elements will not be displayed at all even if they have borders, width, height, or background; this may impact the page layout for inline images. |
| wk visible footers | visibleFooters | Displays or exports the footers (for display, visible effect in Page view mode only). Possible values: True/False |
| wk visible headers | visibleHeaders | Displays or exports the headers (for display, visible effect in Page view mode only). Possible values: True/False |
| wk visible hidden characters | visibleHiddenChars | Displays invisible characters. Possible values: True/False |
| wk visible horizontal ruler | visibleHorizontalRuler | Displays the horizontal ruler. Possible values: True/False |
| wk visible HTML WYSIWYG | htmlWYSIWIGEnabled | Enables the HTML WYSIWYG view by removing proprietary 4D Write Pro HTML/CSS tags. Possible values: True/False |
| wk visible page frames | visiblePageFrames | Displays the page frames (visible effect in Page view mode only). Possible values: True/False |
| wk visible references | visibleReferences | Displays or exports all 4D expressions inserted in the document as references. Possible values: True/False |
| wk visible vertical ruler | visibleVerticalRuler | Displays the vertical ruler (visible effect in Page view mode only). Possible values: True/False |
| wk zoom | zoom | Zoom percentage for displaying the contents of the 4D Write Pro area. Possible values: Number greater than 1 |
All properties can be modified at any moment, but some are only taken into account if a compatible 4D Write Pro display mode is used. Therefore, even if a view property is modified, there may be no visible effect in the current display mode.
Note: For more information about view properties, please refer to the Defining a 4D Write Pro area page.
Once view properties have been set for wpArea using this command, they are applied while the form area is used as long as they are not modified by another call. The property modifications are not saved with the document or the form.
Example
You want to set some view properties for a 4D Write Pro area:
var $viewProps : Object
$viewProps:=New object
$viewProps[wk page view mode]:="page"
// or $viewProps.pageMode="page"
$viewProps[wk visible horizontal ruler]:=True
// or $viewProps.visibleHorizontalRuler:=True
$viewProps[wk visible vertical ruler]:=True
// or $viewProps.visibleVerticalRuler:=True
WP SET VIEW PROPERTIES(*;"4DWPArea";$viewProps)