DEACTIVATE

7.8.5, PLBCMP GUI Only

The DEACTIVATE instruction hides the object from the user. The instruction uses the following format:

[label]

DEACTIVATE

{object}

Where:

label

Optional. A Program Execution Label.

object

Required. A previously defined and created object or object pointer that is deactivated.

Flags Affected: NONE

Supported objects:

ANIMATE	EDITDATETIME	LISTVIEW	RADIO	TIMER
BUTTON	EDITNUMBER	MAINWINDOW	RADIOGRP	TOOLBAR
CHECKBOX	EDITTEXT	MENU	RICHEDITTEXT	TREEVIEW
CHECKGRP	FLOATMENU	MOVIE	SHAPE	VSCROLLBAR
COLLECTION	GROUPBOX	MREGION	SLIDER	WINDOW
COMBOBOX	HSCROLLBAR	NETCONTROL	SPLITTER
CONTAINER	HTMLCONTROL	PANEL	STATTEXT
CONTROL	ICON	PICT	STATUSBAR
DATALIST	LABELTEXT	POPUPMENU	SUBMENU
DIALOG	LINE	PROGRESS	TABCONTROL

Note the following:

DEACTIVATE is valid for all object variable types.
Once deactivated, objects may only be reactivated by using the ACTIVATE instruction.
An object must be CREATEd before being DEACTIVATEd. If this is not done, a runtime error of O105 is generated.

Example:

STOPB	BUTTON
RESULT	FORM	2
	...
	CREATE	STOPB=8:9:62:72,"STOP"
	...
	ACTIVATE	STOPB,STOPR,RESULT
	...
	DEACTIVATE	STOPB

This DEACTIVATE instruction hides the stop button that had been created and activated. The actual button still exists in memory and may be re-activated by using the ACTIVATE instruction.

See Also: ACTIVATE, Object Instructions