DR MENU STATUS

version 6.0

DR MENU STATUS (area; command; checked; active; name)

Parameter	Type		Description
area	Longint		4D Draw area
command	Longint		Number of command
checked	Integer		0=Not checked
			1=Checked
active	Integer		0=Inactive
			1=Active
name	String		Name of menu item

The command DR MENU STATUS returns in the checked, active, and name variables information about the menu item in area represented by command.

The possible values for command are listed in Appendix F, Command Codes.

• If active equals 0, the menu item is disabled. If active equals 1, the menu item is enabled.

• If checked equals 0, the menu item is not checked. If checked equals 1, the menu item is checked. The menu items for which checked is meaningful are Reshape, Rotate, Actual Size, Fit to Window, Snap To Grid, and all items in the Display, Font, Size, Style, and Justification submenus. Checked also is meaningful for Show Values/Show References, even though neither has a check mark. If Show Values is displayed on the menu, then the document is currently displaying references in text objects and checked contains 0. If Show References is displayed on the menu, then the document is currently displaying values in text objects and checked contains 1.

• name is the text of the menu item.

The following example uses DR MENU STATUS to see if the grid is currently on.

   DR MENU STATUS (Area;6008;vChecked;vActive;vName)   `6008 is "Snap to Grid"
   If (vChecked=1)     `If grid is on
      vMessage := "The grid is on."    `Let the user know
   End if

DR DO COMMAND.