ToggleButton.IsChecked Свойство

Определение

Возвращает или задает значение, указывающее, находится ли ToggleButton во включенном состоянии.Gets or sets whether the ToggleButton is checked.

public:
 property Nullable<bool> IsChecked { Nullable<bool> get(); void set(Nullable<bool> value); };
[System.ComponentModel.TypeConverter(typeof(System.Windows.NullableBoolConverter))]
[System.Windows.Localizability(System.Windows.LocalizationCategory.None, Readability=System.Windows.Readability.Unreadable)]
public Nullable<bool> IsChecked { get; set; }
member this.IsChecked : Nullable<bool> with get, set
Public Property IsChecked As Nullable(Of Boolean)

Значение свойства

true, если ToggleButton находится во включенном состоянии; false, если находится в выключенном состоянии ToggleButton; иначе null.true if the ToggleButton is checked; false if the ToggleButton is unchecked; otherwise null. Значение по умолчанию — false.The default is false.

Атрибуты

Примеры

В следующем примере создается CheckBox набор с неопределенным состоянием.The following example creates a CheckBox set to an indeterminate state.

<CheckBox Name="checkBox1" IsThreeState="True" 
          IsChecked="{x:Null}">
  A CheckBox in an indeterminate state
</CheckBox>

Комментарии

Элемент управления, наследующий от ToggleButton , определяет его поведение, если это nullсвойство имеет значение.A control that inherits from ToggleButton determines its behavior when this property is null.

CheckBoxCheckBox

Если свойство имеет значение true, пользователь может CheckBox щелкнуть, чтобы выбрать три возможных состояния. IsThreeStateWhen the IsThreeState property is set to true, a user can click a CheckBox to pick three possible states. В следующей таблице описаны три состояния CheckBox.The following table describes the three states of a CheckBox.

СостояниеCheckBoxState of the CheckBox Значение IsCheckedValue of IsChecked
ПомеченоChecked true
UncheckedUnchecked false
НеопределенномуIndeterminate null

Если IsThreeState имеет значение false, то по-прежнему можно программно null установить это свойство CheckBox в значение, чтобы перевести объект в неопределенное CheckBox состояние, но пользователь не сможет пользовательский интерфейсuser interface (UI)задать для неопределенного состояния с помощью.If IsThreeState is false, you can still programmatically set this property to null to put the CheckBox in an indeterminate state, but the user cannot set the CheckBox to the indeterminate state through the пользовательский интерфейсuser interface (UI).

RadioButtonRadioButton

Если для null этого свойства задать значение RadioButtonon, то RadioButton флажок будет снят.If you set this property to null on a RadioButton, the RadioButton is unchecked.

Использование атрибута XAMLXAML Attribute Usage

<object IsChecked="Boolean"/><object IsChecked="Boolean"/>

- или --or-

<объект = "{x:NULL расширение разметки}"/> IsChecked<object IsChecked="{x:Null Markup Extension}"/>

Сведения о свойстве зависимостейDependency Property Information

Поле идентификатораIdentifier field IsCheckedProperty
Свойства метаданных, для которых задано значениеtrueMetadata properties set to true BindsTwoWayByDefault

Применяется к