NamedRange.AutoFilter Método

Referência

Definição

Namespace:: Microsoft.Office.Tools.Excel

Assembly:: Microsoft.Office.Tools.Excel.dll

Importante

Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.

Filtra uma lista usando o Filtro Automático.

public object AutoFilter (object Field, object Criteria1, Microsoft.Office.Interop.Excel.XlAutoFilterOperator Operator = Microsoft.Office.Interop.Excel.XlAutoFilterOperator.xlAnd, object Criteria2, object VisibleDropDown);

abstract member AutoFilter : obj * obj * Microsoft.Office.Interop.Excel.XlAutoFilterOperator * obj * obj -> obj

Public Function AutoFilter (Optional Field As Object, Optional Criteria1 As Object, Optional Operator As XlAutoFilterOperator = Microsoft.Office.Interop.Excel.XlAutoFilterOperator.xlAnd, Optional Criteria2 As Object, Optional VisibleDropDown As Object) As Object

Parâmetros

Field: Object

O deslocamento do campo no qual você deseja basear o filtro (da esquerda da lista; o campo mais à esquerda é o 1 [um]).

Criteria1: Object

Os critérios (uma cadeia de caracteres, por exemplo, “101”). Use "=" para localizar campos em branco ou use "<>" para localizar campos preenchidos. Se esse argumento for omitido, o critério será All. Se Operator for xlTop10Items, Criteria1 especificará o número de itens (por exemplo, "10").

Operator: XlAutoFilterOperator

Pode ser uma das seguintes XlAutoFilterOperator constantes: xlAnd xlTop10Items xlOr xlBottom10Items xlBottom10Percent xlTop10Percent Usar xlAnd e xlOr com Criteria1 e Criteria2 para construir critérios compostos.

Criteria2: Object

O segundo critério (uma cadeia de caracteres). Usado com Criteria1 e Operator para construir critérios compostos.

VisibleDropDown: Object

true para exibir a seta da lista suspensa de Filtro Automático para o campo filtrado; false para ocultar a seta da lista suspensa do Filtro Automático para o campo filtrado. true por padrão.

Retornos

Object

Exemplos

O exemplo de código a seguir define as células A1 a A5 como cinco cadeias de caracteres de nome diferentes e usa o AutoFilter método para filtrar o nome "Robert".

Este exemplo destina-se a uma personalização no nível de documento.

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

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

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

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

Comentários

Se você omitir todos os argumentos, esse método simplesmente alternará a exibição das setas suspensas do Filtro Automático no NamedRange controle.

Parâmetros Opcionais

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

Aplica-se a

Compartilhar via