sc_btn_label("nome_botao", "nova_label")
Assista um video

Esta macro serve para alterar dinamicamente a label dos botões, sejam eles criados pelo desenvolvedor ou próprios do Scriptcase.

Para isso, é necessário informar dois parâmetros obrigatórios, 'btn_name' e 'new_label'.

Parâmetro Valor Descrição
btn_name

O parâmetro pode ser informado utilizando variáveis(Global ou Local) ou string(Utilizando Aspas Duplas ou simples)

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

sc_btn_label('update', 'Atualizar Registro');

Valores aceitos no parâmetro:

  • String - Protegida por aspas simples ou duplas. Ex.: 'update'
  • Variáveis - Locais ou globais. Ex.: $btn_update

Recebe o nome do botões que terá a label alterada.

Os nomes dos botões, que são automaticamente criados pelo Scriptcase, estão disponíveis abaixo, separado por aplicação.
new_label

O parâmetro pode ser informado utilizando variáveis(Global ou Local) ou string(Utilizando Aspas Duplas ou simples)

sc_btn_label('update', 'Atualizar Registro');

Valores aceitos no parâmetro:

  • String - Protegida por aspas simples ou duplas. Ex.: 'Atualizar Registro'
  • Variáveis - Locais ou globais. Ex.: $new_label
  • Lang - variável lang. Ex.: {lang_btn_label}

Este parâmetro recebe a nova label do botão informado no parâmetro anterior.

Além de string e variável é possível utilizar também uma lang para a definição da label, possibilitando a tradução internacionalização da sua aplicação.

 

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

 

Nome dos botões da Consulta e do Gráfico

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 exibiçã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.

Obs: 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".

Obs: Apenas em casos de formulário rodando em iframe da consulta
update

Controla a exibição do botão "Atualizar".

Obs: Apenas em casos de formulário rodando em iframe da consulta
delete

Controla a exibição do botão "Delete".

Obs: 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 do Formulário e do Calendá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 da 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"
paypal Controla a exibição do botão "PayPal"

 

Exemplo: Parâmetro com string

sc_btn_label('update', 'Atualizar Registro');

 

Exemplo: Parâmetro com lang

sc_btn_label("update", {lang_btn_label});

 

Exemplo: Parâmetro com variável Global

[btn_name] = "update";
[label] = "update";
sc_btn_label([btn_name], [label]);

 

Exemplo: Parâmetro com variável local

$btn_name = "update";
$label= "update";
sc_btn_label($btn_name, $label);