UIQ Programmer's Guide

UIQ 3 introduces an extensive set of changes over previous releases of UIQ. This document is intended to explain the motives behind introducing these changes, as well as to provide developers with an informative guide to migrating from previous UIQ releases to UIQ 3. The Programmer's Guide to new features can be found here:

• Programmer's Guide to new features

Table of contents

1 OVERVIEW

1.1 UIQ 3 Objectives

1.2 Prerequisites

1.3 Component changes overview

2 Framework enhancement

2.1 New version of CONE

• 2.1.1 Creating compound controls

• 2.1.2 Pointer events and non-rectangular controls

• 2.1.3 The SystemGc and controls’ graphic contexts

• 2.1.4 Control drawing and backgrounds

• 2.1.5 Control text styles and colors

• 2.1.6 Control zooming

• 2.1.7 Font provider and control screen fonts

• 2.1.8 Layout managers

• 2.1.9 Unique control identification

• 2.1.10 Maximum control width

2.2 Internationalization

• 2.2.1 Bi-directional text

• 2.2.2 Application language determinition

2.3 New RTTI-like mechanism for probing interfaces

• 2.3.1 MObjectProvider

• 2.3.2 Examples of use of the interfaces

2.4 New UIQ containers

• 2.4.1 Which container classes to use

• 2.4.2 Control Stand-in and Container Pop-out

  • 2.4.2.1 Closing

  • 2.4.2.2 Manually using and creating the CqikControlStandIn

2.5 New UIQ view classes

• 2.5.1 Overview

• 2.5.2 Navigation and Focus

  • 2.5.2.1 OfferKeyEventL

  • 2.5.2.2 Initial focus

• 2.5.3 Navigation between views

  • 2.5.3.1 Back links

  • 2.5.3.2 Saving data

  • 2.5.3.3 Single task navigation

  • 2.5.3.4 Using multiple applications to complete a task

  • 2.5.3.5 Summary

• 2.5.4 Overview

• 2.5.5 UI configurations

• 2.5.6 The Application Title Bar

  • 2.5.6.1 The View Context Bar

• 2.5.7 UI configurations

  • 2.5.7.1 To control which commands get placed in the button bar

• 2.5.8 Dynamically destructed / reconstructed view contents

• 2.5.9 Quick guide for creating a view

2.6 New UIQ View-dialogs

• 2.6.1 Differences between CEikDialog and CQikViewDialog

• 2.6.2 Event order

• 2.6.3 CQikViewDialogs as Views

• 2.6.4 Sleeping CQikViewDialogs

• 2.6.5 Command Handling

3 Abstract commands

3.1 Introduction to commands

• 3.1.1 Active objects in applications

3.2 Relationship to MIDP

3.3 The Command pattern

• 3.3.1 Clients

• 3.3.2 Receiver

• 3.3.3 Client - Receiver example

3.4 Commands in the user interface

• 3.4.1 Placement

• 3.4.2 Presentation

• 3.4.3 Controlling command state, for example, dimming

  • 3.4.3.1 SetAvailable

  • 3.4.3.2 Propagation of states in cascaded commands

  • 3.4.3.3 When many commands are affected by a state change in your application

  • 3.4.3.4 When different state variables are needed to determine state of a command

  • 3.4.3.5 Command grouping

• 3.4.4 Defining commands

• 3.4.5 Command Flags

  • 3.4.5.1 State flags

  • 3.4.5.2 Command Processing Framework (CPF) flags

3.5 Loading command lists

• 3.5.1 Loading command lists from resource

• 3.5.2 Loading command lists from code

• 3.5.3 Custom pop-out controls implementing the Client role

• 3.5.4 DynInitOrDeleteCommandL

• 3.5.5 Eik Dialogs

  • 3.5.5.1 General

  • 3.5.5.2 Interaction style menu

  • 3.5.5.3 Dialog CPF functions

3.6 Commands from different sources

• 3.6.1 Commands from different sources combined into one command list

• 3.6.2 Commands from the focused control replace the current command list

3.7 Algorithm for distribution of commands

• 3.7.1 Principles of the algorithm

• 3.7.2 High level explanation of the algorithm

3.8 Examples of how to achieve standard presentations

• 3.8.1 Softkey style

• 3.8.2 Resources for Softkey style

• 3.8.3 Softkey style

• 3.8.4 Resources for Softkey style

• 3.8.5 Softkey style

• 3.8.6 Resources for Softkey style

• 3.8.7 Softkey style

• 3.8.8 Resources for Softkey style

• 3.8.9 Softkey style

• 3.1.10 Resources for Softkey style

• 3.8.11 Softkey style

• 3.8.12 Resources for Softkey style

• 3.8.13 Softkey style

• 3.8.14 Resources for Softkey style

• 3.8.15 Softkey style

• 3.8.16 Resources for Softkey style

• 3.8.17 Putting a command in a component control’s command list

3.9 Category commands

3.10 Invokers - Command operators

4 Managed Layout

4.1 Building blocks

• 4.1.1 Building blocks and layout managers

• 4.1.2 System building blocks

  • 4.1.2.1 Create system building block programmatically

  • 4.1.2.2 Create system building block from resource file

• 4.1.3 Custom building blocks

• 4.1.4 Custom controls

4.2 Layout managers

• 4.2.1 Usage

• 4.2.2 Layout data

4.3 Row-based views

• 4.3.1 What is a row?

• 4.3.2 How it works

• 4.3.2 Rows and layout managers

4.4 Resource driven layout

• 4.4.1 Views

• 4.4.2 Control provider

  • 4.4.2.1 Control collection

  • 4.4.2.2 Control factories

• 4.4.3 Containers

• 4.4.4 Layout managers

• 4.4.5 Building blocks

• 4.4.6 Views with dynamically created controls

4.5 List Box

5 UI configurations

5.1 Support for different UI configurations

• 5.1.1 What are UI configuration parameters

  • 5.1.1.1 A Device with several UI configurations

  • 5.1.1.2 An Application with several UI configurations

• 5.1.2 Design and design decisions

  • 5.1.2.1 General

  • 5.1.2.2 UI configuration selection

  • 5.1.2.3 Resource file

• 5.1.3 Implementation details

  • 5.1.3.1 View support functionality

  • 5.1.3.2 Dialog support functionality

  • 5.1.3.3 Observing or changing UI configuration

  • 5.1.3.4 Boot emulator in a specific UI configuration

  • 5.1.3.5 View activation

6 Skins

6.1 Control drawing with skins

7 Tool chain