DR SET PREFERENCES

version 6.0

DR SET PREFERENCES (area; order; picts; lockAlerts; autoScroll; variable; confirm{; saveMethod})

Parameter	Type		Description
area	Longint		4D Draw area
order	Integer		Print direction
picts	Integer		0=Picture
			1=Objects
			-1=No change
lockAlerts	Integer		0=Off
			1=On
			-1=No change
autoScroll	Integer		0=Off
			1=On
			-1=No change
variable	Integer		0=Fixed
			1=Variable
			-1=No change
confirm	Integer		0=Without confirmation
			1=With confirmation
			-1=No change
saveMethod	Integer		0=Picture and data
			1=Picture only
			2=Data only
			-1=No change

The command DR SET PREFERENCES sets several functional parameters for area, which correspond to the features that can be set in the Preferences dialog box.

order sets the order in which pages in a multipage document print when area is printed.

• If order equals 0, pages print from top to bottom, then left to right.

• If order equals 1, pages print from left to right, then top to bottom.

The default is to print pages left to right.

picts controls how PICT objects and documents are interpreted in area when they are opened, imported, or pasted.

• If picts equals 0, the PICT document or pasted PICT object is interpreted as a single object.

• If picts equals 1, 4D Draw tries to break the PICT object into its component objects.

The default option is to paste a PICT drawing as a single picture.

lockAlerts determines whether area displays an alert when a user tries to alter a locked attribute.

• If lockAlerts equals 0, no alert is presented.

• If lockAlerts equals 1, the alert is displayed.

The default is to display the alert.

autoScroll determines whether the document in area scrolls automatically when the user drags past the area boundary.

• If autoScroll equals 0, auto scrolling is turned off.

• If autoScroll equals 1, auto scrolling is turned on.

The default is to use auto-scrolling.

variable determines whether area prints using the print variable frame option.

• If variable equals 0, area prints the same size as it was defined and only those objects in the upper left corner of the document are included.

• If variable equals 1, area expands vertically to print all objects on the left side of the document.

The default is to print with a variable frame.

The confirm parameter determines if a confirmation dialog box appears when you accept a record that contains a non-autosaved 4D Draw area. By default, a confirmation dialog box appears, asking whether or not you would like to save the document in the 4D Draw area.

• If confirm equals 0, the confirmation dialog box does not appear.

• If confirm equals 1, the confirmation dialog box appears.

The optional saveMethod parameter controls how the document in the 4D Draw area is saved.

• If saveMethod equals 0, the default value, both the picture and the internal data used to rebuild the image are saved.

• If saveMethod equals 1, only the picture (PICT) is saved. Objects can no longer be manipulated individually.

• If saveMethod equals 2, only the data concerning the objects in the 4D Draw area is saved. The image is later rebuilt using the information in the saved data. This save option is the quickest and uses the least amount of memory. If there is not enough memory for the save method chosen, a dialog box that allows you to choose another method appears.

The following example turns off the display options, locked alerts, and auto scrolling for area in the On load event of a form method, without affecting the printing:

   If (Form event=On load)
      DR DISPLAY OPTIONS (Area;-1;0)
      DR SET PREFERENCES (Area;-1;-1;0;0;-1;-1;-1)
   End if

DR GET PREFERENCES.