Compartir a través de

Método Explorer.AddToSelection (Outlook)

  • Artículo

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

Sintaxis

expresión. AddToSelection (elemento)

Expresión Variable que representa un objeto Explorer .

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 del explorador activo se representa mediante el objeto Selection devuelto por 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.
  • Se ha filtrado la vista actual y la aplicación del filtro ha quitado 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 Lectura.

Selection.Count existente Panel de lectura mostrado 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 calendario, en cuyo caso, llamar a AddToSelection puede hacer que el panel 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 da lugar a ningún cambio en la selección y el evento SelectionChange no se desencadena.

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 mediante la propiedad IncludeRecurrences y la colección Items . Si no expande las periodicidades 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 funciona en la serie en lugar de en 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.