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 |
|
>1 | Sim | Não |
|
>1 | Sim | Sim |
|
>=1 | Não | N/D |
|
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.