ObjectDCL Banner

Form_GetRectangle Method

Description

This method returns a list indicating the left, top, width and height values of the dialog box.

Parameters

MyDialogReference
Reference to the dialog.
ProjectFile
String identifying the project as it was passed in LoadProject.
DialogName
String identifying the dialog by name.

Return Values

Returns the following according to the situation:

  • A list that specifies the left, top, width and height dimensions, all integers.
  • Nil if the control is not found.

AutoLISP Syntax

The recommended convention is passing the control identifier directly:

CopyCode imageCopy Code
(Odcl_Form_GetRectangle 
		MyDialogReference [as Reference])

An alternative convention is to identify the control by providing the project file, the dialog name and the control name:

CopyCode imageCopy Code
(Odcl_Form_GetRectangle
		ProjectFile [as String]
		DialogName [as String])

Applies For

Dockable, FileDialog, Modal, Modeless.

Example

CopyCode imageCopy Code
; Get the dimension of the dialog
(Setq rValue (Odcl_Form_GetRectangle MyProject_MyForm))

See Also

Form_GetHwnd, Form_GetControlArea, Form_GetTitleBarText,