Developer

API Reference

AEECLSID_RootTC

Brew Release
Brew MP 1.0.2
See Also
-AEECLSID_RootContainer
-AEECLSID_ContainerTC
Description
RootTC is an implementation of IController that can be used by Root Container to handle pointer events provided to the container by BREW. RootTC queries Touch observer to detect single tap occurrence on pointer down event and double tap occurrence on pointer up event and updates the pointer event string provided to the container by BREW with single/double tap information.

Events:
  Event                                               Description
----------             ----------------------------------------------------------------------------
EVT_POINTER_DOWN       RootTC queries touch observer to detect single tap occurrence and updates
		       the pointer event string provided to the container by BREW with single
		       tap information.Then, it routes the event to Container TC.

EVT_POINTER_MOVE       RootTC checks if capture mode is set and routes the pointer move and up events
		       to the capture widget. If there is no capture widget set, RootTC routes pointer
		       events to Container Touch controller.

EVT_POINTER_UP         RootTC queries touch observer to detect single tap occurrence and updates
		       the pointer event string provided to the container by BREW with single
		       tap information.
		       RootTC also checks if capture mode is set and routes the pointer up events  
		       to the capture widget. If there is no capture widget set, RootTC routes pointer
		       events to Container Touch controller.

EVT_WDG_SETPROPERTY:   The root touch controller responds to this event by attempting to set the
                       property identified by the 'wParam' parameter.  The root touch controller
                       allow the following properties to be set.
                       PROP_EX
                       >PROPEX_WIDGET_CAPTURE                       

Properties:
Property                      Description
--------                      ------------------------------------------------------------
PROP_EX                       Property used to specify an extended property
                                  IWidget_GetPropertyEx
                                  IWidget_SetPropertyEx

PROPEX_WIDGET_CAPTURE         Property used to set the capture widget associated with 
			      root container.

Instantiaion
Applications do not need to deal with RootTC directly if they want to have the default behavior as described above. If the application needs to customize the behavior of this touch controller, it can do so by overriding handler for the touchcontroller.
The Root Touch Controller is instantiated by passing AEECLSID_RootTC into ISHELL_CreateInstance.
Cleanup
The RootTC is reference counted. When you are done with your reference to the RootTC, you should Release that reference. Any controller specific cleanup will be handled for you when all references are released.
Default Interface Name
Other Interfaces
  • Follow