Partilhar via


Explorer. Método RemoveFromSelection (Outlook)

Cancela a seleção do item do Microsoft Outlook especificado no Explorer ativo.

Sintaxe

expressão. RemoveFromSelection (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á removido da seleção.

Comentários

A seleção no explorador ativo é representada pelo objeto Seleção devolvido pelo Explorer. Propriedade de seleção.

Para ser removido de uma seleção, um item deve poder ser selecionado na exibição atual do Explorer ativo. Contudo, o item não precisa estar visível na exibição.

Outlook retornará um erro quando você chama o método RemoveFromSelection nas seguintes condições:

  • 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.
  • A exibição atual é uma exibição de conversa
  • Não há exibição atual do Explorer ativo.

Se o item especificado estiver marcado, chamar RemoveFromSelection fará com que o evento SelectionChange seja acionado. Se o item não estiver selecionado, chamar RemoveFromSelection não causará o evento SelectionChange seja acionado.

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

A tabela seguinte ilustra os resultados da chamada RemoveFromSelection, tendo em conta qualquer seleção atual (a propriedade Selection.Count ), se o Painel de Leitura é apresentado e se o item especificado é apresentado no Painel de Leitura.

Selection.Count Existente Painel de leitura apresentado Item especificado apresentado no Painel de Leitura Resultados
1 Sim Sim
  • A seleção é limpa.
  • SelectionChange é acionada.
  • O painel de leitura está vazio.
>1 Sim Não
  • O item é removido da seleção.
  • SelectionChange é acionada.
  • O painel de leitura não é alterado.
>1 Sim Sim
  • O item é removido da seleção.
  • SelectionChange é acionada.
  • O painel de leitura apresenta o item seguinte ou o item adjacente na seleção.
>=1 Não N/D
  • O item é removido da seleção.
  • SelectionChange é acionada.

Se o item especificado existe na exibição atual, mas não está selecionado no modo de exibição, chamar RemoveFromSelection não resultará em nenhuma alteração na seleção e não acionará o evento SelectionChange.

Quando especificar um item num compromisso ou tarefa recorrente como argumento para o método RemoveFromSelection , 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, estará a transmitir uma variável de instância que representa o compromisso ou série de tarefas e o método RemoveFromSelection estaria a funcionar na série em vez da ocorrência.

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.