Explorer. Método AddToSelection (Outlook)

Adiciona o item especificado Microsoft Outlook à seleção do Explorer ativo.

Sintaxe

mais simples. AddToSelection (Item)

expressão Uma variável que representa um objeto do Explorer.

Parâmetros

Nome Obrigatório/Opcional Tipo de dados Descrição
Item Obrigatório Objeto O item que será adicionado à seleção do Explorer ativo.

Comentários

A seleção no explorer ativo é representada pelo objeto Selection retornado pelo Explorer. Propriedade Selection.

Para ser selecionado, o item deve ser selecionável na exibição atual do Explorer ativo. Use o método IsItemSelectableInView para determinar se o item pode ser selecionado na exibição. O item não precisa estar visível na exibição.

Sob as seguintes condições, o Outlook retornará um erro quando você chama o método AddToSelection:

  • O item especificado não está na exibição atual do Explorer ativo.
  • O item especificado está sendo editado na exibição atual do Explorer ativo.
  • O modo de exibição atual foi filtrado e a aplicação do filtro removeu o item do modo de exibição.
  • O item especificado não foi salvo.
  • O item especificado representa um StorageItem.
  • Não há nenhuma exibição para o Explorer ativo.

Se o item não está selecionado e for selecionável na exibição atual, chamar AddToSelection faz com que o evento SelectionChange seja acionado.

Chamar AddToSelection não rolará a exibição para tornar o item selecionado visível na exibição e não expandir ou recolher grupos da exibição.

A tabela a seguir ilustra os resultados da chamada de AddToSelection, levando em consideração qualquer seleção atual (a propriedade Selection.Count ) e se o Painel de Leitura é exibido.

Existing Selection.Count Painel de leitura exibido Resultados
0 Sim
  • O item foi adicionado à seleção.
  • SelectionChange é acionada.
  • O painel de leitura exibe o item.
0 Não
  • O item foi adicionado à seleção.
  • SelectionChange é acionada.
>=1 Sim
  • O item foi adicionado à seleção.
  • SelectionChange é acionada.
  • O Painel de Leitura não altera o item que exibe, a menos que o modo de exibição seja um modo de exibição de Calendário. Nesse caso, chamar AddToSelection pode fazer com que o Painel de Leitura exiba um item diferente.
>=1 Não
  • O item foi adicionado à seleção.
  • SelectionChange é acionada.

Se o item especificado já estiver selecionado no explorador ativo, chamar AddToSelection não resultará em nenhuma alteração na seleção e o evento SelectionChange não será acionado.

Ao especificar um item em um compromisso ou tarefa recorrente como um argumento para o método AddToSelection , antes de passar o argumento, você obtém uma instância da ocorrência expandindo primeiro as recorrências usando a propriedade IncludeRecurrences e a coleção Items . Se você não expandir as recorrências e obter uma ocorrência na série, você passará uma variável de instância que representa o compromisso ou a série de tarefas, e o método AddToSelection opera na série em vez da ocorrência.

Observe que você pode usar AddToSelection para adicionar itens a uma seleção, mas você não pode adicionar cabeçalhos de conversas a uma seleção.

Suporte e comentários

Tem dúvidas ou quer enviar comentários sobre o VBA para Office ou sobre esta documentação? 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.

  • Last updated on