Método Explorer.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 Selection retornado pela propriedade Explorer.Selection .

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 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.
• 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 a seguir ilustra os resultados da chamada RemoveFromSelection, levando em consideração qualquer seleção atual (a propriedade Selection.Count ), se o painel Leitura é exibido e se o item especificado é exibido no painel Leitura.

Seleção.Contagem existente	Painel de leitura exibido	Item especificado exibido no painel 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 exibe o próximo item ou 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.

Ao especificar um item em um compromisso ou tarefa recorrente como um argumento para o método RemoveFromSelection , 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, você estaria passando uma variável de instância que representa a nomeação ou série de tarefas, e o método RemoveFromSelection estaria operando 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.