GuiRemoveCtl()

Removes a control from an already open window.

error = GuiRemoveCtl(Control, Window, ButtonNum)


Args

Control is either the name of the REXX Variable that was associated with the control, or the control's handle gotten via GuiGetCtl().

Window is the handle to the window in which the control is found. If omitted, the window handle is gotten from the GuiWindow variable (set by GuiCreateWindow).

ButtonNum is supplied only for RADIO buttons. It indicates which button (number) within the group. For example, if this were the first RADIO button you were removing from a group, then you would pass a 1. For the second button in the same group, you would pass a 2. Etc.

Note: If you give individual variable names to each radio button, then you do not need to pass the ButtonNum arg. For the Control arg, simply pass the variable name associated with the desired RADIO control to remove.


Returns

If successful, an empty string is returned. If an error, an error message is returned.


Notes

It is not considered an error to remove a control that was never successfully added to the window.