ColumnCommand() — MyAthus AthusScript

Executa uma ação em uma ou mais colunas da planilha ativa: copiar, recortar, inserir, excluir, ocultar, ordenar, filtrar, formatar, definir largura ou valor.

Sintaxe

ColumnCommand(comando, coluna [, param [, appId]])

Parâmetros

Parâmetro	Obrigatório	Descrição
`comando`	Sim	Sem parâmetro adicional: Copy – copia a coluna. Cut – recorta. ClearContents – limpa conteúdo. ClearFormats – limpa formatação. Insert – insere coluna à esquerda. Delete – exclui a coluna. Hide – oculta. Unhide – exibe. SortAZ – ordena A?Z. SortZA – ordena Z?A. Paste – cola; param: `Values, Formats, Formulas, Comments, ValuesAndNumberFormats, FormulasAndNumberFormats` (vazio = colar tudo). Com parâmetro adicional: Width – largura; param: valor numérico em caracteres. NumberFormat – formato; param: ex `@, 0.00, DD/MM/YYYY`. Filter – filtro por valor; param: valores separados por `;`. FilterByColor – filtro por cor; param: nome de cor ou hex. Font – fonte; param: `NomeFonte tamanho cor [Bold] [Italic]`. Align – alinhamento; param: `[Left\|Center\|Right\|Justify] [Top\|Center\|Bottom]`. Border – borda; param: `[All\|Left\|Top\|Right\|Bottom] [estilo] [espessura] [cor]`. Fill – preenchimento; param: cor. Move – mover para outra posição; param: letra da coluna de destino. SetValue – define valor em toda a coluna; param: valor.
`coluna`	Sim	Letra(s) da coluna. Ex: `'A'`, `'B'`, `'AB'`. Aceita variáveis e intervalo de colunas `'A:C'`.
`param`	Condicional	Parâmetro exigido por alguns comandos.
`appId`	Não	Identificador da instância Excel gerenciada.

Exemplos

AthusScript

// Inserir e excluir colunas:
ColumnCommand(Insert, 'B')
ColumnCommand(Delete, 'C')

// Ocultar/exibir:
ColumnCommand(Hide, 'D')
ColumnCommand(Unhide, 'D')

// Definir largura:
ColumnCommand(Width, 'A', '20')

// Ordenar pela coluna A:
ColumnCommand(SortAZ, 'A')

// Filtrar por valores (separados por ;):
ColumnCommand(Filter, 'B', 'Ativo;Pendente')

// Filtrar por cor de célula:
ColumnCommand(FilterByColor, 'A', '#FF0000')

// Formatar como data:
ColumnCommand(NumberFormat, 'C', 'DD/MM/YYYY')

// Fonte em negrito:
ColumnCommand(Font, 'A', 'Calibri 11 Black Bold')

// Mover coluna B para antes da coluna D:
ColumnCommand(Move, 'B', 'D')

// Copiar e colar apenas valores:
ColumnCommand(Copy, 'A')
ColumnCommand(Paste, 'E', 'Values')

Observações

O parâmetro coluna aceita letra única ('A'), múltiplas letras ('AB') e intervalos ('A:C'). SortAZ e SortZA ordenam a UsedRange inteira usando a coluna informada como chave — não apenas a coluna isolada.