Método Explorer.AddToSelection (Outlook)

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

Sintaxis

más sencilla.AddToSelection (elemento)

expresión Variable que representa un objeto del explorador .

Parameters

Nombre Obligatorio/opcional Tipo de datos Descripción
Item Obligatorio Objeto Elemento para agregar a la selección en el explorador activo.

Comentarios

La selección en el explorador activo se representa mediante el objeto Selection que devuelve la propiedad Explorer.Selection .

Para ser seleccionado, el elemento debe ser seleccionable en la vista actual del explorador activo. Use el método IsItemSelectableInView para determinar si el elemento puede ser seleccionado 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:

  • El elemento especificado no está en la vista actual del explorador activo.
  • El elemento especificado se está editando en la vista actual del explorador activo.
  • La vista actual se ha filtrado y la aplicación del filtro quitó el elemento de la vista.
  • El elemento especificado no se guardó.
  • El elemento especificado representa un objeto StorageItem.
  • No existe una vista actual para el explorador activo.

Si el elemento no está seleccionado y es seleccionable en la vista actual, llamar a AddToSelection hace que desencadenan el evento SelectionChange.

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 propiedad Selection.Count ) y si se muestra el panel de lectura.

Selección existente. Recuento Se muestra el panel de lectura Resultados
0 Sí
  • El elemento se agrega a la selección.
  • Se desencadena SelectionChange.
  • El panel de lectura muestra el elemento.
0 No
  • El elemento se agrega a la selección.
  • Se desencadena SelectionChange.
>=1 Sí
  • El elemento se agrega a la selección.
  • Se desencadena SelectionChange.
  • El panel de lectura no cambia el elemento que muestra a menos que la vista sea una vista de Calendar, en cuyo caso, llamar a AddToSelection puede hacer que el panel de lectura muestre un elemento diferente.
>=1 No
  • El elemento se agrega a la selección.
  • Se desencadena SelectionChange.

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

Cuando especifica 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 ocurrencia expandiendo primero las recurrencias mediante la propiedad IncludeRecurrences y la colección Items . Si no expande las recurrencias y obtiene una repetición en la serie, pasa una variable de instancia que representa la cita o la serie de tareas, y el método AddToSelection opera 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.

Soporte técnico y comentarios

¿Tiene preguntas o comentarios sobre VBA para Office o esta documentación? Vea Soporte técnico y comentarios sobre VBA para Office para obtener ayuda sobre las formas en las que puede recibir soporte técnico y enviar comentarios.

  • Last updated on