Развернуть Свернуть

UIElement.Visibility Property

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

Синтаксис


public Visibility Visibility { get; set; }


<uiElement Visibility="Visible"/>
-or-
<uiElement Visibility="Collapsed"/>

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

Тип: Visibility

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

Примечания

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

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

BooleanToVisibilityConverter

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

Примеры

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


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

Требования

Минимальный поддерживаемый клиент

Windows 8

Минимальный поддерживаемый сервер

Windows Server 2012

Пространство имен

Windows.UI.Xaml
Windows::UI::Xaml [C++]

Metadata

Windows.winmd

См. также

UIElement
Краткое руководство. Определение макетов

 

 

Показ:
© 2015 Microsoft