UIElement.Visibility Свойство
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
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.