The ICnrEmphasisEvent class retrieves information about a container emphasis event. Objects of this class are created in response to a change-in-emphasis notification from the container. Emphasis is a visible indication of the condition of an object that can affect the ability of a user to interact with that object.
You can construct and destruct objects of this class.
![]() |
public:
virtual ~ICnrEmphasisEvent()
Windows | OS/2 | AIX |
Yes | Yes | Yes |
![]() |
Although you can construct objects of this class, typically ICnrHandler::dispatchHandlerEvent creates objects of this class from an object of the class IControlEvent in response to a change-in-emphasis notification from the container.
public:
ICnrEmphasisEvent( IControlEvent& event, IContainerObject* object, bool acquiring, IContainerObject::Emphasis emphasis )
Windows | OS/2 | AIX |
No | No | Yes |
public:
ICnrEmphasisEvent(const IControlEvent& event)
Windows | OS/2 | AIX |
Yes | Yes | Yes |
Use these members to query and set the accessible attributes of this class.
![]() |
public:
bool changed(IContainerObject::Emphasis emphasis) const
If the specified emphasis value has changed, true is returned.
Windows | OS/2 | AIX |
Yes | Yes | Yes |
![]() |
public:
bool isAcquired() const
Returns true if the ICnrEmphasisEvent is for an object that is acquiring emphasis. Otherwise, it returns false. The ICnrHandler::selectedChanged function uses this function.
Windows | OS/2 | AIX |
No | No | Yes |
![]() |
public:
IContainerObject* object() const
Returns the object that has changed its emphasis.
Windows | OS/2 | AIX |
Yes | Yes | Yes |
virtual ~ICnrEvent()
ICnrEvent(const IControlEvent& event)
virtual ~IControlEvent()
virtual unsigned long controlId() const
IControlEvent(const IEvent& event)
IControlEvent(const IControlEvent& event)
virtual ~IEvent()
IWindowHandle controlHandle() const
virtual IWindow* controlWindow() const
IEvent& decrementOwnerLevels()
virtual IWindow* dispatchingWindow() const
unsigned long eventId() const
IWindowHandle handle() const
IEvent(const IEvent& event)
IEvent( IWindow* window, unsigned long eventId, const IEventParameter1& parameter1, const IEventParameter2& parameter2 )
IEvent( const IWindowHandle& handle, unsigned long eventId, const IEventParameter1& parameter1, const IEventParameter2& parameter2 )
IEvent& operator =(const IEvent& event)
IEventParameter1 parameter1() const
IEventParameter2 parameter2() const
bool passToOwner() const
IEventResult result() const
IEvent& setControlHandle(const IWindowHandle& handle)
IEvent& setDispatchingHandle(const IWindowHandle& handle)
IEvent& setDispatchingWindow(IWindow* window)
IEvent& setHandle(const IWindowHandle& handle)
IEvent& setNumberOfLevels(int levels = - 1)
IEvent& setPassToOwner(bool passOn = true)
IEvent& setResult(bool eventResult)
IEvent& setResult(const IEventResult& eventResult)
virtual IWindow* window() const
unsigned long containerId() const