ShowPlayerDialog

From SA-MP Wiki

This function was added in SA-MP 0.3a and will not work in earlier versions!

Shows the player a synchronous (only one at a time) dialog box.

Parameters:

(playerid, dialogid, style, caption[], info[], button1[], button2[])

playerid

The ID of the player to show the dialog to.

dialogid

An ID to assign this dialog to, so responses can be processed. Max dialogid is 32767. Using negative values will close any open dialog.

style

The style of the dialog.

caption[]

The title at the top of the dialog. The length of the caption can not exceed more than 64 characters before it starts to cut off.

info[]

The text to display in the dialog. Use \n to start a new line and \t to tabulate.

button1[]

The text on the left button.

button2[]

The text on the right button. Leave it blank ( "" ) to hide it.

Returns

This function doesn't return a specific value

// Define the dialog IDs either with an enum:
enum
{
    DIALOG_LOGIN,
    DIALOG_WELCOME,
    DIALOG_WEAPONS
}
 
// or with the more common method, defines:
#define DIALOG_LOGIN 1
#define DIALOG_WELCOME 2
#define DIALOG_WEAPONS 3
 
// Enums are recommended, as you don't have to keep track of used IDs. However, enums use memory to store the defines, whereas defines are processed in the 'pre-processor' (compiling) stage.
 
//example for DIALOG_STYLE_MSGBOX
ShowPlayerDialog(playerid, DIALOG_WELCOME, DIALOG_STYLE_MSGBOX, "Notice", "You connected to the server", "Close", "");
 
//example for DIALOG_STYLE_INPUT
ShowPlayerDialog(playerid,DIALOG_LOGIN, DIALOG_STYLE_INPUT, "Login", "Enter your password below:", "Login", "Cancel");
 
//example for DIALOG_STYLE_LIST
ShowPlayerDialog(playerid, DIALOG_WEAPONS, DIALOG_STYLE_LIST, "Weapons", "AK47\nM4\nSniper Rifle", "Option 1", "Option 2");
 
//example for DIALOG_STYLE_PASSWORD
ShowPlayerDialog(playerid, DIALOG_LOGIN, DIALOG_STYLE_PASSWORD, "Login", "Enter your password below:", "Login", "Cancel");