UIElement.Visibility Свойство

Определение

Возвращает или задает видимость uiElement. Невидимый UIElement объект не отображается и не передает нужный размер макету.

public:
 property Visibility Visibility { Visibility get(); void set(Visibility value); };
Visibility Visibility();

void Visibility(Visibility value);
public Visibility Visibility { get; set; }
var visibility = uIElement.visibility;
uIElement.visibility = visibility;
Public Property Visibility As Visibility
<uiElement Visibility="Visible"/>
-or-
<uiElement Visibility="Collapsed"/>

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

Значение перечисления. Значение по умолчанию — Visible.

Примеры

Видимость в визуальном состоянии В рамках определения визуальных состояний для элемента управления иногда требуется изменить Visibility состояние объекта на Collapsed. Визуальные состояния зависят от анимации. Тип Visibility значения свойства — Visibility, перечисление. Для анимации значений, которые являются перечислениями, необходимо использовать Дискретный ОбъектKeyFrame. (Этот метод также используется для логических значений. В этом примере XAML показано визуальное состояние, которое использует DiscreteObjectKeyFrame для изменения видимости.

<VisualState x:Name="Focused">
  <Storyboard>
    <ObjectAnimationUsingKeyFrames Storyboard.TargetName="FocusVisualElement" Storyboard.TargetProperty="Visibility" Duration="0">
      <DiscreteObjectKeyFrame KeyTime="0" Value="Visible"/>
    </ObjectAnimationUsingKeyFrames>
  </Storyboard>
</VisualState>

Комментарии

Элемент пользовательского интерфейса, имеющий Visibility значение equals Collapsed , по-прежнему загружается вместе с остальной частью XAML на странице и существует в дереве объектов среды выполнения.

Элемент, имеющий Visibility значение equals, Collapsed не имеет расположения в пользовательском интерфейсе и не участвует во входных данных или тестировании нажатия. Они также не находятся в последовательности вкладок и не могут быть сосредоточены даже программным способом. Если вам по-прежнему нужны входные данные, проверка фокусировки или нажатия, вместо настройки видимости используйте нулевое значение Opacity.

BooleanToVisibilityConverter

Распространенный сценарий в приложениях, использующих данные из источника данных, заключается в определении свойства данных или модели представления данных, которая определяет, должны ли данные отображаться. Связанный сценарий — создание шаблона, который может изменять Visibility часть элемента управления на основе логического свойства родительского элемента управления или другой части. Чтобы упростить определение этого поведения как части привязки, некоторые шаблоны проектов по умолчанию включают вспомогательный BooleanToVisibilityConverter класс в папку Common. Дополнительные сведения об использовании преобразователя значений для привязки данных см. в разделе IValueConverter.

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

См. также раздел