IDAViewSite Interface

The IDAViewSite interface supports managing information that is tied to the view. Microsoft® DirectAnimation® sends status information about the view to the view site. When you create a view, you should also create a view site.

You can access the view site from the view by calling the IDAView::put_Site and IDAView::get_Site methods.

This interface inherits from IDispatch.

The IDASite interface supports managing global information that can apply to more than one view. Information about importing media files, for example, could apply to more than one view.

IDAViewSite Methods

SetStatusText Sets the status text for the view.

IDAViewSite::SetStatusText

IDAViewSite

Sets the status text for the view.

Syntax

HRESULT SetStatusText(
    BSTR StatusText
);

Parameters

StatusText
[in] BSTR value containing the status text for the site. A BSTR is a length-prefixed string. The length is stored as an integer at the memory location preceding the data in the string.

Return Value

Returns an HRESULT value that indicates the success of the method or the reason why it failed. This HRESULT depends on the implementation of the interface.

Remarks

For an example of this method, see ctlhost.cpp in the Samples\Multimedia\DAnim\C++\Showcase\DragGeoCntrl directory.