How do I display data?

[wirefree101]

HI!

I am developing my first Symbian application and am referencing "Developing Series 60 Applications" by Leigh Edwards. The example that I am using as a reference is HelloWorld.

In the section "Header & Source Files", the book outlines the contents & functions of each of the souce files. Following is a brief snapshot:

- HelloWorldApp.h: Application creation/initialization
- HelloWorldApp.cpp: Application creation/initialization
- HelloWorldAppUI.h: Command handler/controller
- HelloWorldAppUI.cpp: Command handler/controller
- HelloWorldDocument.h: Owns the data or application model
- HelloWorldDocument.cpp: Owns the data or application model
- HelloWorldContainer.h: Displays the application data
- HelloWorldContainer.cpp: Displays the application data

It reads that while the '.h' files contain the class & functions declarations, the '.cpp' files contain the class & functions definitions.

While the HelloWorld example conforms to the above described situation, when I create a new application using the 'Symbian Project Wizard', I am presented with the following set of files in the 'Source' plus-sign tree in the IDE:

- TestApp.cpp
- TestApplication.cpp
- TestAppUI.cpp
- TestAppView.cpp
- TestDocument.cpp
- UID.cpp

My question is:

Since I would like to display a 'Welcome' message on the very first screen as the user starts the application, where should I define the equivalent of the following code in the absence of a TestContainer.cpp file:

HBufC* labelText;
labelText = StringLoader::LoadLC(R_LABEL_TEXT);
iLabel->SetTextL(*labelText);
CleanupStack::PopAndDestroy(labelText);

Please note that I am using CW v3.1 & SDK 2nd_FP2_CW.

Thx & cheers,

wirefree101

[ltomuta]

HI!

I am developing my first Symbian application and am referencing "Developing Series 60 Applications" by Leigh Edwards. The example that I am using as a reference is HelloWorld.

In the section "Header & Source Files", the book outlines the contents & functions of each of the souce files. Following is a brief snapshot:

- HelloWorldApp.h: Application creation/initialization
- HelloWorldApp.cpp: Application creation/initialization
- HelloWorldAppUI.h: Command handler/controller
- HelloWorldAppUI.cpp: Command handler/controller
- HelloWorldDocument.h: Owns the data or application model
- HelloWorldDocument.cpp: Owns the data or application model
- HelloWorldContainer.h: Displays the application data
- HelloWorldContainer.cpp: Displays the application data

It reads that while the '.h' files contain the class & functions declarations, the '.cpp' files contain the class & functions definitions.

While the HelloWorld example conforms to the above described situation, when I create a new application using the 'Symbian Project Wizard', I am presented with the following set of files in the 'Source' plus-sign tree in the IDE:

- TestApp.cpp
- TestApplication.cpp
- TestAppUI.cpp
- TestAppView.cpp
- TestDocument.cpp
- UID.cpp

My question is:

Since I would like to display a 'Welcome' message on the very first screen as the user starts the application, where should I define the equivalent of the following code in the absence of a TestContainer.cpp file:

HBufC* labelText;
labelText = StringLoader::LoadLC(R_LABEL_TEXT);
iLabel->SetTextL(*labelText);
CleanupStack::PopAndDestroy(labelText);

Please note that I am using CW v3.1 & SDK 2nd_FP2_CW.

Thx & cheers,

wirefree101

The files underlined above are most likely equivalent, they both contain the implementation of a CCoeControl derived class... Your code will have to go in that class' ConstructL method.

Hm, that book should be explaining all this ... make sure you read the entire chapter before coding an exercise. :)

Best regards,

[wirefree101]

Thx! Found what I was looking for a chapter later in the book.

I have done a thorough comparison of the following set of files:

- TestAppView.h vis-a-vis HelloWorldContainer.h
- TestAppView.cpp vis-a-vis HelloWorldContainer.cpp
- TestAppUI.cpp vis-a-vis HelloWorldAppUI.cpp
- Test.rss vis-a-vis HelloWorld.rss


Following is the step-by-step procedure I undertook:

o TestAppview.h
 Added ‘class CEikLabel’
 Added SizeChanged()
 Added CountComponentControls()
 Changed draw() from public to private
 Added CEikLabel* iLabel as private data
 Commented out CTestAppView() to conform with HelloWorldContainer.h

o TestAppview.cpp
 Included eiklabel.h
 Included stringloader.h
 Defined KLabelPosition TPoint
 iLabel related code:
• iLabel = new (ELeave) CEikLabel;
• iLabel->SetContainerWindowL(*this);
• HBufC* labelText;
• labelText = StringLoader::LoadLC(R_LABEL_TEXT);
• iLabel->SetTextL(*labelText);
• CleanupStack::PopAndDestroy(labelText);
 Added ‘delete iLabel’ to the destructor
 Added CTestAppView::SizeChanged()
 Added CTestAppView::CountComponentControls()
 Added CCoeControl* CTestAppView::ComponentControl()
 Commented out CTestAppView:: CTestAppView()
 Commented out TRect rect = Rect() from void CTestAppView::Draw()

o TestAppUI.cpp
 Included test.rsg
 Included stringloader.h
 Called SetMopParent on AppView
 Commented iAppView = NULL from the destructor
 Commented out CTestAppUI:: CTestAppUI()
 Made necessary changes to HandleComandL to accommodate various commands defined in Test.rss

o Test.rss
 Included avkon.mbg
 Added RESOURCE TBUF r_label_text {}


I get one error when I 'make':

"Error: undefined identifier 'R_LABEL_TEXT'"


Where do I insert the actual text I want displayed on my 'Welcome Screen'?

Advise appreciated, as always.


Thx in advance,
wirefree101

[ninidotnet]

Hi,

Have you define R_LABEL_TEXT in .loc file?

In Text.loc define:
#define R_LABEL_TEXT "Text"

[ltomuta]

R_LABEL_TEXT is a resource id and should have been generated in test.rsg as a efect of compiling the r_label_text statement from the test.rss file.

RESOURCE TBUF r_label_text
	{
	buf = LABEL_TEXT;
	}

(I am kind of guesssing the resouce definition since it is missing from your problem description.) It is LABEL_TEXT that should be define in a *.loc file that has to be included in test.rss. Or you may replace that line with a language independent one

buf = "Welcome!";

Check the %EPOCROOT%epoc32\include\test.rsg file. If it is missing look for resource build errors in the build log and fix them.

You can also code your welcome message without the use of resources:

iLabel = new (ELeave) CEikLabel;
iLabel->SetContainerWindowL(*this);
_LIT(KWelcome, "Welcome!");
iLabel->SetTextL(KWelcome);

unless mastering the resources is what you are focusing on right now.

Best regards,

[wirefree101]

Very right about the Test.loc file there...However, the Symbian Project Wizard did not, by default, create a .loc for my test project.

Therefore, as suggested, I took the alternative route of hard-coding the 'Welcome' message into TestAppView.cpp by incorporating the following code:

iLabel = new (ELeave) CEikLabel;
iLabel->SetContainerWindowL(*this);
_LIT(KWelcome, "Welcome!");
iLabel->SetTextL(KWelcome);

I have also deleted the Resource TBUF r_label_text definition in Test.rss.

However, when I build, I get 3 link errors:

- Link Error : Undefined symbol: 'CwelcomeScreenAppUi::CwelcomeScreenAppUi(void) (??0CwelcomeScreenAppUi@@QAE@XZ)'

- Link Error : MAKEDEF ERROR: C:\Symbian\8.0a\S60_2nd_FP2_CW\Examples\welcomeScreen\group\welcomeScreen_Data\WINSCW_UDEB\WELCOMESCREEN.inf:
Inffile not found

- Link Error : Undefined symbol: 'CwelcomeScreenAppUi::CwelcomeScreenAppUi(void) (??0CwelcomeScreenAppUi@@QAE@XZ)'


Would greatly appreciate some advise here.

Best,
wirefree101

[antonypr]

The linker error indicates that CwelcomeScreenAppUi::CwelcomeScreenAppUi() is missing from your project. Have you included the .cpp file of this class to the project file (.mmp)?

Antony

[wirefree101]

The linker error indicates that CwelcomeScreenAppUi::CwelcomeScreenAppUi() is missing from your project. Have you included the .cpp file of this class to the project file (.mmp)?

Yes, I have. Infact, its done automatically if the project is created using the Symbian Project Wizard. Here's a part of the code indicating the same:

DOCUMENT		  Series_60_APP_ReadMe.txt
SOURCE            welcomeScreen.cpp
SOURCE            welcomeScreenApplication.cpp 
SOURCE            welcomeScreenAppView.cpp
SOURCE            welcomeScreenAppUi.cpp
SOURCE            welcomeScreenDocument.cpp

However, the 'u' in welcomeScreenAppui & 'v' in welcomeScreenAppview.cpp is not in uppercase as far as the actual file names are concerned. By this I mean that the 5 files in the /src folder do not follow the same naming convention as that mentioned in the .mpp file.

Anyways, I have renamed the files to conform with the above code. But I continue to receive the link errors.

How would you propose I proceed?


Best,
wirefree

[wizard_hu_]

How would you propose I proceed?

The AppUi class usually need no explicit constructor, however you have declared one in the header file.
Solutions:
- if you have unintentionally declared the constructor, comment or delete it from the header (probably welcomeScreenAppUi.h)
- define the constructor, or (if you have already tried to do that) make sure that it is called CwelcomeScreenAppUi::CwelcomeScreenAppUi() - for example it is easy to forget the scope for constructors since you have to type twice the same thing (CwelcomeScreenAppUi in this case)

[wirefree101]

Appreciate the response.

With reference to my query, I have constructed the project using CodeWarrior's Symbian Project Wizard which generates the necessary .h files. Therefore, pertaining to welcomeScreenAppUi class, I have not had to explicitly declare constructors or destructors.

The AppUi class usually need no explicit constructor, however you have declared one in the header file.
Solutions:
- if you have unintentionally declared the constructor, comment or delete it from the header (probably welcomeScreenAppUi.h)
- define the constructor, or (if you have already tried to do that) make sure that it is called CwelcomeScreenAppUi::CwelcomeScreenAppUi() - for example it is easy to forget the scope for constructors since you have to type twice the same thing (CwelcomeScreenAppUi in this case)

As suggested, I have modified the welcomeScreenAppui.h file. Following is a snapshot:

#ifndef __WELCOMESCREEN_APPUI_H__
#define __WELCOMESCREEN_APPUI_H__

#include <aknappui.h>

// Forward reference
class CwelcomeScreenAppView;

class CwelcomeScreenAppUi : public CAknAppUi
    {
public:

    void ConstructL();

CwelcomeScreenAppUi::CwelcomeScreenAppUi();

    ~CwelcomeScreenAppUi();


public: // from CAknAppUi
    void HandleCommandL(TInt aCommand);

private:
    CwelcomeScreenAppView* iAppView;
    };

#endif // __WELCOMESCREEN_APPUI_H__

Please note that the IDE continues to generate the above mentioned link errors.

Request assistance from Forum Nokia Champions.


Best,
wirefree101

[wizard_hu_]

I have not really meant this solution. You should revert the change in the declaration, and check the definition of the constructor, which is likely in a .cpp file.

[wirefree101]

Some success @ last!

The 3 link errors associated with AppUi have resolved with the uncommenting of the welcomeScreenAppUi constructor in welcomeScreenAppUi.cpp. I had commented the same to conform with the HelloWorld example whereby the Symbian OS 2nd phase constructor was implemented using ConstructorL().

I seem to be now in familiar territory as far as errors are concerned. The app generates 5 link errors associated with EikLabel. I say 'familiar territory' as this is the one aspect of the application that has been added to the base HelloWorld code.

Now if someone could help me decipher what these link errors indicate:

Link Error   :  Undefined symbol: 'CEikLabel::CEikLabel(void) (??0CEikLabel@@QAE@XZ)'

Link Error   :  Undefined symbol: 'void CEikLabel::SetTextL(class TDesC16 const &) (?SetTextL@CEikLabel@@QAEXABVTDesC16@@@Z)'

Link Error   : MAKEDEF ERROR: C:\Symbian\8.0a\S60_2nd_FP2_CW\Examples\welcomeScreen\group\welcomeScreen_Data\WINSCW_UDEB\WELCOMESCREEN.inf:
Inffile not found

Link Error   :  Undefined symbol: 'CEikLabel::CEikLabel(void) (??0CEikLabel@@QAE@XZ)'

Link Error   :  Undefined symbol: 'void CEikLabel::SetTextL(class TDesC16 const &) (?SetTextL@CEikLabel@@QAEXABVTDesC16@@@Z)'

Wud gr8ly appreciate assistance.


cheers,
wirefree101

[wizard_hu_]

They are reporting undefined symbols. Symbols which are not defined by you are usually defined in .lib files. However 2nd edition SDK Help-s usually do not contain description of CEik... classes, thus you can do a binary search in epoc32\release\winscw\urel\*.lib for a missing symbol (for example do a search for ??0CEikLabel@@QAE@XZ), or you can google for CEikLabel (and find http://www.symbian.com/developer/tec...CEikLabel.html rather fast). Add the required library to your project and try again.

[wirefree101]

Thx for the response.

eikcoctl.lib is present in epoc32\release\winscw\udeb and the following statement is also included in welcomeScreenAppView.cpp:

#include <eiklabel.h>

:confused:

[wizard_hu_]

There are many things present in epoc32\release\winscw\udeb...
But you have to add eikcoctl.lib to your project, more specifically you should include the line

LIBRARY eikcoctl.lib

in the .mmp file of your project (and after that you should use the Re-Import command in the project menu).