Symbian的消息通知服务器

Symbian OS Notification Services

Hamish Willee

Published by the Symbian Developer Network

Version: 1.0a – December 2007

3.1 User::Infoprint ................................................................................................................ 3

3.2 RNotifier::Notify() – default notifier................................................................................. 4

3.3 S60 Global notes ...........................................................................................................6

4 HOW TO WRITE EXTENDED NOTIFIERS ........................................................................7

4.1 Overview ........................................................................................................................ 7

4.2 Who can write Extended Notifiers?................................................................................ 8

4.3 Channels and priorities .................................................................................................. 8

4.4 The Extended Notifier Plug-in Example ......................................................................... 9

4.5 Using a notifier ............................................................................................................. 12

4.6 Writing a notifier ........................................................................................................... 14

6 OTHER USEFUL NOTIFIER DOCUMENTATION............................................................19

7 FURTHER INFORMATION............................................................................................... 20

7.1 Acknowledgements...................................................................................................... 20

7.2 Glossary....................................................................................................................... 20

2

• The second part describes how to extend the notifier framework to support custom notifiers.

documented in section

4.2.

The paper is accompanied by example code that demonstrates how you launch the default

Symbian notifiers, and also how you write and launch a simple custom notifier.

2 Example code

header file containing the notifier UID.

3.

3

3 “Out of the box” Notification Services

The “out of the box” notification services enable both simple event notification and also prompting

N Y

An “InfoPrint” (information print) is a short information-only message which is displayed to the user

for approximately 4 seconds. The message appears over the top of the current application and

ignores user input.

InfoPrints are supported on UIQ. InfoPrints are not supported on S60; they display on the S60

emulator, but they don’t appear when the API is called on any current production phones.

Figure 1 shows an InfoPrint on the UIQ 3 emulator (it would appear similarly on a real phone).

The code to launch the above InfoPrint is very simple:

4

The main limitations to using InfoPrint are:

• Suitable for event notification only, not taking responses

• Not appropriate for multi-platform code (only work on UIQ)

• Messages must be kept very short

The default Notifier is implemented similarly on both UIQ and S60 (figures 2, 3):

• The first line is taken to be a “title”; if you specify more than 25 characters this line will be

• The second line is the notifier dialog “body text”. The body text can be up to about 420

characters – the notifier wraps the text, grows the dialog and adds scrollbars as necessary

• Button 1 is on left, button 2 is on right. Button text is truncated if the text is too long. You

5