3.2.27. prompt_list

Displays a dialog containing message text, a list of choices, and Ok, Cancel and Help buttons.

Note

This macro is not available in the headless debugger.

Syntax

int prompt_list (message, buff)
char *message;
char *buff;

where:

message

The message text that appears at the top of the dialog.

buff

Initially, the list of choices that appear for selection in the dialog, separated by \n.

Description

This macro displays a dialog containing message text and a list of choices.

Return value

int

One of the following:

0

Cancel

n

Index number of the chosen list item. The first item in the list has an index of 1.

Rules

None

Example

This example shows how to use prompt_list on the command line:

> add char buff[15]
> strcpy(buff, "one\ntwo\nthree")
> ce prompt_list("Choose one:", buff)
  Result is: 3  0x00000003

See Also

Copyright © 2002-2009 ARM Limited. All rights reserved.ARM DUI 0175K
Non-Confidential