OnHostingChange Method

Called when the host editor wants to change the way the DTC is displayed in the editor.

Syntax

OnHostingChange(ByVal Change as dtcHostingChange, ByRef Cancel as Boolean)

Parameters

Change

The change the editor wants to make to the Design-Time Control. One of:

• dtcHostingChangeReplaceWithRunTimeText   The editor wants to replace the DTC with the DTC's generated run-time text. This operation is unrecoverable, since all persistence information of the DTC will disappear along with the <OBJECT> tag.
  
  
• dtcHostingChangeViewAsText   The editor wants to display the "raw" HTML of the DTC, instead of hosting the control in-place. This will cause the control instance to be destroyed and therefore no longer publish Choice objects.

Cancel

Whether to cancel the user operation. To stop the operation from taking place, set this parameter to True before returning.

Remarks

This method occurs when the host editor is asked to unload the DTC.

Note   This method might break the operation of some DTCs, in particular those that depend on publishing Choice objects to cause other DTCs to emit script or HTML. You might want your DTC to display a response to this method to prevent it from being viewed in this way. For example, your DTC could show a message box warning the users that proceeding with the conversion to text may cause the controls on the page to stop behaving correctly.

Applies to   IDesignTimeControl interface