Li Yongfei's Forum Nokia Blog

Making TimeLine Control

Thu, 20 Jul 2006 10:44:28 +0300

The timelnie in puzzle games, lifetime in fighting games, that is a very normol element.
The following article will tell you how to make a timeline control step by step in S60.

Author Website: http://www.symbianer.com

The keywords of artile: window, custom control, time, periodic.

Frist, you need reffer to tow articles
I.Symbian OS: Creating Custom Controls
you can download here>>

II.Periodic timer active object.
Developer Library >> API Reference >> C++ API reference >> Timers and Timing Services >> CPeriodic

1. Class Declaration:

Code:

class CMyTimerContainer : public CCoeControl
{
public:

    void ConstructL(TInt aSecond ,TPoint aPoint, TSize aSize); // Initialize Seconds, Position, Size Of Timeline Control
    ~CMyTimerContainer();
    void Draw(const TRect& aRect) const;

    static TInt Start__(TAny* aObject);
    void Start_();
private: //data

CPeriodic* iPeriodic;
TInt iLeft; //Left times
TInt iTotal;//Total times
TPoint iPoint; //control position,
TSize iSize; //Control size
}

2. Periodic Functions:

Code:

TInt CMyTimerContainer::Start__(TAny* aObject)
{
((CMyTimerContainer*)aObject)->Start_(); // cast, and call non-static function
    return 1;
}

void CMyTimerContainer::Start_()
{
iLeft--;
if(iLeft==0)
{
    DrawNow();
    iPeriodic->Cancel();
    return;
}
DrawNow();
}

3. Draw Funciton
Code:

void CMyTimerContainer::Draw(const TRect& aRect) const
    {
    CWindowGc& gc = SystemGc();

    /*Draw BackGround*************************/
    gc.SetBrushColor( KRgbBlack );
    gc.SetBrushStyle( CGraphicsContext::ESolidBrush );
    gc.DrawRect(aRect);

    /*Drar Timeline*************************/
     gc.SetBrushStyle( CGraphicsContext::ESolidBrush );
     gc.SetBrushColor( KRgbRed );
     gc.SetPenStyle( CGraphicsContext::ENullPen );
     gc.DrawRect( TRect(TSize(iLeft*Size().iWidth/iTotal,iSize.iHeight)) );
    }

4. Construct Function

Code:

void CMyTimerContainer::ConstructL(TInt aSecond ,TPoint aPoint, TSize aSize)
    {
    CreateWindowL();
    iTotal = aSecond;
    iLeft = iTotal;
    iPoint = aPoint;
    iSize = aSize;
    iPeriodic = CPeriodic::NewL(CActive::EPriorityIdle);
    iPeriodic->Start(0/*8000000*/, 1000000/*35714*/, TCallBack(Start__, this));
    SetExtent(aPoint,aSize);
    ActivateL();
    }

5. How To Use The Timeline Custom Control

Code:

a.Add Custom Control in XXXContainer.h
   private: //data
     CMyTimerContainer* iTimer;

b,Initialize Seconds, Position, Size Of Timeline Control
void CXXXXContainer::ConstructL(const TRect& aRect)
    {
    CreateWindowL();

    iTimer = new (ELeave) CMyTimerContainer;
    iTimer->ConstructL( 60/*init seconds*/,TPoint(0,100),TSize(176,15),this);

    SetRect(aRect);
    ActivateL();
    }

You can reffer to the codes of article to modify your codes. Welcome to comment here.
Download Source Codes>>
English Version: http://www.symbianer.com/post/custom-control-timeline-en.html
Chinese Version: http://www.symbianer.com/post/custom-control-timeline.html

Mail: N-office@163.com
Website: http://www.symbianer.com

Carbide.c++ team blog on S60.com

Fri, 16 Jun 2006 19:36:15 +0300

The Carbide.c++ development team has created its own blog on S60.com. There Carbide.c++ team will post the detail of their daily work, in which abstract customer requirements are translated into actual product design.

The recent articles:

Carbide.c++ nears Beta
Carbide.c++ Developer/Professional v1.1 is nearing its beta launch -- we expect to have product available for our closed beta group by the end of the month. Forum Nokia PRO availability (via the tools alpha) is also planned. This will be the final opportunity for beta testers to review the product and submit bug reports. So far, based on the feedback we've received from our beta group we've managed to do some significant changes to the product relatively close to our feature complete date. The beta will reflect our view of what the product should look like, except for a few things like getting icons, docs, licensing, and the webstore into place...

C++ tutorial templates

Previously C++ project tutorials (that ship with the SDK or are available on Forum Nokia) have consisted of a separate doc and zip file containing the project that required you to import the MMP and open the instructions in a PDF reader. In order to make learning about S60 a little easier, one of our developers is investigating a more convenient way of accessing programming examples, to be delivered in v1.2 (or 1.1 if we're lucky). Take a look...

Get More informations and news about Carbibe.c++ >>

http://www.symbianer.com

TIP: Using extended filename Launching an application

Fri, 16 Jun 2006 05:47:05 +0300

Today, In Nokia Forum Discussion I found a developer ask this question, this is a frequently asked questions. So I write this TIP. I wish it can help more developers. (author website: http://www.symbianer.com)

Q: How to use extended filename launch an application?

A: If your document is clicked on, a recognizer will run to launch your app and pass it the filename. OpenFileL() will be invoked on that file by default. About recognizer, you can reffer to the s60 sdk Document Handling

Document File Creation

To further reduce application startup time, Series 60 by default disables document file creation and opening. In other words, CAknDocument::OpenFileL() returns NULL. OpenFileL() is called by the framework during application initialization, and returns the file store containing the application’s document. Series 60 applications must override CAknDocument::OpenFileL() if they need to store and restore data.

Code:

in cAknDocument
class CAknDocument : public CEikDocument
{
public: // from CEikDocument
IMPORT_C CFileStore* OpenFileL(TBool aDoOpen,const TDesC& aFilename,RFs& aFs);
protected:
IMPORT_C CAknDocument(CEikApplication& aApp);
};

When you clicked your document, the file path and file name will pass by "aFilename", so you can use "aFilename" to get the informations of your clicked file.

you can visit my website get more tips.

website: http://www.symbianer.com

A small tool to get the members of the TKeyEvent class

Sat, 27 May 2006 04:25:09 +0300

A small tool to get the members of the TKeyEvent class

When processing a TKeyEvent, the TStdScanCode in iScanCode should usually be ignored in favour of the TKeyCode in iCode. Using iScanCode would bypass the keyboard mapping and any FEP that happens to be installed. The exceptions to this general rule are games where the positions of the keys are more important than their translations, and FEPs that are implementing keyboard maps themselves. In these cases, if the iCode is used rather than iScanCode to determine the key pressed, there will be two unfortunate consequences. Firstly, the low-level keyboard mapping might re-arrange the mapping that you are trying to impose. Secondly, you will subvert the CTRL+number method of entering Unicode literals.

above-mentioned contents refers to the TKeyEvent in S60 SDK.

in w32std.h file

Code:

struct TKeyEvent
{
//Key codes for special keys are defined in TKeyCode.
TUint iCode;
//The scan code of the key that caused the event.
//Standard scan codes are defined in TStdScanCode.
TInt iScanCode;
//State of modifier keys and pointing device. Modifier keys are defined in TEventModifier.
TUint iModifiers;
/** Count of auto repeats generated.0 means an event without repeats. 1 or more means "this many auto repeat events".
It is normal to ignore this value and treat it as a single event. */
TInt iRepeats;
};

This tool can display the key codes in screen. for example when you press a "Ok", the screen like this:

click this link to download this tool: KeyCodeExample.sis(S60 2rd FP3)

Using Theme in an Application

Mon, 22 May 2006 15:54:10 +0300

Using Theme in an Application

This article can tell you how to write a enable skins application.

You can use theme in an Application after version in Series 60 Platform 2.0. the following content will tell you how to do these step by step.

Link against aknskins.lib and include files

Add the libray named aknskins.lib in SkinSample.mmp

Code:

LIBRARY aknskins.lib // link against aknskins.lib

Add two include files in SkinExampleContainer.h

Code:

#include <AknsDrawUtils.h>// add this inlcude file skin
#include <AknsBasicBackgroundControlContext.h> //add this inlcude file skin

Enabling skins in AppUi

Code:

/* In SkinExampleAppUi.cpp */

void CSkinExampleAppUi::ConstructL()
{
BaseConstructL( EAknEnableSkin );//Construct a enalbe skin

.....

}

new and delete a MAknsControlContext class in Container class

Add a MAknsControlContext class in container class

Code:

/* In skinExampleContainer.h */

class CSkinExampleContainer : public CCoeControl, MCoeControlObserver

{

....

private:

MAknsControlContext* iBackGround; // for skins support

}

/* In SkinExapleContainer.cpp */

void CSkinExampleContainer::ConstructL(const TRect& aRect)
{
CreateWindowL();

    iLabel = new (ELeave) CEikLabel;
    iLabel->SetContainerWindowL( *this );
    iLabel->SetTextL( _L("Skin Example") );

SetRect(aRect);
iBackGround = CAknsBasicBackgroundControlContext::NewL( KAknsIIDQsnBgAreaMain, Rect(), EFalse );// new a background

ActivateL();
}

Delete iBackGroud

Code:

// Destructor
CSkinExampleContainer::~CSkinExampleContainer()
{
.....

delete iBackGround;
}

Draw the background bitmap using Skin library

Code:

/* In SkinExapleContainer.cpp */

void CSkinExampleContainer::Draw(const TRect& aRect) const
    {
    CWindowGc& gc = SystemGc();
// draw background
MAknsSkinInstance* skin = AknsUtils::SkinInstance();//new
MAknsControlContext* cc = AknsDrawUtils::ControlContext( this );//new
    AknsDrawUtils::Background( skin, cc, this, gc, aRect );//new
    }

MObjectProvider Chains

MObjectProvider interface can be used to make object instances available to child controls.

MopSupplyObject returns a pointer based on the given UID.

Code:

/* In SkinExapleContainer.cpp */

TTypeUid::Ptr CSkinExampleContainer::MopSupplyObject(TTypeUid aId)
    {
    if(aId.iUid == MAknsControlContext::ETypeId && iBackGround)
        {
        return MAknsControlContext::SupplyMopObject( aId, iBackGround);
        }

return CCoeControl::MopSupplyObject( aId );
}

Note: If you want to get the source code about this article ,plz link to http://www.symbianer.com.

Flash Lite 2.0 in S60 3rd Edition, Feature Pack 1

Sat, 20 May 2006 04:36:57 +0300

Flash Lite 2.0 in S60 3rd Edition, Feature Pack 1

Flash Lite 2 will be available for wide implementation in devices starting with s60 3rd Edition FP1.Also Nokia S40 plans to implement support for Flash Lite2

click here to read more S60_Flash_Lite_May.pdf