IMsoComponentManager::FSetTrackingComponent Method
This content is outdated and is no longer being maintained. It is provided as a courtesy for individuals who are still using these technologies. This page may contain URLs that were valid when originally published, but now link to sites or pages that no longer exist.
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.