Método Explorer.RemoveFromSelection (Outlook)

  • Artículo

Cancela la selección del elemento de Microsoft Outlook especificado en el explorador activo.

Sintaxis

expresión. RemoveFromSelection (item)

Expresión Variable que representa un objeto Explorer .

Parameters

Nombre Obligatorio/opcional Tipo de datos Descripción
Item Obligatorio Objeto Elemento que se va a quitar de la selección.

Comentarios

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

Para ser quitado de una selección, un elemento debe ser seleccionable en la vista actual del explorador activo. Sin embargo, el elemento no tiene que estar visible en la vista.

Outlook devolverá un error cuando se llama al método RemoveFromSelection en las siguientes condiciones:

  • 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.
  • La vista actual es una vista de conversación.
  • No existe una vista actual para el explorador activo.

Si el elemento especificado está seleccionado, al llamar a RemoveFromSelection hará que desencadenan el evento SelectionChange. Si el elemento no está seleccionado, al llamar a RemoveFromSelection no hará que el evento SelectionChange desencadenar.

Llamar a RemoveFromSelection no desplaza la vista para hacer que el elemento especificado 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 RemoveFromSelection, teniendo en cuenta cualquier selección actual (la propiedad Selection.Count ), si se muestra el panel Lectura y si el elemento especificado se muestra en el panel Lectura.

Selection.Count existente Panel de lectura mostrado Elemento especificado que se muestra en el panel Lectura Resultados
1 Sí Sí
  • La selección está vacía.
  • Se desencadena SelectionChange.
  • El panel de lectura está vacío.
>1 Sí No
  • El elemento se quita de la selección.
  • Se desencadena SelectionChange.
  • El panel de lectura no cambia.
>1 Sí Sí
  • El elemento se quita de la selección.
  • Se desencadena SelectionChange.
  • El panel de lectura muestra el siguiente elemento o elemento adyacente en la selección.
>=1 No N/D
  • El elemento se quita de la selección.
  • Se desencadena SelectionChange.

Si el elemento especificado existe en la vista actual, pero no está seleccionado en esa vista, llamar a RemoveFromSelection no se obtiene ningún cambio en la selección y no desencadena el evento SelectionChange.

Al especificar un elemento en una cita o tarea periódica como argumento para el método RemoveFromSelection , 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 aparición en la serie, pasará una variable de instancia que represente la cita o la serie de tareas, y el método RemoveFromSelection estaría funcionando en la serie en lugar de en la repetició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.