Comando
Worksheet()
Executa ações na planilha ativa do Excel: proteger, ocultar, ajustar colunas/linhas automaticamente, copiar, renomear, localizar texto ou exibir níveis de agrupamento.
Worksheet(comando [, param [, appId]])
Parâmetros
| Parâmetro | Obrigatório | Descrição |
|---|---|---|
comando | Sim | Sem parâmetro adicional: Protect – protege a planilha. Unprotect – remove proteção. Hide – oculta a planilha. Unhide – exibe a planilha. RowsAutoFit – ajusta altura de todas as linhas automaticamente. ColumnsAutoFit – ajusta largura de todas as colunas automaticamente. Copy – copia a planilha (duplica ao final do workbook). Com parâmetro adicional: Name – renomeia a planilha; param: novo nome. FindText – localiza e seleciona célula com texto; param: texto a localizar (busca parcial). ShowLevels – exibe níveis de agrupamento; param: nivelLinhas,nivelColunas. |
param | Condicional | Parâmetro exigido por alguns comandos. Aceita variáveis. |
appId | Não | Identificador da instância Excel gerenciada. |
Exemplos
// Ajuste automático de colunas (AutoFit):
Worksheet(ColumnsAutoFit)
// Ajuste automático de linhas:
Worksheet(RowsAutoFit)
// Renomear planilha ativa:
Worksheet(Name, 'Relatório Mensal')
Worksheet(Name, $nomePlanilha)
// Proteger/desproteger:
Worksheet(Protect)
Worksheet(Unprotect)
// Ocultar/exibir:
Worksheet(Hide)
Worksheet(Unhide)
// Copiar planilha (duplica ao final):
Worksheet(Copy)
// Localizar texto e selecionar a célula:
Worksheet(FindText, 'Total')
// Exibir nível 1 de linhas e colunas:
Worksheet(ShowLevels, '1,1')
Observações
FindText faz busca parcial por valores — não localiza em fórmulas. ShowLevels exibe grupos (criados com RowCommand(Group)).