From 5331bf0d78db7bba647532a47ed1c9df5856b99a Mon Sep 17 00:00:00 2001 From: Pedro de Oliveira Guedes Date: Thu, 30 Dec 2021 13:54:34 -0300 Subject: [PATCH] Dialog methods improvements. --- api/wingui/cli.py | 178 ++++++++++++++++++++++++++++++---------------- 1 file changed, 117 insertions(+), 61 deletions(-) diff --git a/api/wingui/cli.py b/api/wingui/cli.py index c52a887..cbba2b4 100644 --- a/api/wingui/cli.py +++ b/api/wingui/cli.py @@ -521,188 +521,244 @@ class Wingui: # Funções Dialog def dialog_color(self, t: str = "Selecione Cor", d: str = "BEBEBE") -> bool: """ - Apresenta dialogo para que usuario escolha uma cor - Params: + ## Dialog Color + Apresenta uma janela de diálogo para que o usuário selecione uma cor. + + --- + #### Parâmetros: - t: Titulo - d: Cor padrao - Retorna: - Dict + + --- + #### Retorna: + -> Dicionário cujas chaves são "R", "G", "B" e "A" e os valores são os valores RGBA específicos da cor para cada uma das chaves. """ - return self.__requestget__(f'/ipc/wingui/dialog/color?t={urllib.parse.quote(t, "")}&d={urllib.parse.quote(d, "")}') + + t = urllib.parse.quote(t, "") + d = urllib.parse.quote(d, "") + return self.__requestget__(f'/ipc/wingui/dialog/color?t={t}&d={d}') def dialog_date(self, t: str = "Selecione Data", m: str = "", d="", f="") -> str: """ - Apresenta dialogo para que usuario escolha uma Data - Params: - - t: Titulo + ## Dialog Date + Apresenta uma janela de diálogo para que o usuário selecione uma data. + + --- + #### Parâmetros: + - t: Título - m: Mensagem de texto - - d: Data Padrao (se vazio = agora) + - d: Data Padrao (se vazio = hoje) - f: formato para parse - Retorna: - Dict + + --- + #### Retorna: + -> String contendo a data selecionada. Ex: 2021-12-15T00:00:00Z """ - return self.__requestget__(f'/ipc/wingui/dialog/date?t={urllib.parse.quote(t, "")}&m={urllib.parse.quote(m, "")}&d={urllib.parse.quote(d, "")}&f={urllib.parse.quote(f, "")}') + + f = urllib.parse.quote(f, "") + d = urllib.parse.quote(d, "") + m = urllib.parse.quote(m, "") + t = urllib.parse.quote(t, "") + return self.__requestget__(f'/ipc/wingui/dialog/date?t={t}&m={m}&d={d}&f={f}') def dialog_entry(self, t: str = "Favor inserir", m: str = "Valor", d: str = "Valor") -> str: """ ## Dialog Entry - ##### Apresenta dialog para entrada de texto curto + Apresenta uma janela de diálogo para entrada de um texto curto. + --- - Params: + #### Parâmetros: - t: Titulo - m: Mensagem de texto - d: valor padrao - --- - Retorna: + --- + #### Retorna: -> String digitada. """ - return self.__requestget__(f'/ipc/wingui/dialog/entry?t={urllib.parse.quote(t, "")}&m={urllib.parse.quote(m, "")}&d={urllib.parse.quote(d, "")}') + + t = urllib.parse.quote(t, "") + m = urllib.parse.quote(m, "") + d = urllib.parse.quote(d, "") + return self.__requestget__(f'/ipc/wingui/dialog/entry?t={t}&m={m}&d={d}') def dialog_error(self, t: str = "Erro", m: str = "Houve um erro") -> bool: """ ## Dialog Error - ##### Apresenta dialog c msg de erro + Apresenta uma janela de dialog exibindo um erro definido pelo programador. + --- - Params: + #### Parâmetros: - t: Titulo - m: Mensagem de texto - --- - Retorna: - -> "ok" + --- + #### Retorna: + -> "ok" """ - return self.__requestget__(f'/ipc/wingui/dialog/error?t={urllib.parse.quote(t, "")}&m={urllib.parse.quote(m, "")}') + + t = urllib.parse.quote(t, "") + m = urllib.parse.quote(m, "") + return self.__requestget__(f'/ipc/wingui/dialog/error?t={t}&m={m}') def dialog_file(self, t: str = "Selecionar arquivo", f: str = ".", d: str = "false") -> str: """ ## Dialog File - Apresenta dialog para selecionar arquivo + Apresenta uma janela de seleção de arquivos ou pastas. --- - Params: + #### Parâmetros: - t: Titulo da janela. - f: Diretório inicial ("." por padrão) - d: true -> Seleciona diretórios; false -> Seleciona arquivos - --- - Retorna: + --- + #### Retorna: -> Caminho absoluto do arquivo selecionado """ - return self.__requestget__(f'/ipc/wingui/dialog/file?t={urllib.parse.quote(t, "")}&f={urllib.parse.quote(f, "")}&d={urllib.parse.quote(d, "")}') + + t = urllib.parse.quote(t, "") + f = urllib.parse.quote(f, "") + d = urllib.parse.quote(d, "") + return self.__requestget__(f'/ipc/wingui/dialog/file?t={t}&f={f}&d={d}') def dialog_file_multi(self, t: str = "Selecionar arquivos", f: str = ".") -> List[str]: """ ## Dialog File Multi - Apresenta dialog para selecionar arquivo + Apresenta uma janela de seleção de múltiplos arquivos. --- - Params: + #### Parâmetros: - t: Titulo da janela. - f: Diretório inicial ("." por padrão) - --- - Retorna: + --- + #### Retorna: -> Lista com os caminhos absolutos dos arquivos selecionados. """ - return self.__requestget__(f'/ipc/wingui/dialog/filemulti?t={urllib.parse.quote(t, "")}&f={urllib.parse.quote(f, "")}') + + t = urllib.parse.quote(t, "") + f = urllib.parse.quote(f, "") + return self.__requestget__(f'/ipc/wingui/dialog/filemulti?t={t}&f={f}') def dialog_info(self, t: str = "Info", m: str = "Info Msg") -> bool: """ ## Dialog Info - Apresenta dialog msg + Apresenta uma janela de diálogo exibindo uma informação definida pelo programador. --- - Params: + #### Parâmetros: - t: Titulo da janela - m: Mensagem exibida - --- - Retorna: + --- + #### Retorna: -> "ok" """ - return self.__requestget__(f'/ipc/wingui/dialog/info?t={urllib.parse.quote(t, "")}&m={urllib.parse.quote(m, "")}') + + t = urllib.parse.quote(t, "") + m = urllib.parse.quote(m, "") + return self.__requestget__(f'/ipc/wingui/dialog/info?t={t}&m={m}') def dialog_list(self, t: str = "Selecionar", m: str = "Selecione uma entrada", f: List[str] = []) -> str: """ ## Dialog List - Apresenta dialog com uma lista. Permite o usuário selecionar um dos itens. + Apresenta uma janela de diálogo com uma lista. Permite o usuário selecionar um dos itens. --- - Params: + #### Parâmetros: - t: Titulo da janela - m: Mensagem da janela - f: Opções para escolher - --- - Retorna: + --- + #### Retorna: -> Opção escolhida """ - return self.__requestget__(f'/ipc/wingui/dialog/list?t={urllib.parse.quote(t, "")}&m={urllib.parse.quote(m, "")}&f={urllib.parse.quote(",".join(f), "")}') + + t = urllib.parse.quote(t, "") + m = urllib.parse.quote(m, "") + f = urllib.parse.quote(",".join(f), "") + return self.__requestget__(f'/ipc/wingui/dialog/list?t={t}&m={m}&f={f}') def dialog_listmulti(self, t: str = "Selecionar", m: str = "Selecione uma entrada", f: List[str] = []) -> List[str]: """ ## Dialog List Multi - Apresenta dialog com uma lista. Permite o usuário selecionar os itens que quiser. + Apresenta uma janela de diálogo. Permite o usuário selecionar todos os itens que quiser. --- - Params: + #### Parâmetros: - t: Titulo da janela - m: Mensagem da janela - f: Opções para escolher - --- - Retorna: + --- + #### Retorna: -> Lista com as opções escolhidas """ - return self.__requestget__(f'/ipc/wingui/dialog/listmulti?t={urllib.parse.quote(t, "")}&m={urllib.parse.quote(m, "")}&f={urllib.parse.quote(",".join(f), "")}') + + t = urllib.parse.quote(t, "") + m = urllib.parse.quote(m, "") + f = urllib.parse.quote(",".join(f), "") + return self.__requestget__(f'/ipc/wingui/dialog/listmulti?t={t}&m={m}&f={f}') def dialog_password(self, t: str = "Entrar com Senha", m: str = "Favor fornecer sua senha") -> str: """ ## Dialog Password - Apresenta dialog para entrada de senha/informações confidenciais. + Apresenta uma janela de diálogo para entrada de senha/informações confidenciais. --- - Params: + #### Parâmetros: - t: Titulo da janela - m: Mensagem de texto exibida + --- - Retorna: + #### Retorna: -> Texto digitado. """ - return self.__requestget__(f'/ipc/wingui/dialog/password?t={urllib.parse.quote(t, "")}&m={urllib.parse.quote(m, "")}') + + t = urllib.parse.quote(t, "") + m = urllib.parse.quote(m, "") + return self.__requestget__(f'/ipc/wingui/dialog/password?t={t}&m={m}') def dialog_question(self, t: str = "Question", m: str = "Question Msg") -> bool: """ ## Dialog Question - Apresenta dialog c pergunta sim/nao + Apresenta uma janela de diálogo com uma pergunta, que apresenta as opções sim/não --- - Params: + #### Parâmetros: - t: Titulo da janela - m: Mensagem exibida. + --- - Retorna: + #### Retorna: - True: Caso clique em sim - False: Caso clique em não """ - return self.__requestget__(f'/ipc/wingui/dialog/question?t={urllib.parse.quote(t, "")}&m={urllib.parse.quote(m, "")}') + + t = urllib.parse.quote(t, "") + m = urllib.parse.quote(m, "") + return self.__requestget__(f'/ipc/wingui/dialog/question?t={t}&m={m}') def dialog_warn(self, t: str = "Warn", m: str = "Warn") -> bool: """ ## Dialog Warn - Apresenta dialog msg + Apresenta uma janela de diálogo exibindo uma mensagem de aviso. --- - Params: + #### Parâmetros: - t: Titulo da janela - m: Mensagem exibida - --- - Retorna: + --- + #### Retorna: -> "ok" """ - return self.__requestget__(f'/ipc/wingui/dialog/warn?t={urllib.parse.quote(t, "")}&m={urllib.parse.quote(m, "")}') + + t = urllib.parse.quote(t, "") + m = urllib.parse.quote(m, "") + return self.__requestget__(f'/ipc/wingui/dialog/warn?t={t}&m={m}') # def dialog_yesno(self, t: str, m: str) -> bool: # """