DR GET PREFERENCES

version 6.0

DR GET PREFERENCES (area; order; pict; lockAlerts; autoScroll; variable; confirm; saveMethod)

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

The command DR GET PREFERENCES returns in the order, picts, lockAlerts, autoScroll, variable, confirm, and saveMethod variables, several parameters for area. These are the features 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 determines how PICT objects and documents are interpreted in area.

• If picts equals 0, opened, imported, or pasted Picts are interpreted as a single object.

• If picts equals 1, 4D Draw attempts to separate the PICT 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.

DR SET PREFERENCES.