Compartilhar via

Método NamedRange.AutoFilter

  • Artigo

Filtra uma lista usando o AutoFiltro.

Namespace:  Microsoft.Office.Tools.Excel
Assembly:  Microsoft.Office.Tools.Excel (em Microsoft.Office.Tools.Excel.dll)

Sintaxe

'Declaração
Function AutoFilter ( _
    Field As Object, _
    Criteria1 As Object, _
    Operator As XlAutoFilterOperator, _
    Criteria2 As Object, _
    VisibleDropDown As Object _
) As Object

Object AutoFilter(
    Object Field,
    Object Criteria1,
    XlAutoFilterOperator Operator,
    Object Criteria2,
    Object VisibleDropDown
)

Parâmetros

  • Field
    Tipo: System.Object
    O deslocamento do campo no qual deseja basear o filtro (da esquerda da lista; o campo mais à esquerda é 1 (um) do campo).
  • Criteria1
    Tipo: System.Object
    Os critérios (uma seqüência de caracteres; Por exemplo, "101").Use "=" para localizar campos vazios ou use "< >" para localizar campos preenchidos.Se esse argumento for omitido, o critério será All.Se Operator é xlTop10Items, Criteria1 Especifica o número de itens (por exemplo, "10").
  • Criteria2
    Tipo: System.Object
    O segundo critério (uma seqüência de caracteres).Usado com Criteria1 e Operator para construir critérios compostos.
  • VisibleDropDown
    Tipo: System.Object
    true Para exibir a seta suspensa do AutoFiltro para o campo filtrado; falsePara ocultar a seta suspensa do AutoFiltro para o campo filtrado.truePor padrão.

Valor de retorno

Tipo: System.Object

Comentários

Se você omitir todos os argumentos, este método simplesmente alterna a exibição das setas de lista suspensa de AutoFiltro na NamedRange de controle.

Optional Parameters

Para obter informações sobre os parâmetros opcionais, consulte Parâmetros opcionais em soluções do Office.

Exemplos

O exemplo de código a seguir define as células A1 a A5 nas cinco seqüências de caracteres de nome diferente e usa o AutoFilter método para filtrar o nome "Robert".

Este exemplo é para uma personalização em nível de documento.

    Private Sub SetAutoFilter()
        Me.Range("A1").Value2 = "Kathleen"
        Me.Range("A2").Value2 = "Robert"
        Me.Range("A3").Value2 = "Paul"
        Me.Range("A4").Value2 = "Harry"
        Me.Range("A5").Value2 = "George"

        Dim namedRange1 As Microsoft.Office.Tools.Excel.NamedRange _
            = Me.Controls.AddNamedRange(Me.Range("A1", "A5"), _
            "namedRange1")

        namedRange1.AutoFilter(1, "Robert", _
            Excel.XlAutoFilterOperator.xlAnd, , True)
    End Sub


private void SetAutoFilter()
{
    this.Range["A1", missing].Value2 = "Kathleen";
    this.Range["A2", missing].Value2 = "Robert";
    this.Range["A3", missing].Value2 = "Paul";
    this.Range["A4", missing].Value2 = "Harry";
    this.Range["A5", missing].Value2 = "George";

    Microsoft.Office.Tools.Excel.NamedRange namedRange1 =
        this.Controls.AddNamedRange(this.Range["A1", "A5"],
        "namedRange1");

    namedRange1.AutoFilter(1, "Robert",
        Excel.XlAutoFilterOperator.xlAnd, missing, true);
}

Segurança do .NET Framework

Consulte também

Referência

NamedRange Interface

Namespace Microsoft.Office.Tools.Excel