Método Range.AdvancedFilter (Excel)Range.AdvancedFilter method (Excel)

Filtra ou copia dados de uma lista com base em um intervalo de critérios.Filters or copies data from a list based on a criteria range. Se a seleção inicial estiver em uma única célula, a região atual dessa célula será usada.If the initial selection is a single cell, that cell's current region is used.

SintaxeSyntax

expressão. AdvancedFilter (Ação, CriteriaRange, CopyToRange, exclusivo)expression.AdvancedFilter (Action, CriteriaRange, CopyToRange, Unique)

expressão Uma variável que representa um objeto de Intervalo.expression A variable that represents a Range object.

ParâmetrosParameters

NomeName Obrigatório/OpcionalRequired/Optional Tipo de dadosData type DescriçãoDescription
ActionAction ObrigatórioRequired XlFilterActionXlFilterAction Uma das constantes de XlFilterAction que especifica se será necessário fazer uma cópia ou filtrar a lista no local.One of the constants of XlFilterAction specifying whether to make a copy or filter the list in place.
CriteriaRangeCriteriaRange OpcionalOptional VariantVariant O intervalo dos critérios.The criteria range. Se esse argumento for omitido, não haverá critérios.If this argument is omitted, there are no criteria.
CopyToRangeCopyToRange OpcionalOptional VariantVariant O intervalo de destino para as linhas copiadas se a ação for xlFilterCopy.The destination range for the copied rows if Action is xlFilterCopy. Caso contrário, esse argumento será ignorado.Otherwise, this argument is ignored.
UniqueUnique OpcionalOptional VariantVariant True para filtrar somente os registros exclusivos.True to filter unique records only. False para filtrar todos os registros que atendam aos critérios.False to filter all records that meet the criteria. O valor padrão é False.The default value is False.

Valor de retornoReturn value

VariantVariant

ExemploExample

Este exemplo filtra um banco de dados chamado Database com base em um intervalo de critérios chamado Criteria.This example filters a database named Database based on a criteria range named Criteria.

Range("Database").AdvancedFilter _ 
 Action:=xlFilterInPlace, _ 
 CriteriaRange:=Range("Criteria")

Suporte e comentáriosSupport and feedback

Tem dúvidas ou quer enviar comentários sobre o VBA para Office ou sobre esta documentação?Have questions or feedback about Office VBA or this documentation? Confira Suporte e comentários sobre o VBA para Office a fim de obter orientação sobre as maneiras pelas quais você pode receber suporte e fornecer comentários.Please see Office VBA support and feedback for guidance about the ways you can receive support and provide feedback.