Compartir a través de


_Explorer.AddToSelection(Object) Método

Definición

Agrega el elemento especificado Microsoft Outlook a la selección en el explorador activo.

public:
 void AddToSelection(System::Object ^ Item);
public void AddToSelection (object Item);
Public Sub AddToSelection (Item As Object)

Parámetros

Item
Object

Elemento para agregar a la selección en el explorador activo.

Comentarios

La selección de la exploración activa se representa mediante el Selection objeto devuelto por la Selection propiedad .

Para ser seleccionado, el elemento debe ser seleccionable en la vista actual del explorador activo. Use el IsItemSelectableInView(Object) método para determinar si el elemento se puede seleccionar en la vista. El elemento no tiene que estar visible en la vista.

En las siguientes condiciones, Outlook devuelve un error cuando se llama al método AddToSelection:

Si el elemento no está seleccionado y se puede seleccionar en la vista actual, llamar a AddToSelection hace que se active el SelectionChange evento.

Llamar a AddToSelection no desplaza la vista para hacer que el elemento seleccionado esté visible en la vista y no expande ni contrae los grupos en la vista.

En la tabla siguiente se muestran los resultados de llamar a AddToSelection, teniendo en cuenta cualquier selección actual (la Count propiedad) y si se muestra el panel de lectura.

0El elemento se agrega a la selección. SelectionChange se activa. Panel de lectura muestra el elemento.
0NoEl elemento se agrega a la selección. SelectionChange se activa.
>=1El elemento se agrega a la selección. SelectionChange se activa. Panel de lectura no cambia el elemento que muestra a menos que la vista sea una vista calendario, en cuyo caso, llamar a AddToSelection puede hacer que el panel de lectura muestre un elemento diferente.
>=1NoEl elemento se agrega a la selección. SelectionChange se activa.

Si el elemento especificado ya está seleccionado en el explorador activo, llamar a AddToSelection no se obtiene ningún cambio en la selección y no se desencadena el evento SelectionChange.

Al especificar un elemento en una cita o tarea periódica como argumento para el método AddToSelection , asegúrese de que, antes de pasar el argumento, obtenga una instancia de la repetición expandiendo primero las periodicidades, utilizando la IncludeRecurrences propiedad y la Items colección. Si no expanda las repeticiones y obtener una ocurrencia de la serie, pase una variable de instancia que representa la serie de cita o tarea y el método AddToSelection funciona en la serie en lugar de la repetición.

Tenga en cuenta que puede usar AddToSelection para agregar elementos a una selección, pero no se puede agregar encabezados de conversación en una selección.

Se aplica a