diff --git a/api/wingui/cli.py b/api/wingui/cli.py index 43428f8..c52a887 100644 --- a/api/wingui/cli.py +++ b/api/wingui/cli.py @@ -462,25 +462,61 @@ class Wingui: # Funções KB def kb_tap(self, s: str) -> str: - """Envia uma tecla ou teclas para serem clicadas no componente com foco onde o robo é executado - Em caso de teclas alteradoras, elas devem ser sempre posicionadas apos a tecla alvo. - Dessa forma, para enviar ALT+d, vc envia o string "d,alt". Para enviar C maiusculo, vc utiiliza - "c,shift". """ - return self.__requestget__(f'/ipc/wingui/kb/tap?str={urllib.parse.quote(s, "")}') + ## KB Tap + Envia uma tecla ou teclas para serem clicadas no componente com foco onde o robo é executado. Em caso de teclas alteradoras, elas devem ser sempre posicionadas após a tecla alvo sem espaço entre a vírgula e o texto. + + --- + #### Parâmetros: + - s: Sequência de teclas que se deve apertar. + + --- + #### Retorna: + + --- + + --- + #### Exemplo: + Para enviar ALT+d, você envia o string "d,alt". Para enviar C maiusculo, você utiiliza "c,shift". + """ + str = urllib.parse.quote(s, "") + return self.__requestget__(f'/ipc/wingui/kb/tap?str={str}') def kb_type(self, s: str) -> str: - """Semelhante a tap, mas envia textos completos. - ***ATENCAO*** Esse metodo usa urlencoding, dessa forma caracteres serao codificados para envio. # virará %23 por exemplo. Ao chegar no robo passarão pelo decoding análogo. """ - return self.__requestget__("/ipc/wingui/kb/type?str={}".format(urllib.parse.quote(s, ""))) + ## KB Type + Semelhante a tap, mas envia textos completos. + + --- + #### Parâmetros: + - s: Texto que se quer digitar. + + --- + #### Retorna: + + --- + """ + + str = urllib.parse.quote(s, "") + return self.__requestget__(f"/ipc/wingui/kb/type?str={str}") def kb_toggle(self, s: str) -> str: - """Semelhante a tap, mas envia textos completos. - ***ATENCAO*** Esse metodo usa urlencoding, dessa forma caracteres serao codificados para envio. # virará %23 - por exemplo. Ao chegar no robo passrão pelo decoding análogo. """ - return self.__requestget__("/ipc/wingui/kb/toggle?str={}".format(urllib.parse.quote(s, ""))) + ## KB Toggle + Semelhante a tap, porém mantem a tecla ou o conjunto de teclas pressionado até que elas sejam pressionadas novamente manualmente ou pelo robô. Pode-se utilizar o método kb_tap para interromper o pressionamento por exemplo. + + --- + #### Parâmetros: + - s: Tecla ou sequência de teclas que se deseja pressionar. + + --- + #### Retorna: + + --- + """ + + str = urllib.parse.quote(s, "") + return self.__requestget__(f"/ipc/wingui/kb/toggle?str={str}") # Funções Dialog def dialog_color(self, t: str = "Selecione Cor", d: str = "BEBEBE") -> bool: