言語

UIElement.Visibility プロパティ

定義

名前空間:
Microsoft.UI.Xaml
編集

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"/>

プロパティ値

Visibility

列挙体の値。 既定値は Visible です。

例

視覚的な状態での可視性 コントロールの表示状態の定義の一環として、オブジェクトの Visibility 状態を Collapsedに変更することが必要になる場合があります。 表示状態はアニメーションに依存します。 Visibilityのプロパティ値の型は Visibility (列挙型) です。 列挙体である値をアニメーション化するには、 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>

注釈

VisibilityがCollapsed等しい UI 要素は、ページ上の XAML の残りの部分と共に読み込まれ、ランタイム オブジェクト ツリーに存在します。

Visibilityが等しい要素Collapsed UI に場所がなく、入力テストやヒット テストには参加しません。 また、タブ シーケンスに含まれていないため、プログラムでフォーカスを設定することもできません。 表示設定ではなく、入力、フォーカス、ヒット テストが必要な場合は、 不透明度 0 を使用します。

BooleanToVisibilityConverter

データ ソースのデータを使用するアプリの一般的なシナリオは、データを表示するかどうかを制御するデータのプロパティまたはビュー モデルを識別することです。 関連するシナリオでは、親コントロールまたは別の部分のブール型プロパティに基づいてコントロール パーツの Visibility を変更できるテンプレートを記述します。 バインドの一部としてこの動作を簡単に定義できるように、既定のプロジェクト テンプレートの一部には、Common フォルダーにBooleanToVisibilityConverter ヘルパー クラスが含まれています。 データ バインディングに値コンバーターを使用する方法の詳細については、「 IValueConverter」を参照してください。

適用対象

こちらもご覧ください