MultiLineEdit control  OLEControl control

Chapter 2: System Object Properties, Events, and Functions

NotificationBubble object

The NotificationBubble object adds an icon and text to the navigation bar (notification tray) near the top of the Pocket PC device screen. The icon opens a notification bubble with text in HTML format.

Properties

NotificationBubble property

Datatype

Description

Body

String

HTML formatted text that is the body of the message in the notification bubble.

Caption

String

Text caption (title) for the notification bubble.

Duration

Integer

Length of time in seconds that the notification bubble displays before the system removes the icon and the bubble.

Flags

UnsignedLong

Settings that change the behavior of the notification bubble. Values are:

  • 0 –  (Default) No changes

  • 1 –  Hides initial display of the notification bubble, displaying it only as an icon in the notification tray

  • 2 –  Highlights notification bubble borders and title

  • 16 – Forces the display to turn on for the notification

  • 32 – Forces the notification to be silent and not vibrate regardless of system settings

Values are additive. A value of 1, 3, 17, or 33 overrides the InitiallyIconic property. Values of 16 or greater are valid only for Pocket PC 2003 operating systems.

InitiallyIconic

Boolean

Determines whether the notification bubble is first displayed as an icon in the notification tray. Values are:

  • TRUE – Displays initially as an icon

  • FALSE – (Default) Displays initially as a notification bubble, unless overridden by a Flags property setting

NotificationID

UnsignedLong

Unique identifier number for the notification bubble.

Functions

NotificationBubble function

Datatype returned

Description

Icon

Integer

Specifies the notification icon to display in the notification tray.

Remove

Integer

Removes the notification bubble from the system.

SetMessageSink

Integer

Specifies the object that will receive event notifications from user events having the pbm_command event ID.

Update

Integer

Informs Windows CE that there is a new object or an update to an existing object in the notification tray.





Copyright © 2004. Sybase Inc. All rights reserved. OLEControl control

View this book as PDF