Button Botão de ação

Este componente exibe um botão na interface para executar uma ação.

Chave	Tipo	Descrição	Obrigatório	Valor padrão	Versão mínima
action	String	Identificador da ação	*	-	-
args	Dicionário	Parâmetros passados à ação	*	-	-
alignment	String	Alinhamento	-	Left	1.2-10

alignment	Descrição
Left	Alinhar à esquerda
Center	Centralizado
Right	Alinhar à direita
Natural	Alinhamento natural
Justified	Justificado

Descrição das ações

Após a conclusão da ação, o valor retornado será salvo no item de configuração deste componente; por isso, defina corretamente as propriedades key e defaults do componente.

Ações action diferentes exigem dicionários de parâmetros args diferentes.

Reload:

Atualiza o XUI e recarrega todas as instâncias XUI em execução. Requer o XXT v1.2-10 ou posterior.

Sem parâmetros e sem valor retornado.

RunCommand:

Executa uma linha de comando chamando system/posix_spawn. Requer o XXT v1.2-10 ou posterior.

Chave	Tipo	Descrição	Obrigatório	Valor padrão	Versão mínima
command	String	Linha de comando a ser executada	*	-	1.2-10

Tipo retornado	Descrição
Inteiro	Valor retornado pela execução da linha de comando, o Exit Status

LaunchScript:

Executa um script de serviço.

Chave	Tipo	Descrição	Obrigatório	Valor padrão	Versão mínima
path	String	Caminho do script de serviço	*	-	-

Sem valor retornado.

OpenURL:

Abre uma URL em um aplicativo de terceiros.

Chave	Tipo	Descrição	Obrigatório	Valor padrão	Versão mínima
url	String	URL a ser aberta	*	-	-

Sem valor retornado.

ScanQRCode:

Abre a câmera para escanear um código QR.

Sem parâmetros.

Tipo retornado	Descrição
String	Resultado da leitura do código QR

SendMail:

Envia um e-mail pelo aplicativo.

Chave	Tipo	Descrição	Obrigatório	Valor padrão	Versão mínima
subject	String	Assunto do e-mail	*	-	-
toRecipients	Array de strings	Array de endereços de e-mail dos destinatários	*	-	-
ccRecipients	Array de strings	Array de endereços em cópia	-	{}	-
bccRecipients	Array de strings	Array de endereços em cópia oculta	-	{}	-
attachments	Array de strings	Array de caminhos dos anexos	-	{}	-

Sem valor retornado.

Null:

Nenhuma ação; normalmente é usado para redefinir um valor de configuração específico e enviar a notificação correspondente ao script. Requer o XXT v1.2-10 ou posterior.

Sem parâmetros e sem valor retornado.

Exemplo

{
    cell = "Button";
    action = "OpenURL:";
    label = "联系 [email protected]";
    args = {
        url = "mailto:[email protected]";
    }
};