IMsoComponentManager::FSetTrackingComponent Method
Applies to: Office 2010
Informs the component manager that a component needs to perform a tracking operation (such as mouse tracking).
BOOL FSetTrackingComponent(
DWORD_PTR dwComponentID,
ULONG grftrack
);
Parameters
dwComponentID [in]
The ID of the component that needs to perform a tracking operation.grftrack [in]
TRUE to begin the tracking operation. FALSE to end the tracking operation.
Return Value
TRUE if the method is successful; otherwise, FALSE.
Remarks
The component calls this method with the grfTrack parameter equal to TRUE to begin the tracking operation, and with the grfTrack parameter equal to FALSE to end the operation. During the tracking operation, the component manager routes messages to the tracking component (by calling the IMsoComponent::FPreTranslateMessage method) rather than to the active component. When the tracking operation ends, the component manager resumes routing messages to the active component.
The component manager should not perform any idle-time processing during a tracking operation, other than providing idle time for the tracking component by calling the IMsoComponent::FDoIdle method.
There can be only one tracking component at a time.