Please note that as of October 24, 2014, the Nokia Developer Wiki will no longer be accepting user contributions, including new entries, edits and comments, as we begin transitioning to our new home, in the Windows Phone Development Wiki. We plan to move over the majority of the existing entries over the next few weeks. Thanks for all your past and future contributions.

Archived:Using drawable windows without Symbian application framework

From Wiki
Jump to: navigation, search

Archived.pngArchived: This article is archived because it is not considered relevant for third-party developers creating commercial solutions today. If you think this article is still relevant, let us know by adding the template {{ReviewForRemovalFromArchive|user=~~~~|write your reason here}}.

Article Metadata
Platform(s): S60 2nd Edition and FP1, FP2, FP3
S60 3rd Edition and FP1
S60 3rd Edition FP1
S60 3rd Edition (initial release)
S60 2nd Edition (initial release)
Created: User:Technical writer 2 (10 May 2007)
Last edited: hamishwillee (14 Jun 2012)


Using drawable windows without application framework


When developing a Symbian GUI application, application framework's control environment sets up a window system automatically, providing access to window server session, screen device, graphics context, window group, etc.
If an application that does not use application framework wants to draw to the screen using a graphics context, all these resources must be constructed manually.


The following example code demonstrates these steps:
 - Connecting to window server (RWsSession)
 - Creating a screen device (CWsScreenDevice) and a graphics context (CWindowGc)
 - Creating a root (group) window (RWindowGroup) with a high ordinal priority to make it a 'stay on top' window
 - Creating a window with specific properties
 - Drawing to the window
 - Window server event handling
The custom graphics class is derived from CActive. This makes it easy to listen to events from the window server which provides asynchronous notification methods for several types of events. Currently, only redraw events (TWsRedrawEvent) are being handled. Another useful event type to handle would be screen size/mode change event. These events can be activated by calling RWindowGroup::EnableScreenChangeEvents(), and requested from the window server by calling RWsSession::EventReady() and RWsSession::GetEvent(). See the SDK Help for more information about window server events.
On S60 3rd Edition, the following code requires WriteDeviceData capability.
#include <e32base.h>
#include <w32std.h>     // ws32.lib
#include <coedef.h>
class CCustomGraphics : public CActive
    static CCustomGraphics* NewL();
    void CustomDraw( TRect& aRect );
    virtual ~CCustomGraphics();
    void    ConstructL();
    // from CActive
    void    DoCancel();
    void    RunL();
    RWsSession       iWsSession;
    CWsScreenDevice* iScreenDevice;
    RWindowGroup     iWindowGroup;
    RWindow*         iWindow;
    CWindowGc*       iWindowGc;
: CActive( CActive::EPriorityLow )
    CActiveScheduler::Add( this );
CCustomGraphics* CCustomGraphics::NewL()
    CCustomGraphics* self = new (ELeave) CCustomGraphics;
    CleanupStack::PushL( self );
    CleanupStack::Pop(); // self;
    return self;
void CCustomGraphics::ConstructL()
    // Connect to window server session
    User::LeaveIfError( iWsSession.Connect() );  
    // Set client priority permanently to current level. See documentation on
    // RWsSession for more information
    iWsSession.ComputeMode( RWsSession::EPriorityControlDisabled );
    iScreenDevice = new (ELeave) CWsScreenDevice( iWsSession );
    User::LeaveIfError( iScreenDevice->Construct() );
    iScreenDevice->SetScreenModeEnforcement( ESizeEnforcementNone );
iWindowGroup = RWindowGroup( iWsSession );
    User::LeaveIfError( iWindowGroup.Construct( (TUint32)this, ETrue ) );
    // This window group cannot receive keyboard focus
    iWindowGroup.EnableReceiptOfFocus( EFalse );
    // Window group will always be on top
    iWindowGroup.SetOrdinalPosition( 0, ECoeWinPriorityAlwaysAtFront+1 );
    // Create graphics context for the screen device
    User::LeaveIfError(iScreenDevice->CreateContext( iWindowGc ) );

    // Finally, create a window, set its properties, and display it
    iWindow = new (ELeave) RWindow( iWsSession );
    User::LeaveIfError(iWindow->Construct( iWindowGroup, (TUint32)iWindow ) );
    iWindow->SetExtent( TPoint( 10, 10 ), TSize( 100, 100 ) );
    iWindow->SetOrdinalPosition(0, ECoeWinPriorityAlwaysAtFront+1 );
    iWindow->SetCornerType( EWindowCorner5 );
    iWindow->SetNonFading( ETrue );
    iWindow->SetVisible( ETrue );
    // Start waiting for redraw events
    iWsSession.RedrawReady( &iStatus );
    delete iWindow;
    delete iWindowGc;
    delete iScreenDevice;
void CCustomGraphics::RunL()
    if( iStatus == KErrNone )
        TWsRedrawEvent event;
        iWsSession.GetRedraw( event );   
        // Handle of the window which is the target of redraw event
        // Can be used for ID purposes if multiple windows are used
        RWindow* window = ( RWindow* )( event.Handle() );   
        // Rectangle that needs to be redrawn
        TRect eventRect = event.Rect();
        CustomDraw( eventRect );                 
        iWsSession.RedrawReady( &iStatus );
void CCustomGraphics::DoCancel()
void CCustomGraphics::CustomDraw( TRect& /*aRect*/ )
    iWindowGc->Activate( *iWindow );
    iWindowGc->SetBrushStyle( CGraphicsContext::ESolidBrush );
    iWindowGc->SetBrushColor( TRgb( 255, 0, 0 ) );
The order of construction for CWsScreenDevice and RWindowGroup is important. For the window to work in different screen modes, the CWsScreenDevice should be created before the RWindowGroup object.
This is because on the server side, each group window is associated with a screen device. If the client hasn't created a screen device, there won't be an association.
Each screen device is registered to work in a screen size mode, which can be changed by the client. All windows under a window group will be set invisible if the associated screen device is registered to work in a mode that is different from the one the device is currently operating in (there are some exceptions to this). If a group window doesn't have a screen device, it will be registered to work in the first mode (0).
 - Group windows created before the screen device will only be seen in the first screen size mode.
 - Group windows created after the screen device will be visible in all modes, as the registered mode is determined by the screen device.

This page was last modified on 14 June 2012, at 07:10.
27 page views in the last 30 days.

Was this page helpful?

Your feedback about this content is important. Let us know what you think.


Thank you!

We appreciate your feedback.