sc_btn_disabled("nome_botao", "status")
Assista um video

Esta macro tem o objetivo de habilitar ou desabilitar, dinamicamente, um botão da barra de ferramentas.

Ela possui dois parâmetro obrigatórios:

Parâmetro Valor Descrição
nome_botao

O valor deve ser informado utilizando variáveis ou em formato de string, com aspas duplas ou simples.

Em negrito, segue o exemplo de como o parâmetro deve ser informado:

sc_btn_disabled('update', 'off');

Obs: O nome dos botões devem está todo em minúsculo.

Este parâmetro define o botão que terá sua exibição alterada.

Os nomes dos botões estão disponíveis na tabela abaixo, separado por aplicação.
status

Assim como o nome do campo, o parâmetro aceita apenas string, protegido com aspas simples ou duplas.

Em negrito, segue o exemplo de como o parâmetro deve ser informado:

sc_btn_disabled('update', 'off');

Este parâmetro define se o botão está habilitado, quando definido como on, ou desabilitado se definido como off

Valores aceitos no parâmetro:

  • on - O botão aparece desabilitado;
  • off - O botão aparece habilitado;

Clique aqui e veja exemplos de utilização da macro.

 

Nome dos botões da consulta

Nome do Botão
Descrição
first Navega para o início da consulta.
back Navega para a página anterior.
forward Navega para a página seguinte.
last Navega para a última página.
filter Controla a exbição do botão "Filtro" na grid.
pdf Gera o PDF colorido da consulta.
det_pdf Gera o PDF no detalhe.
pdfbw Gera o PDF preto e branco da consulta.
xls Gera o XLS.
xml Gera o XML.
csv Gera o CSV.
rtf Gera o RTF.
word Gera o Word.
json Gera o JSON.
print Abre a consulta no formato de impressão.
det_print Abre o detalhe no formato de impressão.
summary Controla a exibição do botão "Resumo" na grid.
new Controla a exibição do botão "Novo" possibilitando a inclusão de novos registros. (se a aplicação tiver link para tal, ou se o formulário estiver rodando em iframe da consulta)
insert Controla a exibição do botão "Inserir". (apenas em casos de formulário rodando em iframe da consulta)
update Controla a exibição do botão "Atualizar". (apenas em casos de formulário rodando em iframe da consulta)
delete Controla a exibição do botão "Delete". (apenas em casos de formulário rodando em iframe da consulta)
groupby Controla a exibição do botão "Quebras".
dynsearch Controla a exibição do botão "Filtro dinâmico".
gridsave Controla a exibição do botão "Salvar Grid".
sel_col Botão de selecionar colunas
sort_col Botão de Ordenação

 

 

Nome dos botões das aplicações de Calendário e Formulário

Nome do Botão
Descrição
first Navega para o primeiro registro do formulário.
back Navega para o registro anterior.
forward Navega para o registro seguinte.
last Navega para o último registro formulário.
new Controla a exibição do botão "Novo" em um formulário, usado em off o formulário é iniciado em modo de inclusão.
insert Controla a exibição do botão "Incluir".
update Controla a exibição do botão "Atualizar".
delete Controla a exibição do botão "Excluir".
copy Controla a exibição do botão "Copiar".
dynsearch

Controla a exibição do botão "Filtro dinâmico".
pdf

Gera documento PDF a partir do formulário.
print

Abre o formulário no modo de impressão.

 

Nome dos botões do Controle

Nome do Botão
Descrição
ok Controla a exibição do botão "Ok" em um controle.
exit Controla a exibição do botão "Sair".
facebook Controla a exibição do botão "Facebook".
twitter Controla a exibição do botão "Twitter"
google Controla a exibição do botão "Google+"
paypal Controla a exibição do botão "PayPal"

 

 

Exemplo: Habilitando botão delete apenas para o usuário admin com aspas.

if ( [user_login] == 'admin' ) {

    sc_btn_disabled('delete', 'on');

} else {

    sc_btn_disabled('delete', 'off');

}

 

Exemplo: Utilizando variáveis.

Obs: Podem ser utilizadas variáveis globais ou locais.

if ( [user_login] == 'admin' ) {

    sc_btn_disabled([btn_name], [status]);

} else {

    sc_btn_disabled([btn_name], [status]);

}