Developer

API Reference

AEECLSID_TabTC

Brew Release
Brew MP 1.0.2
Description
TabTC is an implementation of IController that can be used by TabWidget to handle pointer events provided to the widget by BREW.

TabTC handles BREW pointer events for a TabWidget and responds by
    
    - Moving focus after selecting a tab
        TabTC moves focus to relevant tab after it receives EVT_POINTER_DOWN.
        This will cause a EVT_MDL_FOCUS_CHANGE notification  via 
        TabWidget's ViewModel.

    - Moving focus after selecting tab-arrows
        If the TabWidget has arrows to navigate left/right between the tabs,
        and the EVT_POINTER_DOWN happens on one of these arrows, then TabTC
        responds by moving focus to previous or next tab.
        
      If the pointer event happens to be inside the tab content region, 
      then the TabTC localizes the event and passes it to the child widget.
      All pointer events are passed to the child widget.



Using TabTC from your application:


Applications do not need to deal with TabTC 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 touch controller. If the application wants to continue using default behavior, it can just add listener to the TabWidget's ViewModel and listen for EVT_MDL_FOCUS_CHANGE to know when a tab was focused.
Instantiaion
The tab widget touch controller is instantiated by passing AEECLSID_TabTC into ISHELL_CreateInstance.
Cleanup
The tab widget touch controller is reference counted. When you are done with your reference to the touch controller, you should Release that reference. Any tab widget touch controller specific cleanup will be handled for you when all references are released.
Default Interface Name
  • Follow