_Explorer.RemoveFromSelection(Object) Método
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Cancela la selección del elemento de Microsoft Outlook especificado en el explorador activo.
public:
void RemoveFromSelection(System::Object ^ Item);public void RemoveFromSelection (object Item);Public Sub RemoveFromSelection (Item As Object)Parámetros
- Item
- Object
Elemento que se va a quitar de la selección.
Comentarios
La selección de la exploración activa se representa mediante el Selection objeto devuelto por la Selection propiedad .
Para quitarse, un 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 condiciones siguientes, Outlook devuelve un error al llamar al método RemoveFromSelection :
Si el elemento está seleccionado, llamar a RemoveFromSelection hace que se active el SelectionChange evento. 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 que el elemento seleccionado sea visible en la vista y no expande ni contrae grupos en la vista.
En la tabla siguiente se muestran los resultados de llamar a RemoveFromSelection, teniendo en cuenta cualquier selección actual (la Count propiedad ), si se muestra el panel de lectura y si el elemento especificado se muestra en el panel de lectura.
| 1 | Sí | Sí | Se borra la selección. SelectionChange se activa. El panel de lectura está vacío. | |
| >1 | Sí | No | El elemento se quita de la selección. SelectionChange se activa. El panel de lectura no cambia. | |
| >1 | Sí | Sí | El elemento se quita de la selección. SelectionChange se activa. 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. SelectionChange se activa. |
Si el elemento especificado existe en la vista actual, pero no está seleccionado en esa vista, llamar a RemoveFromSelection 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 RemoveFromSelection , 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, que podría ser pasando una variable de instancia que representa la serie de cita o tarea y al método RemoveFromSelection estaría funcionando en la serie en lugar de la repetición.