Versões comparadas

Versão antiga 63

changes.mady.by.user Pitty

Gravado em

comparado com

Nova versão Atual

changes.mady.by.user Pitty

Gravado em

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.

...

UI Expand
titleCriar um botão

Para criar um botão você precisa adicionar a chave executar no manifesto. Esta chave é uma lista JSON que pode ter um ou mais comandos. Cada comando registrado no manifesto é executado quando a extensão é instalada/atualizada nos terminais, utilizando os parâmetros definidos na chave parametros. (informação) Você pode criar comando próprios para serem utilizados por sua extensão.

O comando para criar um botão é o comando_launcher, conforme exemplo abaixo. Você deve incluir o parâmetro "-tipo": "inserir_botao" para que o comando entenda que deve registrar um botão no Launcher. Os outros parâmetros determinam o formato e comportamento do botão e o que ele fará quando pressionado. Repare que toda chave informada em parametros é precedida do caracter - (hífen) e isso é obrigatório. (informação) Para mais detalhes sobre como criar comandos para tarefas personalizadas consulte a página Comando.

Bloco de código
languagejs
themeMidnight
titlemanifesto.server
linenumberstrue
{
  ...
  ...
  ...
  "dependencias":{
    "Launcher":"4.0.*"
  },
  "executar": [
    {
      "comando": "comando_launcher",
      "parametros": {
        "-tipo": "inserir_botao",
        "-id": "NNNNNNNN-NNNN-NNNN-NNNN-NNNNNNNNNNNN",
        "-tamanho": "G",
        "-cor": 5597999,
        "-titulo": "Linha 1\\nLinha 2",
        "-acao": "%NCRColibri%\\plugins\\extensao\\extensao.exe",
        "-diretorio": "%NCRColibri%\\plugins\\extensao\\",
        "-imagem": "In Transit-48.png",
        "-atalho": "",
        "-aguarda_execucao": false,
        "-verifica_permissao": true,
        "-fonte_escura": false,
        "-admin": false,
        "-parametros": null,
        "-produto": "POS" 
      }
    }
  ],
  ...
  ...
  ...
}
Aura - Panel
tab1
styles{"header":{"icon":{"size":18,"name":"faLightbulb","color":"#53794f"}},"headline":{"text":{"text":"NotasDicas importantes","fontSize":14,"color":"#53794f","textAlign":"left","fontWeight":"bold"},"border":{"color":"#86CA81","style":"solid","top":false,"right":false,"bottom":true,"left":false,"width":1}},"base":{"backgroundColor":{"color":"#DAF7D9"},"borderRadius":{"radius":4},"border":{"width":10,"color":"#86CA81","top":false,"right":false,"bottom":false,"left":true,"style":"solid"},"size":{"width":600}},"body":{"text":{"color":"#53794F","fontSize":14,"fontWeight":"normal","textAlign":"left"}}}
body<p><br /></p>
  • Adicione dependência ao Launcher 4.0*
    O manifesto deve obrigatoriamente indicar dependência do Launcher 4.0 para que funcione. Versões anteriores do Launcher não suportam a criação de botões pelo manifesto.
  • Remova script antigos de criação de botões
    A criação de botões via script (como era nas versões anteriores do Launcher) deixa de funcionar e o script deve ser removido da extensão. Se o script não for removido a atualização da extensão aborta com erro.
  • Utilize a macro %NCRColibri%
    Sempre utilize a macro %NCRColibri% ao definir um caminho relativo à pasta de instalação do sistema, pois o Colibri pode ser instalado em qualquer drive fixo da máquina e se você fixar o caminho em C:\NCR Solution o comando não funcionará.
UI Expand
titleApagar um botão

Para apagar um botão você precisa adicionar a chave executar no manifesto. Esta chave é uma lista JSON que pode ter um ou mais comandos. Cada comando registrado no manifesto é executado quando a extensão é instalada/atualizada nos terminais, utilizando os parâmetros definidos na chave parametros. (informação) Você pode criar comando próprios para serem utilizados por sua extensão.

O comando para apagar um botão é o comando_launcher, conforme exemplo abaixo. Você deve incluir o parâmetro "-tipo": "apagar_botao" para que o comando entenda que deve apagar um botão do Launcher. O  único parâmetro necessário é o identificador único (UUID) do botão.

Bloco de código
languagejs
themeMidnight
titlemanifesto.server
linenumberstrue
{
  ...
  "dependencias":{
    "Launcher":"4.7.6.*"
  },
  "executar": [
    {
      "comando": "comando_launcher",
      "parametros": {
        "-tipo": "apagar_botao",
        "-id": "NNNNNNNN-NNNN-NNNN-NNNN-NNNNNNNNNNNN"
      }
    }
  ],
  ...
}
Aura - Panel
tab1
styles{"header":{"icon":{"size":18,"name":"faLightbulb","color":"#53794f"}},"headline":{"text":{"text":"Dicas importantes","fontSize":14,"color":"#53794f","textAlign":"left","fontWeight":"bold"},"border":{"color":"#86CA81","style":"solid","top":false,"right":false,"bottom":true,"left":false,"width":1}},"base":{"backgroundColor":{"color":"#DAF7D9"},"borderRadius":{"radius":4},"border":{"width":10,"color":"#86CA81","top":false,"right":false,"bottom":false,"left":true,"style":"solid"},"size":{"width":600}},"body":{"text":{"color":"#53794F","fontSize":14,"fontWeight":"normal","textAlign":"left"}}}
body<p><br /></p>
  • Adicione dependência ao Launcher 4.7.6.*
    O manifesto deve obrigatoriamente indicar dependência do Launcher 4.7.6 para que funcione. Versões anteriores do Launcher não suportam a exclusão de botões pelo manifesto.
UI Expand
titleDefinir a cor do botão

Você pode definir uma cor diferente para seu botão informando um valor decimal na chave "-cor" do dicionário de parâmetros. 

Para aplicações Windows, os bytes das cores são representados na ordem BGR ao invés de RGB, como é comum na Web. Então, para ter a cor correta no botão você deve usar um hexadecimal no formato #BBGGRR.

Para calcular o valor decimal da cor, siga os passos abaixo:

  1. Obtenha o valor RGB hexadecimal da cor que você pretende utilizar. Por exemplo, #FF8D48. 

  2. Inverta a posição de RGB para BGR assim você obtém o valor #488DFF.
  3. Converta o número em hexa 0x488DFF para decimal. Esse valor decimal (4.754.943) é o que você deve colocar como valor da chave "-cor". Para o valor deste exemplo a chave fica assim: "-cor": "4754943"

...