_Explorer.RemoveFromSelection(Object) Método

Definição

Namespace:

Microsoft.Office.Interop.Outlook

Assembly:

Microsoft.Office.Interop.Outlook.dll

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.