4D Doc Center : WR SET AREA PROPERTY

Home

4D Write v14

WR SET AREA PROPERTY


WR SET AREA PROPERTY ( area ; option ; value ; stringValue )

Parameter	Type	Description
area	Longint	4D Write area
option	Integer	Option number
value	Integer	Depends on the option
stringValue	String	String for the property, depending on the option

Description

The WR SET AREA PROPERTY command allows you to modify the value of option for the 4D Write area referenced by area.

If area equals 0, the WR SET AREA PROPERTY command will apply to each 4D Write area that is opened subsequently. In this case, it is recommended that your code should call this command in the On Startup Database Method.
In option, pass one of the constants of the “WR Area properties” theme. You can also use the constants of the “WR Parameters” theme to set the values. A description of each constant and its corresponding values are found below.

The stringValue parameter can be used with the wr window title and wr minimized button title properties.

Constant	Type	Value	Comment
wr confirm dialog	Longint	0	Gets or sets the display status of the confirm dialog box: wr no dialog (0), wr display dialog (1)
wr save preview	Longint	1	Gets or sets the picture preview creation: wr no picture preview (0), wr picture preview creation (1)
wr allow undo	Longint	2	Gets or sets the buffering of actions: wr no undo (0) = actions not stored, wr undo allowed (1) = actions are stored
wr modified	Longint	3	Gets or sets the dirty bit status— except if area = 0: wr dirty bit status false (0), wr dirty bit status true (1)
wr fixed print size	Longint	4	Gets or sets the variable size printing status — except if area = 0: wr var size printing status (0), wr fixed size printing status (1)
wr convert dialog	Longint	5	Gets or sets the display status of the 4D Write 6.0 field conversion dialog — if area = 0: wr no dialog (0), wr display dialog (1)
wr minimized button title	Longint	6	Gets or sets the button title when area is minimized: wr area name (0), wr custom title (1) passed in stringValue
wr window title	Longint	7	Gets or sets the 4D Write Window title when going to full screen or in external window (0=area name, 1=custom title passed in stringValue)
wr minimum width	Longint	8	Gets or sets the minimum area width before switching to button (value in pixels)
wr minimum height	Longint	9	Gets or sets the minimum area height before switching to button (value in pixels)
wr save template on server	Longint	10	Gets or sets where to save the templates in C/S: wr on client (0), wr on server (1)
wr load template on server	Longint	11	Gets or sets where to load the templates from in C/S: wr on client (0), wr on server (1)
wr convert by token	Longint	12	Gets or sets the interpretation of the field references during document conversion: wr convert by names (0), wr convert by numbers (1)
wr zoom factor	Longint	13	Gets or sets the percentage of the zoom in area (value=25 to 500)
wr allow drag	Longint	14	Gets or sets the drag authorization from area (0=drag not allowed, 1=drag allowed)
wr allow drop	Longint	15	Gets or sets the drop authorization to area (0=drop not allowed, 1=drop allowed)
wr on the fly spellchecking	Longint	16	Gets or sets the spellchecking “as you type” mode activation (0=checking off, 1=checking on)
wr timer frequency	Longint	17	Gets or sets the frequency that the wr on timer event is generated (value=call frequency in ticks —one tick = 1/60th of a second — 3600 by default)
wr use saved zoom value	Longint	18	Gets or sets the opening an area with the zoom value saved when the area was last closed: wr use default zoom (0) = 100 %, wr use saved zoom (1)

Example 1

You want to disable the automatic picture preview of the area, the display of the confirm dialog and the Undo command from the Edit menu:

 WR SET AREA PROPERTY(Area;wr save preview;wr no picture preview)

 WR SET AREA PROPERTY(Area;wr confirm dialog;wr no dialog)

 WR SET AREA PROPERTY(Area;wr allow undo;wr no undo)

Example 2

You want to open 4D Write version 6.x documents using table and field numbers instead of names. Thus, if a field name has been modified after the v6 document was saved, no error will occur when opening the document. To do so, execute the following statement:

WR SET AREA PROPERTY(0;wr convert by token;wr convert by numbers)