Symbian^3 Application Developer Library >

MWsWindowVisibilityNotifier Class Reference

class MWsWindowVisibilityNotifier : public MWsObjectProvider

This interface may be implemented by a render stage wishing to take over responsibility from WSERV, for updating a window's visible region. For example, if a render stage introduces non-WSERV visuals which overlap WSERV windows, WSERV may need to receive updated window visibility information.

Immediately after sucessfully obtaining this interface, WSERV will call RegisterWindowVisibilityObserver to provide a means for the render stage to notify WSERV when window visibility changes.

MWsWindowVisibilityObserver

Inherits from

Public Member Functions
void RegisterWindow (const MWsWindow &)
void RegisterWindowVisibilityObserver ( MWsWindowVisibilityObserver *)
void SendVisibilityChanges ()
void UnregisterWindow (const MWsWindow &)
Inherited Functions
MWsObjectProvider::ObjectInterface()
MWsObjectProvider::ObjectInterface()const
MWsObjectProvider::ResolveObjectInterface(TUint)

Member Functions Documentation

RegisterWindow(const MWsWindow &)

void RegisterWindow ( const MWsWindow & aWindow ) [pure virtual]

Register to be notified when visibility of a specific window changes. After registering a window, the render stage must immediately provide the current visible region by calling VisibilityChanged() and later, in response to SendVisibilityChanges, call SetWindowVisibility. RegisterWindow and UnregisterWindow are symmetrical operations. For each call to RegisterWindow, there will follow exactly one call to UnregisterWindow. MWsWindowVisibilityObserver

Parameters

const MWsWindow & aWindow Window for which WSERV needs accurate visibility information.

RegisterWindowVisibilityObserver(MWsWindowVisibilityObserver *)

void RegisterWindowVisibilityObserver ( MWsWindowVisibilityObserver * aWindowVisibilityObserver ) [pure virtual]

Register to be notified when window visibility changes.

Parameters

MWsWindowVisibilityObserver * aWindowVisibilityObserver Observer to be notified.

SendVisibilityChanges()

void SendVisibilityChanges ( ) [pure virtual]

Asks the render stage to call SetWindowVisibility for each window whose visible region has changed. All visible region changes must be sent before this method returns. MWsWindowVisibilityObserver

UnregisterWindow(const MWsWindow &)

void UnregisterWindow ( const MWsWindow & aWindow ) [pure virtual]

Stops visibility notifications being sent for the specified window. RegisterWindow and UnregisterWindow are symmetrical operations. For each call to RegisterWindow, there will follow exactly one call to UnregisterWindow.

Parameters

const MWsWindow & aWindow Window for which visibility notifications are no longer required.

Copyright ©2010 Nokia Corporation and/or its subsidiary(-ies).
All rights reserved. Unless otherwise stated, these materials are provided under the terms of the Eclipse Public License v1.0.