_Explorer.RemoveFromSelection(Object) Method
Definition
Important
Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.
Cancels the selection of the specified Microsoft Outlook item in the active explorer.
public:
void RemoveFromSelection(System::Object ^ Item);public void RemoveFromSelection (object Item);Public Sub RemoveFromSelection (Item As Object)Parameters
- Item
- Object
The item to be removed from the selection.
Remarks
The selection in the active explore is represented by the Selection object that is returned by the Selection property.
To be removed, an item must be selectable in the current view of the active explorer. Use the IsItemSelectableInView(Object) method to determine whether the item can be selected in the view. The item does not have to be visible in the view.
Under the following conditions, Outlook returns an error when you call the RemoveFromSelection method:
If the item is selected, calling RemoveFromSelection causes the SelectionChange event to fire. If the item is not selected, calling RemoveFromSelection will not cause the SelectionChange event to fire.
Calling RemoveFromSelection does not scroll the view to make the selected item visible in the view and does not expand or collapse groups in the view.
The following table illustrates the results of calling RemoveFromSelection, taking into consideration any current selection (the Count property), whether the Reading Pane is displayed, and whether the specified item is displayed in the Reading Pane.
| 1 | Yes | Yes | The selection is cleared.SelectionChange fires.Reading Pane is empty. | |
| >1 | Yes | No | The item is removed from the selection.SelectionChange fires.Reading Pane does not change. | |
| >1 | Yes | Yes | The item is removed from the selection.SelectionChange fires.Reading Pane displays the next item or adjacent item in the selection. | |
| >=1 | No | N/A | The item is removed from the selection.SelectionChange fires. |
If the specified item exists in the current view but is not selected in that view calling RemoveFromSelection does not result in any change to the selection and the SelectionChange event does not fire.
When you specify an item in a recurring appointment or task as an argument to the RemoveFromSelection method, make sure that before you pass the argument, you obtain an instance of the occurrence by first expanding the recurrences, using the IncludeRecurrences property and the Items collection. If you do not expand the recurrences and obtain an occurrence in the series, you would be passing an instance variable that represents the appointment or task series, and the RemoveFromSelection method would be operating on the series instead of the occurrence.