CommandBar クラス
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
AppBarButton と関連するコマンド要素のレイアウトを提供する特殊なアプリ バーを表します。
/// [Microsoft.UI.Xaml.Markup.ContentProperty(Name="PrimaryCommands")]
/// [Windows.Foundation.Metadata.ContractVersion(Microsoft.UI.Xaml.WinUIContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class CommandBar : AppBar
[Microsoft.UI.Xaml.Markup.ContentProperty(Name="PrimaryCommands")]
[Windows.Foundation.Metadata.ContractVersion(typeof(Microsoft.UI.Xaml.WinUIContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public class CommandBar : AppBar
Public Class CommandBar
Inherits AppBar
<CommandBar .../>
-or-
<CommandBar>
commandBarElements
</CommandBar>
- 継承
-
Object IInspectable DependencyObject UIElement FrameworkElement Control ContentControl AppBar CommandBar
- 派生
- 属性
例
ヒント
詳細、設計ガイダンス、およびコード例については、「 コマンド バー」を参照してください。
WinUI 3 ギャラリー アプリには、ほとんどの WinUI 3 コントロールと機能の対話型の例が含まれています。 Microsoft Store からアプリを入手するか、GitHub でソース コードを取得します。
次の使用例は、「備考」に示すコマンド バーを作成します。
<CommandBar>
<AppBarToggleButton Icon="Shuffle" Label="Shuffle" Click="AppBarButton_Click"/>
<AppBarToggleButton Icon="RepeatAll" Label="Repeat" Click="AppBarButton_Click"/>
<AppBarSeparator/>
<AppBarButton Icon="Back" Label="Back" Click="AppBarButton_Click"/>
<AppBarButton Icon="Stop" Label="Stop" Click="AppBarButton_Click"/>
<AppBarButton Icon="Play" Label="Play" Click="AppBarButton_Click"/>
<AppBarButton Icon="Forward" Label="Forward" Click="AppBarButton_Click"/>
<CommandBar.SecondaryCommands>
<AppBarButton Icon="Like" Label="Like" Click="AppBarButton_Click"/>
<AppBarButton Icon="Dislike" Label="Dislike" Click="AppBarButton_Click"/>
</CommandBar.SecondaryCommands>
<CommandBar.Content>
<TextBlock Text="Now playing..." Margin="12,8"/>
</CommandBar.Content>
</CommandBar>
注釈
ヒント
詳細、設計ガイダンス、およびコード例については、「 コマンド バー」を参照してください。
CommandBar を使用して、アプリの最も一般的なタスクにすばやくアクセスできるようにします。 これは、画像、進行状況バー、テキスト ブロックなどの複雑なコンテンツと、AppBarButton、AppBarToggleButton、AppBarSeparator コントロールなどの単純なコマンドの両方を表示できる、汎用の柔軟な軽量コントロールです。
構造
既定では、CommandBar にはアイコン ボタンの行と、省略記号 [***] で表される "その他" ボタンが表示されます。 後で示すコード例によって作成された CommandBar を次に示します。 既定の閉じた状態で表示されます。
開いている状態で表示されるのと同じ CommandBar を次に示します。 ラベルには、コントロールのメイン部分が表示されます。
CommandBar は、次の 4 つのメイン領域に分かれています。
- 左側にコンテンツ領域が表示されます。
- 右側に [その他] ボタンが表示されます。 [その他] ボタンを押すと、2 つの効果があります。プライマリ コマンド ボタンのラベルが表示され、セカンダリ コマンドが存在する場合はオーバーフロー メニューが開きます。
- プライマリ コマンドは、[その他] ボタンの左側に表示されます。
- オーバーフロー メニューは、CommandBar が開き、セカンダリ コマンドが含まれている場合にのみ表示されます。
FlowDirection が RightToLeft のときは、レイアウトが逆になります。
CommandBar にアクセス キーを割り当てると、アクセス キーのスコープを変更することなく、[その他] ボタンの上にキー ヒントが配置されます。
コンテンツとコマンド
CommandBar には、コンテンツとコマンドの追加に使用できる 3 つのプロパティ ( Content、 PrimaryCommands、 SecondaryCommands) があります。
XAML 要素をコンテンツ領域に追加するには、Content プロパティを設定します。
PrimaryCommands と SecondaryCommands の両方に設定できるのは、AppBarButton、AppBarToggleButton、および AppBarSeparator コマンド要素のみです。 既定では、CommandBar に追加する項目は PrimaryCommands コレクションに追加されます。 これらのコマンドは、[その他] ボタンの左側に表示されます。 SecondaryCommands コレクションにコマンドを追加すると、これらの項目がオーバーフロー メニューに表示されます。 必要に応じて、 PrimaryCommands と SecondaryCommands の間でコマンドをプログラムで移動できます。
アプリ バーのボタン コントロールは、アイコンとアイコンに関連付けられたラベルによって特徴付けられます。 標準とコンパクトの 2 つのサイズがあります。 既定では、テキスト ラベルが表示されます。 IsCompact プロパティを true に設定すると、テキスト ラベルが非表示になります。 CommandBar コントロールで使用する場合、コントロールを開いたり閉じたりすると、CommandBar によって IsCompact プロパティが自動的に設定されます。
PrimaryCommands に表示するときにボタンの幅を既定値より大きくする必要がある場合は、MinWidth プロパティを使用して目的のサイズを実現します。 次に、後で SecondaryCommands に移動しても、オーバーフロー メニューの幅を埋めるために引き続きストレッチされます。
アプリ バーのボタンのテキスト ラベルが長すぎて 1 行に収まらない場合は、テキスト ラベルが次の行に折り返され、バーを開いたときのバー全体の高さが増加します。 ラベルのテキストにソフト ハイフン文字 (0x00AD) を含めると、テキストの中で単語を分割する位置を示すことができます。 XAML でこの処理を行うには、次のようなエスケープ シーケンスを使います。
<AppBarButton Icon="Back" Label="Areally­longlabel"/>
指定した場所でラベルが折り返されると、次のようになります。
開いた状態と閉じた状態
CommandBar は開いたり閉じたりすることができます。 ユーザーは、[その他] ボタンを押して、これらの状態を切り替えることができます。 プログラムで切り替えるには、IsOpen プロパティを設定します。 Open、Opened、Closing、Closed の各イベントを使用して、開いている CommandBar または閉じている CommandBar に応答できます。
開くと、プライマリ コマンド ボタンがテキスト ラベルと共に表示され、セカンダリ コマンドが存在する場合はオーバーフロー メニューが開きます。 既定のオーバーフロー メニューは、バーとは異なるスタイルになっています。 スタイルを調整するには、CommandBarOverflowPresenterStyle プロパティを CommandBarOverflowPresenter を対象とする Style に設定します。
ClosedDisplayMode プロパティを設定することで、CommandBar を閉じた状態で表示する方法を制御できます。 既定では、コンテンツ、ラベルのないアイコン、および [その他] ボタンを含む コンパクト モードで表示されます。 [その他] ボタンとして機能する細いバーのみを表示するには、モードを [最小 ] に設定できます。 最小モードでは、ユーザーはバーの任意の場所を押して開くことができます。 CommandBar が 最小 モードでどのように表示されるかを次に示します。
ClosedDisplayMode を変更して、ユーザーに多かれ少なかれヒントを提供すると、周囲の要素のレイアウトに影響します。 閉じた状態と開いている間に CommandBar が切り替わると、他の要素のレイアウトには影響しません。
IsSticky
CommandBar を開いた後、ユーザーがコントロールの外側の任意の場所でアプリを操作すると、既定ではオーバーフロー メニューは閉じられ、ラベルは非表示になります。 この方法で閉じることを簡易非表示と呼びます。 バーが閉じる方法を制御するには、IsSticky プロパティを設定します。 バーがスティッキー (IsSticky ="true ") の場合、軽い無視ジェスチャでは閉じません。 ユーザーが [その他] ボタンを押すか、存在する場合はオーバーフロー メニューから項目を選択するまで、アプリ バーは表示されたままです。
配置
アプリ コンテンツと共に、XAML 内の任意の場所に CommandBar をインラインで配置できます。 タッチ キーボードまたはソフト入力パネル (SIP) が表示されたときに CommandBar をユーザーに表示したままにする必要がある場合は、Page の BottomAppBar プロパティに割り当てることができ、ソフト入力パネル (SIP) が存在する場合は表示されたままに移動します。 それ以外の場合は、インラインに配置し、アプリのコンテンツを基準にして配置する必要があります。 CommandBar を配置する場所は、スティッキーにするか、閉じたときに最小モードを使用するかなどに影響します。 詳細とガイダンスについては、「 コマンド バーのガイドライン」を参照してください。
コントロールのスタイルとテンプレート
既定の スタイル と ControlTemplate を変更して、コントロールに一意の外観を与えることができます。 コントロールのスタイルとテンプレートの変更については、「 XAML スタイル」を参照してください。 コントロールの外観を定義する既定のスタイル、テンプレート、およびリソースがファイルに generic.xaml
含まれます。 設計上の目的で、 generic.xaml
は Windows アプリ SDK NuGet パッケージと共にインストールされます。 既定では、この場所は \Users\<username>\.nuget\packages\microsoft.windowsappsdk\<version>\lib\uap10.0\Microsoft.UI\Themes\generic.xaml
です。 SDK の異なるバージョンのスタイルとリソースの値が異なる場合があります。
XAML には、コントロール テンプレートを変更せずに、さまざまなビジュアル状態のコントロールの色を変更するために使用できるリソースも含まれています。 これらのリソースを変更することは、 Background や Foreground などのプロパティを設定する場合に適 しています。 詳細については、XAML スタイルに関する記事の「軽量スタイル設定」セクションを参照してください。
コンストラクター
CommandBar() |
CommandBar クラスの新しいインスタンスを初期化します。 |
プロパティ
AccessKey |
この要素のアクセス キー (ニーモニック) を取得または設定します。 (継承元 UIElement) |
AccessKeyScopeOwner |
ソース要素のビジュアル ツリーにない場合でも、この要素のアクセス キー スコープを提供するソース要素を取得または設定します。 (継承元 UIElement) |
ActualHeight |
FrameworkElement のレンダリングされた高さを取得します。 「解説」を参照してください。 (継承元 FrameworkElement) |
ActualOffset |
レイアウト プロセスの配置パス中に計算された、親に対して相対的なこの UIElement の位置を取得します。 (継承元 UIElement) |
ActualSize |
レイアウト プロセスの配置パス中にこの UIElement が計算したサイズを取得します。 (継承元 UIElement) |
ActualTheme |
要素によって現在使用されている UI テーマを取得します。 これは RequestedTheme とは異なる場合があります。 (継承元 FrameworkElement) |
ActualWidth |
FrameworkElement のレンダリングされた幅を取得します。 「解説」を参照してください。 (継承元 FrameworkElement) |
AllowDrop |
この UIElement をドラッグ アンド ドロップ操作の目的でドロップ ターゲットにできるかどうかを決定する値を取得または設定します。 (継承元 UIElement) |
AllowFocusOnInteraction |
ユーザーが操作するときに要素が自動的にフォーカスを取得するかどうかを示す値を取得または設定します。 (継承元 FrameworkElement) |
AllowFocusWhenDisabled |
無効なコントロールがフォーカスを受け取ることができるかどうかを取得または設定します。 (継承元 FrameworkElement) |
Background |
コントロールの背景を提供するブラシを取得または設定します。 (継承元 Control) |
BackgroundSizing |
この要素の境界線に対する背景の延長距離を示す値を取得または設定します。 (継承元 Control) |
BaseUri |
XAML 読み込み時に XAML で構築されたオブジェクトのベース URI を表す Uniform Resource Identifier (URI) を取得します。 このプロパティは、実行時の URI 解決に役立ちます。 (継承元 FrameworkElement) |
BorderBrush |
コントロールの境界線の塗りつぶしを表すブラシを取得または設定します。 (継承元 Control) |
BorderThickness |
コントロールの境界線の太さを取得または設定します。 (継承元 Control) |
CacheMode |
レンダリングされたコンテンツを可能な限り複合ビットマップとしてキャッシュする必要があることを示す値を取得または設定します。 (継承元 UIElement) |
CanBeScrollAnchor |
UIElement をスクロール アンカーの候補にできるかどうかを示す値を取得または設定します。 (継承元 UIElement) |
CanDrag |
要素をドラッグ アンド ドロップ操作でデータとしてドラッグできるかどうかを示す値を取得または設定します。 (継承元 UIElement) |
CenterPoint |
要素の中心点 (回転またはスケーリングが発生するポイント) を取得または設定します。 要素のレンダリング位置に影響します。 (継承元 UIElement) |
CharacterSpacing |
em の 1/1000 単位の文字間の均一な間隔を取得または設定します。 (継承元 Control) |
Clip |
UIElement の内容のアウトラインを定義するために使用する RectangleGeometry を取得または設定します。 (継承元 UIElement) |
ClosedDisplayMode |
アプリ バーが完全に開かないときにアイコン ボタンを表示するかどうかを示す値を取得または設定します。 (継承元 AppBar) |
CommandBarOverflowPresenterStyle |
CommandBar のオーバーフロー コンテンツに適用されるスタイルを取得または設定します。 |
CommandBarOverflowPresenterStyleProperty |
CommandBarOverflowPresenterStyle 依存関係プロパティを識別します。 |
CommandBarTemplateSettings |
CommandBar コントロールのテンプレートを定義するときに {TemplateBinding} マークアップ拡張ソースとして参照できる計算値を提供する オブジェクトを取得します。 |
CompositeMode |
親レイアウトとウィンドウ内の要素の代替合成モードとブレンド モードを宣言するプロパティを取得または設定します。 これは、混合 XAML/Microsoft DirectX UI に関連する要素に関連します。 (継承元 UIElement) |
Content |
ContentControl のコンテンツを取得または設定します。 (継承元 ContentControl) |
ContentTemplate |
ContentControl のコンテンツを表示するために使用するデータ テンプレートを取得または設定します。 (継承元 ContentControl) |
ContentTemplateRoot |
ContentTemplate プロパティで指定されたデータ テンプレートのルート要素を取得します。 (継承元 ContentControl) |
ContentTemplateSelector |
実行時にコンテンツ アイテムまたはそのコンテナーに関する処理情報に基づいて、コンテンツに適用する DataTemplate を変更する選択オブジェクトを取得または設定します。 (継承元 ContentControl) |
ContentTransitions |
ContentControl のコンテンツに適用される Transition スタイル要素のコレクションを取得または設定します。 (継承元 ContentControl) |
ContextFlyout |
この要素に関連付けられているポップアップを取得または設定します。 (継承元 UIElement) |
CornerRadius |
コントロールの境界線の角の半径を取得または設定します。 (継承元 Control) |
DataContext |
FrameworkElement のデータ コンテキストを取得または設定します。 データ コンテキストの一般的な用途は、 が {Binding} マークアップ拡張機能を使用し、データ バインディングに参加する場合 |
DefaultLabelPosition |
コマンド バーのボタンのラベルの配置と表示を示す値を取得または設定します。 |
DefaultLabelPositionProperty |
DefaultLabelPosition 依存関係プロパティを識別します。 |
DefaultStyleKey |
コントロールの既定のスタイルを参照するキーを取得または設定します。 カスタム コントロールの作成者は、このプロパティを使用して、コントロールが使用するスタイルの既定値を変更します。 (継承元 Control) |
DefaultStyleResourceUri |
コントロールの既定のスタイルを含むリソース ファイルへのパスを取得または設定します。 (継承元 Control) |
DesiredSize |
レイアウト プロセスのメジャー パス中にこの UIElement が計算したサイズを取得します。 (継承元 UIElement) |
Dispatcher |
常に Windows アプリ SDK アプリで を返します |
DispatcherQueue |
このオブジェクトが |
ElementSoundMode |
サウンドを再生するかどうかのコントロールの設定を指定する値を取得または設定します。 (継承元 Control) |
ExitDisplayModeOnAccessKeyInvoked |
アクセス キーが呼び出されたときにアクセス キーの表示を閉じるかどうかを指定する値を取得または設定します。 (継承元 UIElement) |
FlowDirection |
レイアウトを制御する任意の親要素内でテキストやその他の UI 要素が流れる方向を取得または設定します。 このプロパティは、 または |
FocusState |
このコントロールにフォーカスがあるかどうかを示す値と、フォーカスが取得されたモードを取得します。 (継承元 UIElement) |
FocusVisualMargin |
FrameworkElement のフォーカス ビジュアルの外側の余白を取得または設定します。 (継承元 FrameworkElement) |
FocusVisualPrimaryBrush |
FrameworkElement の または |
FocusVisualPrimaryThickness |
FrameworkElement の または フォーカス ビジュアルの外側の境界線の |
FocusVisualSecondaryBrush |
FrameworkElement の または |
FocusVisualSecondaryThickness |
FrameworkElement の または フォーカス ビジュアルの内側の境界線の |
FontFamily |
コントロール内にテキストを表示するために使用されるフォントを取得または設定します。 (継承元 Control) |
FontSize |
このコントロール内のテキストのサイズを取得または設定します。 (継承元 Control) |
FontStretch |
画面上でのフォントの縮小率または拡大率を取得または設定します。 (継承元 Control) |
FontStyle |
テキストをレンダリングするスタイルを取得または設定します。 (継承元 Control) |
FontWeight |
指定したフォントの太さを取得または設定します。 (継承元 Control) |
Foreground |
前景色を表すブラシを取得または設定します。 (継承元 Control) |
Height |
FrameworkElement の推奨される高さを取得または設定します。 (継承元 FrameworkElement) |
HighContrastAdjustment |
ハイ コントラスト テーマが有効になっている場合に、フレームワークが要素のビジュアル プロパティを自動的に調整するかどうかを示す値を取得または設定します。 (継承元 UIElement) |
HorizontalAlignment |
レイアウトの親 (パネルや項目コントロールなど) で構成されている場合に FrameworkElement に適用される水平方向の配置特性を取得または設定します。 (継承元 FrameworkElement) |
HorizontalContentAlignment |
コントロールのコンテンツの水平方向の配置を取得または設定します。 (継承元 Control) |
IsAccessKeyScope |
要素が独自のアクセス キー スコープを定義するかどうかを示す値を取得または設定します。 (継承元 UIElement) |
IsDoubleTapEnabled |
DoubleTapped イベントがその要素から発生するかどうかを決定する値を取得または設定します。 (継承元 UIElement) |
IsDynamicOverflowEnabled |
領域が制限されている場合に、プライマリ コマンドがオーバーフロー メニューに自動的に移動するかどうかを示す値を取得または設定します。 |
IsDynamicOverflowEnabledProperty |
IsDynamicOverflowEnabled 依存関係プロパティを識別します。 |
IsEnabled |
ユーザーがコントロールと対話できるかどうかを示す値を取得または設定します。 (継承元 Control) |
IsFocusEngaged |
ユーザーがゲーム コントローラーの A/Select ボタンを押したときに、フォーカスがコントロールに制限されているかどうかを示す値を取得または設定します。 (継承元 Control) |
IsFocusEngagementEnabled |
ユーザーがゲーム コントローラーの A/Select ボタンを押したときに、フォーカスをコントロールに制限できるかどうかを示す値を取得または設定します。 (継承元 Control) |
IsHitTestVisible |
この UIElement の包含領域がヒット テストの true 値を返すことができるかどうかを取得または設定します。 (継承元 UIElement) |
IsHoldingEnabled |
Holding イベントがその要素から発生するかどうかを決定する値を取得または設定します。 (継承元 UIElement) |
IsLoaded |
要素が要素ツリーに追加され、操作の準備ができているかどうかを示す値を取得します。 (継承元 FrameworkElement) |
IsOpen |
AppBar が開いているかどうかを示す値を取得または設定します。 (継承元 AppBar) |
IsRightTapEnabled |
RightTapped イベントがその要素から発生するかどうかを決定する値を取得または設定します。 (継承元 UIElement) |
IsSticky |
軽い無視時に AppBar が閉じないかどうかを示す値を取得または設定します。 (継承元 AppBar) |
IsTabStop |
コントロールがタブ ナビゲーションに含まれるかどうかを示す値を取得または設定します。 (継承元 UIElement) |
IsTapEnabled |
Tapped イベントがその要素から発生するかどうかを決定する値を取得または設定します。 (継承元 UIElement) |
IsTextScaleFactorEnabled |
システム のテキスト サイズ設定を反映するように、自動テキストの拡大を有効にするかどうかを取得または設定します。 (継承元 Control) |
KeyboardAcceleratorPlacementMode |
コントロール のヒント に、関連付けられているキーボード アクセラレータのキーの組み合わせを表示するかどうかを示す値を取得または設定します。 (継承元 UIElement) |
KeyboardAcceleratorPlacementTarget |
アクセラレータ キーの組み合わせを表示 するコントロールヒント を示す値を取得または設定します。 (継承元 UIElement) |
KeyboardAccelerators |
キーボードを使用してアクションを呼び出すキーの組み合わせのコレクションを取得します。 アクセラレータは通常、ボタンまたはメニュー項目に割り当てられます。
|
KeyTipHorizontalOffset |
UIElement に関連してキー ヒントを左右に配置する距離を示す値を取得または設定します。 (継承元 UIElement) |
KeyTipPlacementMode |
アクセス キーのキー ヒントが UIElement の境界に対して配置される場所を示す値を取得または設定します。 (継承元 UIElement) |
KeyTipTarget |
アクセス キーのキー ヒントの対象となる要素を示す値を取得または設定します。 (継承元 UIElement) |
KeyTipVerticalOffset |
UI 要素に関連してキー ヒントを配置する距離を示す値を取得または設定します。 (継承元 UIElement) |
Language |
FrameworkElement に適用されるローカライズ/グローバリゼーション言語情報、およびオブジェクト表現および UI の現在の FrameworkElement のすべての子要素を取得または設定します。 (継承元 FrameworkElement) |
LightDismissOverlayMode |
ライトを閉じる UI の外側の領域を暗くするかどうかを指定する値を取得または設定します。 (継承元 AppBar) |
Lights |
この要素にアタッチされている XamlLight オブジェクトのコレクションを取得します。 (継承元 UIElement) |
ManipulationMode |
UIElement の動作とジェスチャとの対話に使用される ManipulationModes 値を取得または設定します。 この値を設定すると、アプリ コードでこの要素から操作イベントを処理できます。 (継承元 UIElement) |
Margin |
FrameworkElement の外側の余白を取得または設定します。 (継承元 FrameworkElement) |
MaxHeight |
FrameworkElement の最大高さ制約を取得または設定します。 (継承元 FrameworkElement) |
MaxWidth |
FrameworkElement の最大幅制約を取得または設定します。 (継承元 FrameworkElement) |
MinHeight |
FrameworkElement の最小高さ制約を取得または設定します。 (継承元 FrameworkElement) |
MinWidth |
FrameworkElement の最小幅制約を取得または設定します。 (継承元 FrameworkElement) |
Name |
オブジェクトの識別名を取得または設定します。 XAML プロセッサが XAML マークアップからオブジェクト ツリーを作成する場合、ランタイム コードはこの名前で XAML で宣言されたオブジェクトを参照できます。 (継承元 FrameworkElement) |
Opacity |
オブジェクトの不透明度の程度を取得または設定します。 (継承元 UIElement) |
OpacityTransition |
Opacity プロパティへの変更をアニメーション化する ScalarTransition を取得または設定します。 (継承元 UIElement) |
OverflowButtonVisibility |
コマンド バーのオーバーフロー ボタンが表示されるタイミングを示す値を取得または設定します。 |
OverflowButtonVisibilityProperty |
OverflowButtonVisibility 依存関係プロパティを識別します。 |
Padding |
コントロールのパディングを取得または設定します。 (継承元 Control) |
Parent |
オブジェクト ツリー内のこの FrameworkElement の親オブジェクトを取得します。 (継承元 FrameworkElement) |
PointerCaptures |
Pointer 値として表されるすべてのキャプチャされたポインターのセット を取得します 。 (継承元 UIElement) |
PrimaryCommands |
CommandBar のプライマリ コマンド要素のコレクションを取得します。 |
PrimaryCommandsProperty |
PrimaryCommands 依存関係プロパティを識別します。 |
Projection |
この要素をレンダリングするときに適用するパースペクティブ プロジェクション (3-D 効果) を取得または設定します。 (継承元 UIElement) |
ProtectedCursor |
ポインターがこの要素の上にあるときに表示されるカーソルを取得または設定します。 既定値は null で、カーソルに変更がないことを示します。 (継承元 UIElement) |
RasterizationScale |
各ビュー ピクセルの生 (物理) ピクセルの数を表す値を取得します。 (継承元 UIElement) |
RenderSize |
UIElement の最終的なレンダリング サイズを取得します。 使用は推奨されません。「備考」を参照してください。 (継承元 UIElement) |
RenderTransform |
UIElement のレンダリング位置に影響する変換情報を取得または設定します。 (継承元 UIElement) |
RenderTransformOrigin |
UIElement の境界を基準にして RenderTransform によって宣言された、可能なレンダリング変換の原点を取得または設定します。 (継承元 UIElement) |
RequestedTheme |
リソースの決定に UIElement (およびその子要素) によって使用される UI テーマを取得または設定します。 で |
RequiresPointer |
UI 要素がマウス モードをサポートするかどうかを取得または設定します。これは、キーボードやゲーム コントローラーなどのポインター以外の入力デバイスとのポインター操作エクスペリエンスをエミュレートします。 (継承元 Control) |
Resources |
ローカルに定義されたリソース ディクショナリを取得します。 XAML では、XAML の暗黙的なコレクション構文を使用して、プロパティ要素の |
Rotation |
時計回りの回転角度を度単位で取得または設定します。 RotationAxis と CenterPoint を基準にして回転します。 要素のレンダリング位置に影響します。 (継承元 UIElement) |
RotationAxis |
要素を回転させる軸を取得または設定します。 (継承元 UIElement) |
RotationTransition |
Rotation プロパティの変更をアニメーション化する ScalarTransition を取得または設定します。 (継承元 UIElement) |
Scale |
要素のスケールを取得または設定します。 要素の CenterPoint を基準にして拡大縮小します。 要素のレンダリング位置に影響します。 (継承元 UIElement) |
ScaleTransition |
Scale プロパティの変更をアニメーション化する Vector3Transition を取得または設定します。 (継承元 UIElement) |
SecondaryCommands |
CommandBar のセカンダリ コマンド要素のコレクションを取得します。 |
SecondaryCommandsProperty |
SecondaryCommands 依存関係プロパティを識別します。 |
Shadow |
要素によってキャストされる影効果を取得または設定します。 (継承元 UIElement) |
Style |
レイアウトおよびレンダリング中にこのオブジェクトに適用されるインスタンス Style を取得または設定します。 (継承元 FrameworkElement) |
TabFocusNavigation |
このコントロールのタブと TabIndex の動作方法を変更する値を取得または設定します。 (継承元 UIElement) |
TabIndex |
ユーザーが Tab キーを使用してコントロール内を移動するときに要素がフォーカスを受け取る順序を決定する値を取得または設定します。 (継承元 UIElement) |
TabNavigation |
このコントロールのタブと UIElement.TabIndex の動作方法を変更する値を取得または設定します。 注意 Windows 10 Creators Update (ビルド 10.0.15063) 以降では、UiElement 基本クラスで TabFocusNavigation プロパティを使用して、ControlTemplate を使用しないタブ シーケンスにオブジェクトを含めることができます。 |
Tag |
このオブジェクトに関するカスタム情報を格納するために使用できる任意のオブジェクト値を取得または設定します。 (継承元 FrameworkElement) |
Template |
コントロール テンプレートを取得または設定します。 コントロール テンプレートは UI でコントロールの視覚的な外観を定義し、XAML マークアップで定義されます。 (継承元 Control) |
TemplateSettings |
AppBar コントロールのテンプレートを定義するときに {TemplateBinding} マークアップ拡張ソースとして参照できる計算値を提供するオブジェクトを取得します。 (継承元 AppBar) |
Transform3D |
この要素をレンダリングするときに適用する 3-D 変換効果を取得または設定します。 (継承元 UIElement) |
TransformMatrix |
要素に適用する変換行列を取得または設定します。 (継承元 UIElement) |
Transitions |
UIElement に適用される Transition スタイル要素のコレクションを取得または設定します。 (継承元 UIElement) |
Translation |
要素の x、y、z のレンダリング位置を取得または設定します。 (継承元 UIElement) |
TranslationTransition |
Translation プロパティの変更をアニメーション化する Vector3Transition を取得または設定します。 (継承元 UIElement) |
Triggers |
FrameworkElement に対して定義されているアニメーションのトリガーのコレクションを取得します。 一般的に使用されません。 「解説」を参照してください。 (継承元 FrameworkElement) |
UseLayoutRounding |
オブジェクトとそのビジュアル サブツリーのレンダリングで、レンダリングをピクセル全体に合わせる丸め動作を使用するかどうかを決定する値を取得または設定します。 (継承元 UIElement) |
UseSystemFocusVisuals |
コントロールがシステムによって描画されたフォーカス ビジュアルを使用するか、コントロール テンプレートで定義されているフォーカス ビジュアルを使用するかを示す値を取得または設定します。 (継承元 UIElement) |
VerticalAlignment |
パネルや項目コントロールなどの親オブジェクトで構成されている場合に FrameworkElement に適用される垂直方向の配置特性を取得または設定します。 (継承元 FrameworkElement) |
VerticalContentAlignment |
コントロールのコンテンツの垂直方向の配置を取得または設定します。 (継承元 Control) |
Visibility |
UIElement の可視性を取得または設定します。
|
Width |
FrameworkElement の幅を取得または設定します。 (継承元 FrameworkElement) |
XamlRoot |
この要素が表示される を |
XYFocusDown |
ユーザーがゲーム コントローラーの方向パッド (D パッド) を押したときにフォーカスを取得するオブジェクトを取得または設定します。 (継承元 UIElement) |
XYFocusDownNavigationStrategy |
ダウン ナビゲーションのターゲット要素を決定するために使用する戦略を指定する値を取得または設定します。 (継承元 UIElement) |
XYFocusKeyboardNavigation |
キーボード方向矢印を使用してナビゲーションを有効または無効にする値を取得または設定します。 (継承元 UIElement) |
XYFocusLeft |
ユーザーがゲーム コントローラーの方向パッド (D パッド) を左に押したときにフォーカスを取得するオブジェクトを取得または設定します。 (継承元 UIElement) |
XYFocusLeftNavigationStrategy |
左ナビゲーションのターゲット要素を決定するために使用される戦略を指定する値を取得または設定します。 (継承元 UIElement) |
XYFocusRight |
ユーザーがゲーム コントローラーの方向パッド (D パッド) を右に押したときにフォーカスを取得するオブジェクトを取得または設定します。 (継承元 UIElement) |
XYFocusRightNavigationStrategy |
右ナビゲーションのターゲット要素を決定するために使用する戦略を指定する値を取得または設定します。 (継承元 UIElement) |
XYFocusUp |
ユーザーがゲーム コントローラーの方向パッド (D パッド) を押したときにフォーカスを取得するオブジェクトを取得または設定します。 (継承元 UIElement) |
XYFocusUpNavigationStrategy |
アップ ナビゲーションのターゲット要素を決定するために使用する戦略を指定する値を取得または設定します。 (継承元 UIElement) |
メソッド
イベント
AccessKeyDisplayDismissed |
アクセス キーが表示されなくなったときに発生します。 (継承元 UIElement) |
AccessKeyDisplayRequested |
ユーザーがアクセス キーの表示を要求したときに発生します。 (継承元 UIElement) |
AccessKeyInvoked |
ユーザーがアクセス キー シーケンスを完了したときに発生します。 (継承元 UIElement) |
ActualThemeChanged |
ActualTheme プロパティの値が変更されたときに発生します。 (継承元 FrameworkElement) |
BringIntoViewRequested |
この要素またはその子孫のいずれかで StartBringIntoView が呼び出されたときに発生します。 (継承元 UIElement) |
CharacterReceived |
1 つの構成済み文字が入力キューによって受信されたときに発生します。 (継承元 UIElement) |
Closed |
AppBar が表示から非表示に変わるときに発生します。 (継承元 AppBar) |
Closing |
AppBar が表示から非表示に変更され始めると発生します。 (継承元 AppBar) |
ContextCanceled |
コンテキスト入力ジェスチャが操作ジェスチャに続き、コンテキスト ポップアップを開くべきではないことを要素に通知するときに発生します。 (継承元 UIElement) |
ContextRequested |
ユーザーが右クリックなどのコンテキスト入力ジェスチャを完了したときに発生します。 (継承元 UIElement) |
DataContextChanged |
FrameworkElement.DataContext プロパティの値が変更されたときに発生します。 (継承元 FrameworkElement) |
DoubleTapped |
この要素のヒット テスト領域で、それ以外の方法でハンドルされない DoubleTap 相互作用が発生したときに発生します。 (継承元 UIElement) |
DragEnter |
入力システムが、この要素をターゲットとして使用して基になるドラッグ イベントを報告するときに発生します。 (継承元 UIElement) |
DragLeave |
入力システムが、この要素を原点として基になるドラッグ イベントを報告するときに発生します。 (継承元 UIElement) |
DragOver |
この要素がドロップ先となる可能性のある、基になるドラッグ イベントを入力システムが報告したときに発生します。 (継承元 UIElement) |
DragStarting |
ドラッグ操作が開始されたときに発生します。 (継承元 UIElement) |
Drop |
入力システムがこの要素をドロップ先とするドロップ イベントを報告したときに発生します。 (継承元 UIElement) |
DropCompleted |
ソースとしてこの要素を使用したドラッグ アンド ドロップ操作が終了したときに発生します。 (継承元 UIElement) |
DynamicOverflowItemsChanging |
アイテムがオーバーフロー メニューに移動またはオーバーフロー メニューから移動したときに発生します。 |
EffectiveViewportChanged |
FrameworkElement の有効なビューポートが変更されたときに発生します。 (継承元 FrameworkElement) |
FocusDisengaged |
ユーザーがゲーム コントローラーの B/Back ボタンを押したときに、コントロールからフォーカスが離されたときに発生します。 (継承元 Control) |
FocusEngaged |
ユーザーがゲーム コントローラーの [A/Select] ボタンを押すと、フォーカスがコントロールに制限されるときに発生します。 (継承元 Control) |
GettingFocus |
UIElement がフォーカスを受け取る前に発生します。 このイベントは、イベントがバブルしている間にフォーカスが移動されないように同期的に発生します。 (継承元 UIElement) |
GotFocus |
UIElement がフォーカスを受け取ったときに発生します。 このイベントは非同期的に発生するため、バブルが完了する前にフォーカスを再び移動できます。 (継承元 UIElement) |
Holding |
この要素のヒット テスト領域で、それ以外の場合はハンドルされない 保留 操作が発生したときに発生します。 (継承元 UIElement) |
IsEnabledChanged |
IsEnabled プロパティが変更されたときに発生します。 (継承元 Control) |
KeyDown |
UIElement にフォーカスがあるときにキーボード キーが押されたときに発生します。 (継承元 UIElement) |
KeyUp |
UIElement にフォーカスがあるときにキーボード キーが解放されたときに発生します。 (継承元 UIElement) |
LayoutUpdated |
レイアウト関連のプロパティが値を変更したり、レイアウトを更新するその他のアクションが原因で、ビジュアル ツリーのレイアウトが変更されたときに発生します。 (継承元 FrameworkElement) |
Loaded |
FrameworkElement が構築され、オブジェクト ツリーに追加され、操作の準備ができたときに発生します。 (継承元 FrameworkElement) |
Loading |
FrameworkElement の読み込みが開始されたときに発生します。 (継承元 FrameworkElement) |
LosingFocus |
UIElement がフォーカスを失う前に発生します。 このイベントは、イベントがバブルしている間にフォーカスが移動されないように同期的に発生します。 (継承元 UIElement) |
LostFocus |
UIElement がフォーカスを失ったときに発生します。 このイベントは非同期的に発生するため、バブルが完了する前にフォーカスを再び移動できます。 (継承元 UIElement) |
ManipulationCompleted |
UIElement の操作が完了したときに発生します。 (継承元 UIElement) |
ManipulationDelta |
操作中に入力デバイスが位置を変更したときに発生します。 (継承元 UIElement) |
ManipulationInertiaStarting |
操作中に入力デバイスが UIElement オブジェクトとのコンタクトを失ったときと慣性が開始したときに発生します。 (継承元 UIElement) |
ManipulationStarted |
入力デバイスが UIElement に対する操作を開始すると発生します。 (継承元 UIElement) |
ManipulationStarting |
操作プロセッサを初めて作成するときに発生します。 (継承元 UIElement) |
NoFocusCandidateFound |
ユーザーが (タブまたは方向矢印を使用して) フォーカスを移動しようとしたときに、フォーカス候補が移動方向に見つからないため、フォーカスが移動しない場合に発生します。 (継承元 UIElement) |
Opened |
AppBar が非表示から表示に変わるときに発生します。 (継承元 AppBar) |
Opening |
AppBar が非表示から表示に変更され始めると発生します。 (継承元 AppBar) |
PointerCanceled |
接触したポインターが異常に接触を失ったときに発生します。 (継承元 UIElement) |
PointerCaptureLost |
この要素によって以前に保持されていたポインター キャプチャが別の要素または別の場所に移動したときに発生します。 (継承元 UIElement) |
PointerEntered |
ポインターがこの要素のヒット テスト領域に入ったときに発生します。 (継承元 UIElement) |
PointerExited |
ポインターがこの要素のヒット テスト領域から離れると発生します。 (継承元 UIElement) |
PointerMoved |
ポインターがこの要素のヒット テスト領域内に残っている間にポインターが移動したときに発生します。 (継承元 UIElement) |
PointerPressed |
ポインター デバイスがこの要素内で Press アクションを開始したときに発生します。 (継承元 UIElement) |
PointerReleased |
この要素内で、以前に Press アクションを開始したポインター デバイスが解放されたときに発生します。
Press アクションの終了がイベントを発生 |
PointerWheelChanged |
ポインター ホイールのデルタ値が変更されたときに発生します。 (継承元 UIElement) |
PreviewKeyDown |
UIElement にフォーカスがあるときにキーボード キーが押されたときに発生します。 (継承元 UIElement) |
PreviewKeyUp |
UIElement にフォーカスがあるときにキーボード キーが解放されたときに発生します。 (継承元 UIElement) |
ProcessKeyboardAccelerators |
キーボード ショートカット (またはアクセラレータ) が押されたときに発生します。 (継承元 UIElement) |
RightTapped |
ポインターが要素の上にある間に右タップ入力刺激が発生したときに発生します。 (継承元 UIElement) |
SizeChanged |
ActualHeight プロパティまたは ActualWidth プロパティが FrameworkElement の値を変更したときに発生します。 (継承元 FrameworkElement) |
Tapped |
この要素のヒット テスト領域で、それ以外のハンドルされない Tap 操作が発生したときに発生します。 (継承元 UIElement) |
Unloaded |
このオブジェクトがメイン オブジェクト ツリーに接続されなくなったときに発生します。 (継承元 FrameworkElement) |