Name
hw_EasyRequest -- pop up a system requester (V5.0)
Synopsis
int r = hw_EasyRequest(STRPTR title, STRPTR body, STRPTR gadgets,
            struct hwTagList *tags);
Function
This function will show a system requester, also known as a message box. You have to pass title and body text for the requester as well as a string containing the name of at least one button to show in the requester. If you want to have multiple buttons, you have to separate them by a vertical bar character, e.g. "OK|Cancel".

hw_EasyRequest() will return the id of the button that has been pressed. The right-most button always has the id 0. If there is only one button, it will also have the id 0. The ids of the other buttons are counted from left to right starting at 1. This arrangement has been chosen so that in case there are two buttons like "OK|Cancel" or "Yes|No", the affirmative button's id will correspond to True whereas the negative response button's id will correspond to False.

Designer compatibility
Unsupported

Inputs
title
string to show in the requester's title
body
body text for the requester
gadgets
string containing the name of at least one button to show in the requester
tags
reserved for future use; pass NULL
Results
r
id of the button pressed by the user
Show TOC