ShowPlayerDialog ES
From SA-MP Wiki
ShowPlayerDialog
| ¡Este/a fue agregado/a en SA-MP 0.3function y no funcionará en versiones anteriores! |
Descripción:
Muestra a un jugador un sincrónico (solo uno a la vez) cuadro de diálogo.
(playerid, dialogid, style, caption[], info[], button1[], button2[])
| playerid | La ID del jugador a mostrar el diálogo. |
| dialogid | Una ID para asignar a este diálogo, así las respuestas pueden ser procesadas (en OnDialogResponse). La ID máxima es 32767. Usando un valor negativo cerrará cualquier cuadro de diálogo. |
| style | El estilo del diálogo. |
| caption[] | El título en la parte superior del cuadro de diálogo. La longitud del título no debe exceder los 64 caracteres. |
| info[] | El texto a mostrar en el cuadro principal. Usa \n para saltar a la línea de abajo y \t para tabular. |
| button1[] | El texto en el botón izquierdo |
| button2[] | El texto en el botón derecho. Déjalo en blanco ( "" ) si no quieres que se muestre. |
Retornos/Devoluciones:
- 1: Función ejecutada con éxito.
- 0: Función no se pudo ejecutar. Ésto significa que el jugador no está conectado.
// Definir las IDs de los diálogos usando Enum: enum { DIALOG_LOGIN, DIALOG_WELCOME, DIALOG_WEAPONS } // Alternativo, usando macros: #define DIALOG_LOGIN 1 #define DIALOG_WELCOME 2 #define DIALOG_WEAPONS 3 // Se recomiendan los Enums, así usted no tiene que llevar un registro de las IDs usadas. Sin embargo, los Enums usan memoria para guardar las IDs, y los Macros son procesados en el 'pre-procesador' (compilador). // Ejemplo para DIALOG_STYLE_MSGBOX: ShowPlayerDialog(playerid, DIALOG_WELCOME, DIALOG_STYLE_MSGBOX, "Noticias!", "Tú estás conectado al servidor", "Cerrar", ""); // Example para DIALOG_STYLE_INPUT: ShowPlayerDialog(playerid,DIALOG_LOGIN, DIALOG_STYLE_INPUT, "Ingresar", "Pon tu contraseña abajo:", "Ingresar", "Cancelar"); // Ejemplo para DIALOG_STYLE_LIST: ShowPlayerDialog(playerid, DIALOG_WEAPONS, DIALOG_STYLE_LIST, "Armas", "AK47\nM4\nRifle Sniper", "Comprar", "Cancelar"); // Ejemplo para DIALOG_STYLE_PASSWORD ShowPlayerDialog(playerid, DIALOG_LOGIN, DIALOG_STYLE_PASSWORD, "Ingresar", "Pon tu contraseña abajo:", "Ingresar", "Cancelar");
Nota | Se recomienda usar las enumeraciones (enum) o macros (#define) para determinar qué ID tendrán los diálogos, y evitar confusiones en el futuro. Usted nunca debe usar números literales - podría confundirse. |
| Tips
|
|
Funciones relacionadas
Las siguientes funciones pueden ser útiles, ya que éstas están relacionadas con esta función de alguna u otra manera.
- TextDrawShowForPlayer: Show a textdraw for a certain player.
Callbacks relacionadas
Las siguientes callbacks pueden ser útiles, ya que éstas están relacionadas con esta función de alguna u otra manera.
- OnDialogResponse: Called when a player responds to a dialog.
