Implementing a custom CAknQueryDialog dialog
hamishwillee
(Talk | contribs) m (Hamishwillee - Bot change of template (Template:CodeSnippet) - now using Template:ArticleMetaData) |
hamishwillee
(Talk | contribs) m (Hamishwillee - Update ArticleMetaData) |
||
| Line 1: | Line 1: | ||
| − | + | [[Category:Symbian C++]][[Category:Code Examples]][[Category:Touch UI]][[Category:UI]][[Category:Code Snippet]] | |
| − | __NOEDITSECTION__ | + | __NOTOC__ __NOEDITSECTION__ |
{{KBCS}} | {{KBCS}} | ||
{{ArticleMetaData | {{ArticleMetaData | ||
| Line 6: | Line 6: | ||
|platform=S60 3rd Edition, S60 5th Edition | |platform=S60 3rd Edition, S60 5th Edition | ||
|devices=Nokia 5800 XpressMusic | |devices=Nokia 5800 XpressMusic | ||
| − | + | |creationdate=20081031 | |
| − | + | ||
| − | |creationdate= | + | |
|keywords=CAknQueryDialog | |keywords=CAknQueryDialog | ||
| − | |||
|sourcecode= <!-- Link to example source code (e.g. [[Media:The Code Example ZIP.zip]]) --> | |sourcecode= <!-- Link to example source code (e.g. [[Media:The Code Example ZIP.zip]]) --> | ||
|installfile= <!-- Link to installation file (e.g. [[Media:The Installation File.sis]]) --> | |installfile= <!-- Link to installation file (e.g. [[Media:The Installation File.sis]]) --> | ||
|sdk=<!-- SDK(s) built and tested against (e.g. [http://linktosdkdownload/ Nokia Qt SDK 1.1]) --> | |sdk=<!-- SDK(s) built and tested against (e.g. [http://linktosdkdownload/ Nokia Qt SDK 1.1]) --> | ||
| − | |devicecompatability= | + | |devicecompatability=All S60 3rd Edition and later |
| − | |signing= | + | |signing=Self-Signed |
| − | |capabilities= | + | |capabilities=None |
|author=[[User:Tepaa]] | |author=[[User:Tepaa]] | ||
}} | }} | ||
| − | |||
| − | |||
==Overview== | ==Overview== | ||
| Line 27: | Line 22: | ||
This snippet can be self-signed. | This snippet can be self-signed. | ||
| − | |||
==MMP file== | ==MMP file== | ||
| Line 214: | Line 208: | ||
The custom dialog is shown for two seconds. | The custom dialog is shown for two seconds. | ||
| − | |||
| − | |||
Revision as of 07:25, 19 October 2011
Article Metadata
Tested with
Devices(s): Nokia 5800 XpressMusic
Compatibility
Platform(s): S60 3rd Edition, S60 5th Edition
Device(s): All S60 3rd Edition and later
Platform Security
Signing Required: Self-Signed
Capabilities: None
Article
Keywords: CAknQueryDialog
Created: tepaa
(31 Oct 2008)
Last edited: hamishwillee
(19 Oct 2011)
Overview
This snippet shows how to implement a custom dialog. In this case the dialog acts like an application splash screen. The dialog closes itself after two seconds and the application continues to run.
This snippet can be self-signed.
MMP file
The following capabilities and libraries are required:
CAPABILITY None
LIBRARY avkon.lib
LIBRARY eikcoctl.lib
LIBRARY eikdlg.lib
LIBRARY euser.lib
Header file
#include <aknquerydialog.h>
#include <e32std.h>
#include <e32base.h>
#include <eikbtgpc.h>
class CSplashScreenDialog : public CAknQueryDialog
{
public: // Construction
CSplashScreenDialog();
virtual ~CSplashScreenDialog();
void PreLayoutDynInitL();
void PostLayoutDynInitL();
TBool OkToExitL(TInt aButtonId);
private: // From base classes
void SizeChanged();
TInt CountComponentControls() const;
CCoeControl* ComponentControl(TInt aIndex) const;
void Draw( const TRect& /*aRect*/ ) const;
void SetSizeAndPosition(const TSize &aSize);
private: // Internal methods
void CalculatePositionAndSize();
static TInt HideDialog(TAny* aAny);
private: // Data
CPeriodic* iPeriodic;
};
Source file
#include "csplashscreendialog.h"
const TInt KShowTime(2000000);
CSplashScreenDialog::CSplashScreenDialog()
{
// Closes this dialog after KShowTime 2s
TRAPD(err,
iPeriodic = CPeriodic::NewL(CActive::EPriorityIdle);
);
if (!err)
{
iPeriodic->Start(KShowTime, KShowTime, TCallBack(HideDialog, this));
}
}
CSplashScreenDialog::~CSplashScreenDialog()
{
if (iPeriodic)
{
iPeriodic->Cancel();
}
delete iPeriodic;
}
void CSplashScreenDialog::PreLayoutDynInitL()
{
CAknQueryDialog::PreLayoutDynInitL();
SetEditableL(EFalse);
}
void CSplashScreenDialog::PostLayoutDynInitL()
{
// No CBA buttons
CEikButtonGroupContainer* cba = CEikButtonGroupContainer::Current();
cba->MakeVisible(EFalse);
// Calculate position of the dialog
CalculatePositionAndSize();
}
TBool CSplashScreenDialog::OkToExitL(TInt /*aButtonId*/)
{
return ETrue;
}
TInt CSplashScreenDialog::CountComponentControls() const
{
// No child components in this example
return(0);
}
CCoeControl* CSplashScreenDialog::ComponentControl(TInt /*aIndex*/) const
{
// No child components in this example
return NULL;
}
void CSplashScreenDialog::CalculatePositionAndSize()
{
// Set full screen
SetExtentToWholeScreen();
}
void CSplashScreenDialog::SetSizeAndPosition(const TSize &aSize)
{
CAknQueryDialog::SetSizeAndPosition( aSize );
CalculatePositionAndSize();
}
void CSplashScreenDialog::SizeChanged()
{
// Update screen
DrawNow();
}
void CSplashScreenDialog::Draw( const TRect& /*aRect*/ ) const
{
// Get the standard graphics context
CWindowGc& gc = SystemGc();
gc.SetPenStyle( CGraphicsContext::ENullPen );
gc.SetBrushColor( KRgbBlack);
gc.SetBrushStyle( CGraphicsContext::ESolidBrush );
// Clear screen
gc.Clear(Rect());
gc.SetBrushStyle( CGraphicsContext::ENullBrush );
// Draw round rect
gc.SetPenStyle( CGraphicsContext::ESolidPen );
gc.SetPenColor(KRgbWhite);
gc.DrawRect(Rect());
// TODO: Implement what you need
}
TInt CSplashScreenDialog::HideDialog(TAny* aAny)
{
CSplashScreenDialog* self = static_cast<CSplashScreenDialog*>( aAny );
// Cancel CPeriodic timer
self->iPeriodic->Cancel();
// Closes itself
TRAP_IGNORE(
self->TryExitL(1);
);
return KErrNone;
}
Custom dialog resurce
RESOURCE DIALOG r_custom_dialog
{
flags = EGeneralQueryFlags;
buttons = R_AVKON_SOFTKEYS_EMPTY;
}
Running the custom dialog
iSplashScreenDialog = new (ELeave) CSplashScreenDialog();
iSplashScreenDialog->ExecuteLD(R_CUSTOM_DIALOG);
// Execution continues here after dialog has hided itself
iSplashScreenDialog = NULL;
Postconditions
The custom dialog is shown for two seconds.
