Explorer. Método RemoveFromSelection (Outlook)

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

Sintaxe

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

Comentários

A seleção no explorer ativo é representada pelo objeto Selection retornado pelo Explorer. Propriedade 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.
• 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.
• 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 de RemoveFromSelection, levando em consideração qualquer seleção atual (a propriedade Selection.Count ), se o Painel de Leitura é exibido e se o item especificado é exibido no Painel de Leitura.

Existing Selection.Count	Painel de leitura exibido	Item especificado exibido 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 exibe o próximo item 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.

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