[Include] e_dialog

[Dr Editor]

E_Dialog

Há um bom tempo estava desenvolvendo esta include para um projeto pessoal e decidi publicá-la.
Sei que há outra(s) include(s) parecida(s), mas decidi criar a minha própria, pois sempre surgem novas ideias e novas implementações e não gosto de mexer em bibliotecas de terceiros.
A propósito: nunca usei este tipo de biblioteca para gerenciar caixas de diálogo, pois nunca tinha tarabalhado (até então) com a função de diálogos em massa

Por que usar?

• Proteção contra crash
  

1. Informações podem ser facilmente verificadas antes de ser entregues ao jogador
   

• Proteção contra cheat
  

1. Respostas de caixas de diálogo só são possíveis se forem chamadas via server-side
   
2. Caixas de diálogo chamadas via cheat mesmo que abertas não terão efeito de resposta
   

• Mais rápido e organizado
  

1. Caixas de diálogo são identificadas por nome (callback de resposta) e não mais ID
   
2. Problemas com hook ou má verificação na callback OnDialogResponse não é mais problema
   
3. As respostas das caixas de diálogo podem ser criadas próximo ao código que as chamou
   

• Compatibilidade
  

1. Opção de hook para facilitar uso da include substituindo o ID pela callback de resposta
   
   Código:

   #define E_DIALOG_HOOK false
   
   
2. Pode ser usado em conjunto com a função nativa sem interferências com a mesma (apenas não usar o mesmo ID da include)
   
   Código:

   #define E_DIALOG_ID 32760
   
   

• Funcionalidade extendida
  

1. Possibilidade de saber qual caixa de diálogo foi aberta
   
2. Possibilidade de saber quando e qual foi a última caixa de diálogo fechada e o tempo em que ficou aberta
   
3. Possibilidade de saber se o jogador possui uma caixa de diálogo (e_dialog) ativa
   
4. Possibilidade de saber o nome (callback de resposta) da caixa de diálogo (e_dialog) ativa do jogador
   
5. Possibilidade de saber o nome (callback de resposta) da última caixa de diálogo (e_dialog) aberta do jogador
   
6. Possibilidade de abrir a última caixa de diálogo (e_dialog) do jogador sem precisar preencher os dados da caixa novamente
   

Callback's:

Chamada quando o jogador abre uma caixa de diálogo.

Código:

OnOpenPlayerDialog(playerid, response_callback[])

Chamada quando o jogador fecha a última caixa de diálogo informando o tempo em que ela permaneceu aberta.

Código:

OnClosePlayerDialog(playerid, response_callback[], delay)

Funções:

Abre uma nova caixa de diálogo.

Código:

// Hook
ShowPlayerDialog(playerid, const response_callback[], style, const caption[], const info[], const button1[], const button2[])

// Sem hook
ShowDialogForPlayer(playerid, style, const caption[], const info[], const button1[], const button2[], const response_callback[])

Retorna se o jogador possui uma caixa de diálogo (e_dialog) ativa.

Código:

HasPlayerOpenDialog(playerid)

Retorna o nome da callback de resposta da caixa de diálogo (e_dialog) ativa.

Código:

GetPlayerDialogResponseName(playerid)

Retorna o nome da callback de resposta da ultima caixa de diálogo (e_dialog).

Código:

GetPlayerLastDialogResponseName(playerid)

Força a chamada da função "OnClosePlayerDialog" e remove o suporte a respostas da caixa de diálogo aberta.

Código:

ClosePlayerDialog(playerid, bool:blank_dialog = false)

Abre a última caixa de diálogo fechada.

Código:

OpenLastPlayerDialog(playerid)

Uso:

Código:

// Opção sem hook
ShowDialogForPlayer(playerid, DIALOG_STYLE_MSGBOX, "Opções", "Selecione uma opção:", "Sim", "Não", "DialogoOpcaoSimNao");
// Opção com hook
ShowPlayerDialog(playerid, "DialogoOpcaoSimNao", DIALOG_STYLE_MSGBOX, "Opções", "Selecione uma opção:", "Sim", "Não");

forward DialogoOpcaoSimNao(playerid, response, listitem, inputtext[]);
public DialogoOpcaoSimNao(playerid, response, listitem, inputtext[])
{
    
    return true;
}

Download:

e_dialog.inc


Créditos:

Eduardo AC  © 2022

[MarcosBrazz]

Show de Bola, muito útil!

[xbruno1000x]

Muito boa contribuição! +REP