Compartilhar via

Explorer. Método AddToSelection (Outlook)

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

Sintaxe

expressão. AddToSelection (Item)

expressão Uma variável que representa um objeto 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 explorador ativo é representada pelo objeto Seleção que é devolvido pelo Explorer. Propriedade de seleção.

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.
  • A vista atual foi filtrada e a aplicação do filtro removeu o item da vista.
  • 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 seguinte ilustra os resultados da chamada addToSelection, tendo em consideração qualquer seleção atual (a propriedade Selection.Count ) e se o Painel de Leitura é apresentado.

Selection.Count Existente Painel de leitura apresentado Resultados
0 Sim
  • O item foi adicionado à seleção.
  • SelectionChange é acionada.
  • O painel de leitura apresenta 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 apresentado, a menos que a vista seja uma vista calendário. Nesse caso, chamar AddToSelection pode fazer com que o Painel de Leitura apresente 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 à seleção e o evento SelectionChange não é acionado.

Quando especificar um item num compromisso ou tarefa recorrente como argumento para o método AddToSelection , certifique-se de que, antes de transmitir o argumento, obtém uma instância da ocorrência ao expandir primeiro as periodicidades com a propriedade IncludeRecurrences e a coleção Items . Se não expandir as periodicidades e obter uma ocorrência na série, transmita uma variável de instância que representa o compromisso ou série de tarefas e o método AddToSelection funciona 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