System Dialogs
 

 < Home   < Developers   < Development Support   < Documentation

19 System Dialogs


 Table of Contents  |  < Previous  |  Next >  |  Index
   
   

Title -
Palm OS® Programmer's API Reference

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

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

None.

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, vol. I

SysFatalAlert

Purpose

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

Prototype

UInt16 SysFatalAlert (const Char *msg)

Parameters

msgMessage 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.