Revoke Method

Removes the Choice object from the name space managed by the Choice engine.

Syntax

Revoke(choiceobject)

Parameters

choiceobject

Name of a static choice.

Remarks

Use this method to remove a choice from the list of choices published by the control. Any design-time controls that use this choice are notified during the next rebind operation and are bound to a different choice or to no choice at all.

Deleting a control automatically removes the choices published by that control and a call to the Revoke method is not necessary.

This method fails if applied to dynamic choice objects. Dynamic choice objects are those that are added to the collection passed to the DesignTimeControl object by using the OnGetChoices method.

Releasing a reference to a Choice is not the same as calling the Revoke method. A design-time control can release its pointer to the choice, but the choice is still referenced and managed within the Choices collection.

Applies to   Choice object