18 System Dialogs

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

SysAppLauncherDialog

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.

Prototype

void SysAppLauncherDialog()

Parameters

Result

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

SysFatalAlert

Purpose

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

Prototype

UInt16 SysFatalAlert (const Char *msg)

Parameters

msg

Message to display in the dialog.

Result

The button tapped; first button is zero.

SysGraffitiReferenceDialog

Purpose

Pop up the Graffiti^® Reference Dialog.

Prototype

void SysGraffitiReferenceDialog (ReferenceType referenceType)

Parameters

referenceType

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

Result

Nothing returned.