Skip to content

Commit 7d4debd

Browse files
authored
Fix incorrect required members for ISelectionItemProvider and clarify event descriptions (#44681)
1 parent 31337c7 commit 7d4debd

File tree

1 file changed

+13
-8
lines changed

1 file changed

+13
-8
lines changed

docs/framework/ui-automation/implementing-the-ui-automation-selectionitem-control-pattern.md

Lines changed: 13 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -29,16 +29,21 @@ ms.assetid: 76b0949a-5b23-4cfc-84cc-154f713e2e12
2929

3030
## Required Members for ISelectionItemProvider
3131

32-
The following properties, methods, and events are required for implementing <xref:System.Windows.Automation.Provider.ISelectionItemProvider>.
32+
The following properties, methods, and events are required for implementing <xref:System.Windows.Automation.Provider.ISelectionItemProvider>.
3333

34-
|Required members|Member type|Notes|
34+
| Required members | Member type | Notes |
3535
|----------------------|-----------------|-----------|
36-
|<xref:System.Windows.Automation.Provider.ISelectionProvider.CanSelectMultiple%2A>|Property|None|
37-
|<xref:System.Windows.Automation.Provider.ISelectionProvider.IsSelectionRequired%2A>|Property|None|
38-
|<xref:System.Windows.Automation.Provider.ISelectionProvider.GetSelection%2A>|Method|None|
39-
|<xref:System.Windows.Automation.SelectionPatternIdentifiers.InvalidatedEvent>|Event|Raised when a selection in a container has changed significantly and requires sending more <xref:System.Windows.Automation.SelectionItemPatternIdentifiers.ElementSelectedEvent> and <xref:System.Windows.Automation.SelectionItemPatternIdentifiers.ElementRemovedFromSelectionEvent> events than the <xref:System.Windows.Automation.Provider.AutomationInteropProvider.InvalidateLimit> constant permits.|
40-
41-
- If the result of a <xref:System.Windows.Automation.SelectionItemPattern.Select%2A>, an <xref:System.Windows.Automation.SelectionItemPattern.AddToSelection%2A>, or a <xref:System.Windows.Automation.SelectionItemPattern.RemoveFromSelection%2A> is a single selected item, an <xref:System.Windows.Automation.SelectionItemPatternIdentifiers.ElementSelectedEvent> should be raised; otherwise send <xref:System.Windows.Automation.SelectionItemPatternIdentifiers.ElementAddedToSelectionEvent>/ <xref:System.Windows.Automation.SelectionItemPatternIdentifiers.ElementRemovedFromSelectionEvent> as appropriate.
36+
| <xref:System.Windows.Automation.Provider.ISelectionItemProvider.IsSelected%2A> | Property | None |
37+
| <xref:System.Windows.Automation.Provider.ISelectionItemProvider.SelectionContainer%2A> | Property | None |
38+
| <xref:System.Windows.Automation.Provider.ISelectionItemProvider.AddToSelection%2A> | Method | None |
39+
| <xref:System.Windows.Automation.Provider.ISelectionItemProvider.RemoveFromSelection%2A> | Method | None |
40+
| <xref:System.Windows.Automation.Provider.ISelectionItemProvider.Select%2A> | Method | None |
41+
| <xref:System.Windows.Automation.SelectionItemPatternIdentifiers.ElementSelectedEvent> | Event | Raised when a selection change results in a single selected item. |
42+
| <xref:System.Windows.Automation.SelectionItemPatternIdentifiers.ElementAddedToSelectionEvent> | Event | Raised when an item is added to a multi-selection container. |
43+
| <xref:System.Windows.Automation.SelectionItemPatternIdentifiers.ElementRemovedFromSelectionEvent> | Event | Raised when an item is removed from a multi-selection container. |
44+
| <xref:System.Windows.Automation.SelectionPatternIdentifiers.InvalidatedEvent> | Event | Raised when a selection in a container has changed significantly and requires sending more <xref:System.Windows.Automation.SelectionItemPatternIdentifiers.ElementSelectedEvent> and <xref:System.Windows.Automation.SelectionItemPatternIdentifiers.ElementRemovedFromSelectionEvent> events than the <xref:System.Windows.Automation.Provider.AutomationInteropProvider.InvalidateLimit> constant permits. |
45+
46+
- If a <xref:System.Windows.Automation.SelectionItemPattern.Select%2A>, <xref:System.Windows.Automation.SelectionItemPattern.AddToSelection%2A>, or <xref:System.Windows.Automation.SelectionItemPattern.RemoveFromSelection%2A> operation results in a single selected item, raise <xref:System.Windows.Automation.SelectionItemPatternIdentifiers.ElementSelectedEvent>; otherwise, raise <xref:System.Windows.Automation.SelectionItemPatternIdentifiers.ElementAddedToSelectionEvent> or <xref:System.Windows.Automation.SelectionItemPatternIdentifiers.ElementRemovedFromSelectionEvent> as appropriate.
4247

4348
<a name="Exceptions"></a>
4449

0 commit comments

Comments
 (0)