Ensures that dlgitem is not active when window is open. An inactive dialog item does not respond to user activity such as key strokes and mouse clicks. If dlgitem does not refer to a list dialog item or a list tag (in outline lists), $ERROR is set and 0 is returned. Otherwise, 1 is returned.

The window parameter is a window identifier. dlgitem is the value of the control's id attribute.

Notes

Calling this function has the same effect as calling the dlgitem_set function on the ACTIVE attribute of the dialog item with a zero (0) value.

Any necessary display updates will be scheduled but not necessarily completed when this functions returns.

Example

Deactivates the Salary dialog item.