Compartilhar via


Método Explorer.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 Selection que é retornado pela propriedade Explorer.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.
  • A exibição atual foi filtrada e o aplicativo do filtro removeu o item da 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 de chamar AddToSelection, levando em consideração qualquer seleção atual (a propriedade Selection.Count ) e se o painel Leitura é exibido.

Seleção.Contagem existente 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 exibido a menos que o modo de exibição seja uma exibição Calendário, nesse caso, chamar AddToSelection pode fazer com que o painel 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.

Quando você especificar um item em um compromisso ou tarefa recorrente como um argumento para o método AddToSelection , verifique se, 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, passará uma variável de instância que representa a nomeação 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.