Selector.IsSelected Selector.IsSelected Selector.IsSelected Attached Property

Definition

Ruft einen Wert ab, der angibt, ob ein Element ausgewählt ist, oder legt diesen Wert fest.Gets or sets a value that indicates whether an item is selected.

see GetIsSelected, and SetIsSelected
see GetIsSelected, and SetIsSelected
see GetIsSelected, and SetIsSelected

Beispiele

Im folgenden Beispiel wird ein ListBox erstellt, das zwei CheckBox-Steuerelemente enthält.The follow example creates a ListBox that contains two CheckBox controls. Das Beispiel erstellt nicht explizit eine ListBoxItem für CheckBox, sodass Selector.IsSelected direkt auf jedem CheckBox festgelegt wird.The example does not explicitly create a ListBoxItem for either CheckBox, so it sets Selector.IsSelected directly on each CheckBox. Um zu veranschaulichen, dass Selector.IsSelected nicht aktualisiert wird, bindet das Beispiel die IsChecked-Eigenschaft des ersten Kontrollkästchens an Selector.IsSelected.To illustrate that Selector.IsSelected is not updated, the example binds the IsChecked property of the first checkbox to Selector.IsSelected. Wenn der Benutzer das Element im ListBox auswählt, bleibt die CheckBox aktiviert.When the user unselects the item in the ListBox, the CheckBox remains checked. Ebenso wirkt sich das Überprüfen bzw. Deaktivieren des CheckBox nicht darauf aus, ob die CheckBox in der ListBox ausgewählt ist.Likewise, checking or unchecking the CheckBox does not affect whether the CheckBox is selected in the ListBox. Im Beispiel wird IsChecked des zweiten CheckBox an ListBoxItem.IsSelected gebunden.The example binds IsChecked of the second CheckBox to ListBoxItem.IsSelected. Wenn Sie in diesem Fall das Element in der ListBox deaktivieren, wird das Kontrollkästchen deaktiviert, und durch Deaktivieren des Kontrollkästchens wird das Element ebenfalls deaktiviert.In this case, unselecting the item in the ListBox causes the checkbox to be unchecked, and unchecking the checkbox also unselects the item.

<ListBox Name="listBox1" SelectionMode="Multiple">
  <CheckBox Selector.IsSelected="True" 
            IsChecked="{Binding RelativeSource={RelativeSource Self}, 
                        Path=(Selector.IsSelected), Mode=TwoWay}">
    CheckBox.IsChecked is bound to Selector.IsChecked, which is set only
    once.
  </CheckBox>

  <CheckBox ListBox.IsSelected="True" 
            IsChecked="{Binding RelativeSource={RelativeSource 
                        AncestorType={x:Type ListBoxItem}}, 
                        Path=IsSelected, Mode=TwoWay}">
    CheckBox.IsChecked is bound to ListBoxItem.IsChecked, which is
    updated throughout the duration of the application.
  </CheckBox>
</ListBox>

Hinweise

Verwenden Sie die angefügte IsSelected-Eigenschaft, um ein Element in der Selector auszuwählen, wenn Sie den Element Container nicht explizit erstellen.Use the IsSelected attached property to select an item in the Selector when you do not explicitly create the item container. Ein Element Container ist eine Klasse, die ein Element in der Selector darstellt.An item container is a class that represents an item in the Selector. TabItem, ListBoxItem und ComboBoxItem sind Element Container für die Steuerelemente, die von Selector erben, und jede definiert eine issgewählte -Eigenschaft.TabItem, ListBoxItem, and ComboBoxItem are item containers for the controls that inherit from Selector, and each defines an IsSelected property.

Wenn Sie nicht explizit einen Element Container erstellen, erstellt Windows Presentation Foundation (WPF)Windows Presentation Foundation (WPF) implizit einen Element Container und legt die issgewählt -Eigenschaft des Element Containers auf den Wert Selector.IsSelected fest.If you do not explicitly create an item container, Windows Presentation Foundation (WPF)Windows Presentation Foundation (WPF) implicitly creates one and sets the IsSelected property on the item container to the value of Selector.IsSelected. Dies ist der einzige Zeitpunkt, an dem Selector.IsSelected gelesen wird.This is the only time Selector.IsSelected is read. Selector.IsSelected wird nicht aktualisiert, wenn die Auswahl für das Element geändert wird.Selector.IsSelected is not updated if the selection on the item changes.

Wenn Sie explizit einen Element Container erstellen, sollten Sie die issgewählt -Eigenschaft für diese Klasse verwenden.If you explicitly create an item container, you should use the IsSelected property on that class.

Informationen zur AbhängigkeitseigenschaftDependency Property Information

BezeichnerfeldIdentifier field IsSelectedProperty, registriert als angefügtIsSelectedProperty, registered as Attached
Metadateneigenschaften auf true festgelegtMetadata properties set to true BindsTwoWayByDefault

Gilt für: