WP SET VIEW PROPERTIES

Home

4D v19


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 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	visibleBackground	Displays both background images and background color (visible effect in Page or Embedded view mode only). Possible values: True/False
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:

 C_OBJECT($viewProps)

 $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)