v1.0
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.
Sintaxe
Worksheet(comando [, param [, appId]])

Parâmetros

ParâmetroObrigatórioDescrição
comandoSimSem 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.
paramCondicionalParâmetro exigido por alguns comandos. Aceita variáveis.
appIdNãoIdentificador da instância Excel gerenciada.

Exemplos

AthusScript
// 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)).