Biblioteca Dialogs

.html ›› .html ››
Parent Previous Next

Biblioteca Dialogs

A biblioteca dialogs provê funções para exibir mensagens e interagir com o usuário através de diálogos.

Todas as funções estão contidas na table/variável "Dialogs" da unidade "dialogs.lua".


Exemplo de uso:

-- Primeiro, é necessário usar a unidade "dialogs.lua"
require("dialogs.lua");   

-- Agora é possível acessar as funções da biblioteca
Dialogs.FUNCAO_DA_BIBLIOTECA(Parametro1, Parametro2, ...);



Funções da biblioteca Dialogs


function Dialogs.asyncSelectTalemarkColor([initialColor])


Shows a popup allowing the user to select a color suitable for Talemark texts.


Arguments:

       

Return: 


Remarks: 


Example:

local promise = Dialogs.asyncSelectTalemarkColor(12);       

local r, color = pawait(promise);

 

if r then

    showMessage("The selected color is " .. tostring(color));

else

    showMessage("The operation failed or the user canceled the popup");

end;   



function Dialogs.showMessage(msg [, callback])
ou
function showMessage(msg [, callback])


Exibe uma mensagem de informação para o usuário  (um simples diálogo com o botão "OK").


Parâmetros:

       

Retorno: 
       Não retorna nenhum valor.


Observações: 



function Dialogs.alert(msg [, callback])
ou
function alert(msg [, callback])


Exibe uma mensagem de alerta para o usuário  (um simples diálogo com ícone de alerta e botão "OK").


Parâmetros:


Retorno: 
       Não retorna nenhum valor.


Observações: 


function Dialogs.showErrorMessage(msg [, callback])


Displays an error message to the user (a simple dialog with the "OK" button).


Parâmetros:

       

Return: 
       Does not return any value.


Remarks: 



function Dialogs.asyncOpenFile(prompt[, accept [, multiple]])


Exibe um diálogo para que o usuário escolha um ou mais arquivos do seu computador/dispositivo para abrir. 


Parâmetros:


Retorno:


Observações:



Exemplos:

local promise = Dialogs.asyncOpenFile("Selecione os arquivos", ".txt, .html", true);

 

promise:thenDo(

    function(files)     

        for i = 1, #files, 1 do             

            local file = files[i];

            -- file.name possui o nome do arquivo

            -- file.stream possui o objeto stream do conteúdo

        end;

    end);


local promise = Dialogs.asyncOpenFile("Selecione o arquivo de imagem", "image/*");

 

promise:thenDo(

    function(files)

        local file = files[1];

        -- file.name possui o nome do arquivo

        -- file.stream possui o objeto stream do conteúdo      

    end);


function Dialogs.confirmOkCancel(question [, callback])


Exibe uma informação na interface com os botões OK e CANCEL, permitindo o usuário optar por continuar ou por cancelar alguma ação.


Parâmetros:


Retorno: 
       Não retorna nenhum valor.


Observações: 


Exemplo:

Dialogs.confirmOkCancel("Continuar irá acontecer X coisa",
        function (confirmado)
                if confirmado then
                        -- usuario escolheu OK
                else
                        -- usuário escolheu CANCEL
                end;
        end);




function Dialogs.confirmYesNo(question [, callback])


Exibe uma informação na interface com os botões YES e NO, permitindo o usuário responder "sim" ou "não" a alguma pergunta.


Parâmetros:


Retorno: 
       Não retorna nenhum valor.


Observações: 


Exemplo:

Dialogs.confirmYesNo("Deseja realmente apagar este item?",
        function (confirmado)
                if confirmado then
                        -- usuario escolheu SIM
                else
                        -- usuário escolheu NAO
                end;
        end);




function Dialogs.showMessageDlg(message, dialogType, dialogButtons [, callback])


Exibe um diálogo customizado pelo programador na interface.


Parâmetros:


Retorno: 
       Não retorna nenhum valor.


Observações: 


Exemplo:


Dialogs.showMessageDlg("O que fazer?", dialogs.DT_WARNING,
                       {dialogs.DB_ABORT, dialogs.DB_IGNORE, dialogs.DB_RETRY},                                                                       function (escolha)
                           if escolha == dialogs.DB_ABORT then
                               -- usuario escolheu ABORT
                           elseif escolha == dialogs.DB_IGNORE then
                               -- usuário escolheu IGNORE
                           elseif escolha == dialogs.DB_RETRY then
                              -- usuário escolheu RETRY                                                     
                           end;
                        end);




function Dialogs.inputQuery(caption, prompt[, initialValue [, confirmCallback [, cancelCallback, [, allowEmptyString]]]])


Exibe um diálogo para que o usuário preencha alguma informação.


Parâmetros:


Retorno: 
       Não retorna nenhum valor.


Observações: 



Exemplo:


Dialogs.inputQuery("Cadastro", "Informe Seu Nome", "",
        function (valorPreenchido)
                showMessage("O usuario preencheu: " .. valorPreenchido);
        end,       

        function()
                showMessage("O usuário cancelou");
        end);




function Dialogs.openFile(prompt[, accept [, multiple [, callback [, cancelCallback]]]])


Exibe um diálogo para que o usuário escolha um ou mais arquivos do seu computador/dispositivo para abrir. 


Parâmetros:


Observações:



Exemplos:

Dialogs.openFile("Selecione os arquivos", ".txt, .html", true,
        function(arquivos)
                for i = 1, #arquivos, 1 do
                        local arq = arquivos[i];
                        -- arq.name possui o nome do arquivo
                        -- arq.stream possui o objeto stream do conteúdo
                end;
        end);


Dialogs.openFile("Selecione o arquivo de imagem", "image/*", false,
        function(arquivos)
                local arq = arquivos[1];
                -- arq.name possui o nome do arquivo
                -- arq.stream possui o objeto stream do conteúdo              
        end);




function Dialogs.saveFile(prompt, stream, [suggestedFileName [, mimeType [, callback [, cancelCallback]]]])


Exibe um diálogo para que o usuário possa salvar um arquivo em seu dispositivo.


Parâmetros


Alerta:


Observações:




function Dialogs.selectImageURL(defaultURL, [, callback [, cancelCallback]])


Exibe um diálogo para que o usuário possa escolher uma URL de uma imagem.


Parâmetros



Observações:


Exemplo:

Dialogs.selectImageURL("http://www.google.com/imagem_sugerida.png",

    function(url)

        showMessage("Imagem selecionada: " .. url);

    end,

   

    function()

        showMessage("O usuário cancelou a janela");

    end);




function Dialogs.choose(prompt, options, callback [, defaultOptionIndex, shortCircuit])


Exibe um diálogo para que o usuário possa escolher uma opção dentre uma lista de opções.


Parâmetros



Observações:


Exemplo:

Dialogs.choose("Selecione uma das opções", {"Opção 1", "Opção 2", "Opção 3"},

               function(selected, selectedIndex, selectedText)

                  if selected then

                    showMessage("O usuário selecionou índice " .. tostring(selectedIndex) .. ": " .. selectedText);

                  else

                    showMessage("O usuário cancelou");

                  end;

               end)



function Dialogs.chooseMultiple(prompt, options, callback)


Exibe um diálogo para que o usuário possa escolher uma ou mais opções dentre uma lista de opções.


Parâmetros



Observações:


Exemplo:

Dialogs.chooseMultiple("Selecione uma ou mais opções", {"Opção 1", "Opção 2", "Opção 3"},

               function(selected, selectedIndexes, selectedTexts)

                  if selected then

                    showMessage("O usuário selecionou os índices " ..

                                tableToStr(selectedIndexes) .. ": " ..

                                tableToStr(selectedTexts));

                  else

                    showMessage("O usuário cancelou");

                  end;

               end)

Created with the Personal Edition of HelpNDoc: Effortlessly create a professional-quality documentation website with HelpNDoc