_Explorer.RemoveFromSelection(Object) Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Cancela a seleção do item do Microsoft Outlook especificado no Explorer ativo.
public:
void RemoveFromSelection(System::Object ^ Item);public void RemoveFromSelection (object Item);Public Sub RemoveFromSelection (Item As Object)Parâmetros
- Item
- Object
O item que será removido da seleção.
Comentários
A seleção na exploração ativa é representada pelo Selection objeto retornado pela Selection propriedade.
Para ser removido, um item deve ser selecionável na exibição atual do explorador ativo. Use o IsItemSelectableInView(Object) método para determinar se o item pode ser selecionado na exibição. O item não precisa estar visível na exibição.
Nas seguintes condições, o Outlook retorna um erro ao chamar o método RemoveFromSelection :
Se o item estiver selecionado, chamar RemoveFromSelection fará com que o SelectionChange evento seja acionado. Se o item não estiver selecionado, chamar RemoveFromSelection não causará o evento SelectionChange seja acionado.
Chamar RemoveFromSelection não rola a exibição para tornar o item selecionado visível no modo de exibição e não expanda ou colapsa grupos no modo de exibição.
A tabela a seguir ilustra os resultados de chamar RemoveFromSelection, levando em consideração qualquer seleção atual (a Count propriedade), se o Painel de Leitura é exibido e se o item especificado é exibido no Painel de Leitura.
| 1 | Sim | Sim | A seleção está limpa. SelectionChange é acionado. O Painel de Leitura está vazio. | |
| >1 | Sim | Não | O item é removido da seleção. SelectionChange é acionado. O Painel de Leitura não é alterado. | |
| >1 | Sim | Sim | O item é removido da seleção. SelectionChange é acionado. 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 é acionado. |
Se o item especificado existir no modo de exibição atual, mas não estiver selecionado nessa exibição chamando RemoveFromSelection 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 RemoveFromSelection , verifique se, antes de passar o argumento, você obtém uma instância da ocorrência expandindo primeiro as recorrências, usando a IncludeRecurrences propriedade e a Items coleção. Se você não expandir as recorrências e obtenham uma ocorrência na série, você poderia ser passando uma variável de instância que representa as séries de compromisso ou uma tarefa e o método RemoveFromSelection seria estar operando na série, em vez da ocorrência.