Comando
Workbook()
Executa ações na pasta de trabalho do Excel: proteger, desproteger, adicionar/excluir/navegar entre planilhas, abrir outro arquivo ou definir senha.
Workbook(comando [, param [, appId]])Parâmetros
| Parâmetro | Obrigatório | Descrição |
|---|---|---|
comando | Sim | Sem parâmetro adicional: Protect – protege a pasta de trabalho. Unprotect – remove proteção da pasta de trabalho. Com parâmetro adicional: AddSheet – adiciona uma planilha; param: posição (índice 1-based) onde inserir. Se omitido, adiciona no final. DeleteSheet – exclui planilha pelo índice; param: número da planilha. CurrentSheet – ativa uma planilha pelo índice; param: número da planilha. Open – abre outro arquivo na mesma instância Excel; param: caminho completo do arquivo. SetPassword – define senha da pasta de trabalho; param: nova senha. |
param | Condicional | Parâmetro exigido por alguns comandos (ver acima). Aceita variáveis. |
appId | Não | Identificador da instância Excel gerenciada. |
Exemplos
// Navegar entre planilhas (índice 1-based):
Workbook(CurrentSheet, '1') // ativa a 1ª planilha
Workbook(CurrentSheet, '3') // ativa a 3ª planilha
// Adicionar planilhas:
Workbook(AddSheet) // adiciona no final
Workbook(AddSheet, '2') // adiciona na posição 2
// Excluir planilha:
Workbook(DeleteSheet, '2')
// Proteger/desproteger:
Workbook(Protect)
Workbook(Unprotect)
// Definir senha:
Workbook(SetPassword, 'minhasenha')
// Abrir outro arquivo na mesma instância:
Workbook(Open, @'C:\dados\outro.xlsx')Observações
Os índices de planilhas são 1-based (a primeira planilha é 1). AddSheet ativa automaticamente a planilha recém-criada. O comando Open fecha todos os workbooks abertos na instância e abre o novo arquivo especificado.