Part I: User Interface

19 System Dialogs

System Dialog Functions

SysAppLauncherDialog

SysFatalAlert

SysGraffitiReferenceDialog

This chapter provides reference material for system dialogs declared in the header files FatalAlert.h, Launcher.h, GraffitiReference.h, and GraffitiUI.h.

System Dialog Functions ^TOP^

SysAppLauncherDialog Function ^TOP^

Purpose

Display the launcher popup, get a choice, ask the system to launch the selected application, clean up, and leave. If there are no applications to launch, nothing happens.

Declared In

Launcher.h

Prototype

void SysAppLauncherDialog()

Parameters

None.

Returns

The system may be asked to launch an application.

Comments

Typically, this routine is called by the system as necessary. Most applications do not need to call this function themselves.

In Palm OS^® version 3.0 and higher the launcher is an application, rather than a popup. This function remains available for compatibility purposes only.

See Also

SysAppLaunch(), the "Application Launcher" section in the Palm OS Programmer's Companion, vol. I

SysFatalAlert Function ^TOP^

Purpose

Display a fatal alert until the user taps a button in the alert.

Declared In

FatalAlert.h

Prototype

UInt16 SysFatalAlert (
   const Char *msg
)

Parameters

msg

Message to display in the dialog.

Returns

The button tapped; first button is zero.

SysGraffitiReferenceDialog Function ^TOP^

Purpose

Pop up the Graffiti^® or Graffiti 2 Reference Dialog.

Declared In

GraffitiReference.h

Prototype

void SysGraffitiReferenceDialog(
   ReferenceType referenceType
)

Parameters

referenceType

Which reference to display. See GraffitiReference.h for more information.

Returns

Nothing returned.