_Explorer.AddToSelection(Object) Método

Definição

Namespace:

Microsoft.Office.Interop.Outlook

Assembly:

Microsoft.Office.Interop.Outlook.dll

Adiciona o item especificado Microsoft Outlook à seleção do Explorer ativo.

public:
 void AddToSelection(System::Object ^ Item);

public void AddToSelection (object Item);

Public Sub AddToSelection (Item As Object)

Parâmetros

Item

Object

O item que será adicionado à seleção do Explorer ativo.

Comentários

A seleção na exploração ativa é representada pelo Selection objeto retornado pela Selection propriedade.

Para ser selecionado, o item deve ser selecionável na exibição atual do Explorer 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.

Sob as seguintes condições, o Outlook retornará um erro quando você chama o método AddToSelection:

Se o item não estiver selecionado e estiver selecionável no modo de exibição atual, chamar AddToSelection fará com que o SelectionChange evento seja acionado.

Chamar AddToSelection não rolará a exibição para tornar o item selecionado visível na exibição e não expandir ou recolher grupos da exibição.

A tabela a seguir ilustra os resultados de chamar AddToSelection, levando em consideração qualquer seleção atual (a Count propriedade) e se o Painel de Leitura é exibido.

	0	Sim	O item é adicionado à seleção. SelectionChange é acionado. O Painel de Leitura exibe o item.
	0	Não	O item é adicionado à seleção. SelectionChange é acionado.
	>=1	Sim	O item é adicionado à seleção. SelectionChange é acionado. O Painel de Leitura não altera o item exibido a menos que a exibição seja uma exibição Calendário, nesse caso, chamar AddToSelection pode fazer com que o Painel de Leitura exiba um item diferente.
	>=1	Não	O item é adicionado à seleção. SelectionChange é acionado.

Se o item especificado já está selecionado no explorer ativo, chamar AddToSelection não resultará em nenhuma alteração na seleção e o evento SelectionChange não é acionado.

Ao especificar um item em um compromisso ou tarefa recorrente como um argumento para o método AddToSelection , 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ê passar uma variável de instância que representa as séries de compromisso ou uma tarefa e o método AddToSelection opera em série, em vez da ocorrência.

Observe que você pode usar AddToSelection para adicionar itens a uma seleção, mas você não pode adicionar cabeçalhos de conversas a uma seleção.