Control クラス
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
ControlTemplate を使用して外観を定義する UI 要素の基本クラスを表します。 ContentControl、UserControl、ItemsControl、およびいくつかの実用的なコントロールの親クラス。
public ref class Control : FrameworkElement/// [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 Control : FrameworkElement[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 Control : FrameworkElementPublic Class Control
Inherits FrameworkElement- 継承
- 派生
- 属性
注釈
Control クラスは、アプリとその UI に追加する多くのコントロールの基本クラスです。 Control クラスは動作をほとんど定義しません。UI 用の XAML に実際の Control 要素を追加できますが、通常は 、Button や ListBox など、直接または間接的に Control から継承するものを追加します。 使用できるコントロールの一覧については、「Windows アプリのControlsを参照してください。
型 ControlTemplate を使用する Template プロパティは、コントロールの外観を指定します。 コントロールの外観を変更するが、その機能を保持する場合は、新しいコントロール ベースのクラスを定義するのではなく、新しい ControlTemplate を 作成することを検討する必要があります。 詳細については、「 コントロール テンプレート」を参照してください。
コントロールは UserControl の親です。 UserControl は、表示状態を必要としない軽量コントロール用の基本クラスです。 UserControl は技術的には Template プロパティを継承しますが、UserControl にテンプレートを適用することはできません。
コントロールの暗黙的なスタイル
XAML に対して定義されている各実用的なコントロールには、既定のコントロール テンプレートを含む既定のスタイルがあります。 コントロールには暗黙的なスタイルを設定できます。つまり、 FrameworkElement.Style プロパティが明示的に設定されていません。 その暗黙的なスタイルを使用できるようになったら、その Style の Setter 要素を使用して、コントロールの他のほぼすべてのプロパティを設定できます。 Style は、コントロール ロジックの残りの部分とは別にコントロールを初期化でき、各プロパティのコード ベースの既定値ではない値を設定できます。
暗黙的なスタイルは、XAML のバイナリ表現として内部的に格納される、Windows Runtimeの一部であるキー付きリソースとして存在します。 特定のコントロールのスタイルまたはスタイルの完全なセットのコピーを取得して、スタイルとコントロール テンプレートがどのように定義されているかを調えることができます。
特定のコントロール型と、既定で使用する暗黙的なスタイルのキー/名前の間の関連付けは、 DefaultStyleKey プロパティの値によって確立されます。 DefaultStyleKey プロパティは保護されているため、コントロール クラスをサブクラス化するユーザーのみが値を変更できます。 XAML UI でコントロールを宣言するなど、コントロール インスタンスを作成するだけの場合、既定のスタイルはコントロールの型に基づく暗黙的なスタイルです。 詳細については、「 DefaultStyleKey の解説」を参照してください。 DefaultStyleKey 値を変更して別のスタイルを使用する必要はありません。暗黙的なスタイル参照に一致し、XAML リソースとして存在する TargetType と同じ独自の XAML スタイルを定義するだけで済みます。 詳細については、「 コントロール テンプレート」を参照してください。
ビジュアル状態モデル
ビジュアル状態モデルは、コントロールのテンプレートで定義されているいくつかのプロパティのみを変更する手法です。 コントロールの動作を示す視覚的なフィードバックをユーザーに提供し、可能な追加の UI 操作にヒントを提供するために、プロパティ値を変更します。 コントロールは、テンプレート内の一部のプロパティに 0 期間または短い期間のストーリーボード付きアニメーションを適用することによって変更されます。 また、状態間の遷移に適用される短い期間のアニメーションを定義することもできます。
表示状態自体は、コントロール テンプレートの一部として定義されます。 各表示状態には名前が付いているため、コントロール ロジックは、特定のロジック状態に必要なときに各ビジュアル状態を読み込む GoToState メソッドを呼び出すことができます。 ビジュアル状態はビジュアル状態グループ内で宣言されるため、互いに排他的な表示状態によって、一度にアクティブな状態は 1 つだけになります。 同じグループの別の表示状態が読み込まれるとすぐに、前の状態のアニメーションは適用されなくなりますが、別のグループ内のアニメーションは引き続き実行され、その変更と視覚的な動作が適用される可能性があります。 たとえば、コントロールには、キーボード フォーカス用のビジュアル インジケーターとポインターオーバー用のビジュアル インジケーターが含まれます。 これらは互いに独立して調整でき、同時に発生する可能性がある UI モードであるため、それぞれ異なる表示状態グループで定義されます。
コントロール テンプレートの一部として XAML で定義されているため、UI で使用するすべての XAML コントロールの表示状態の動作を変更できます。 ただし、ロジックは、特定のビジュアル状態グループと名前付きビジュアル状態を検索することを期待するコントロールに基づいています。 そのため、コントロールの動作のすべての側面をユーザーに表示する正しい名前付きの構造化されたビジュアル状態を提供していることを十分に注意する必要があります。 表示状態は 、コントロール テンプレートで簡単に説明します。
コントロールの既定の表示状態では、ライブラリ アニメーションが使用される場合があります。 これらのアニメーションは UI のコントロールの外観の重要な部分であるため、コントロール テンプレートまたは表示状態を置き換えるときは、ライブラリ アニメーションを保持する必要があります。 詳細については、「 アニメーションの概要」を参照してください。
コントロールとフォーカス
Control クラスは、UI のキーボード フォーカス動作に影響を与える API をいくつか定義します。 FocusState プロパティ、 IsFocusEngaged、 IsEnabled、 IsTabStop プロパティです。 キーボード フォーカスを有効にすることは、各フォーカス可能な要素が UI のタブ オーダーの一部になるため、UI にアクセスできるようにすることの重要な部分です。 通常、キーボード フォーカスを受け取るには、対話型の UI 要素のみが有効になります。 たとえば、 TextBox は対話型です。ユーザーはテキストを入力できますが、テキストは読み取り専用であるため 、TextBlock は対話型ではありません。 Control から派生するほとんどのクラスは正当に対話型であるため、フォーカスを設定でき、タブ オーダーにする必要があるのが理にかなっています。
フォーカスを設定できるようにするには、これらのそれぞれが true である必要があります。
- 可視性 が 表示される
- IsEnabled は true です
- UIElement.IsTabStop が true です
- コントロールは、そのテンプレートを読み込んでインスタンス化する必要があります (読み込まれた 、アプリのルート ビジュアルに接続されているコントロール) コントロールにフォーカスを設定できない場合は、 UIElement.IsTabStop を false に設定できます。 ただし、コントロールにフォーカスを設定したくない理由が UI で対話型ではない場合は、 IsEnabled を false に設定して、操作の欠如をすべてのユーザーに明らかにすることをお勧めします。 多くのコントロールには、 IsEnabled =false に対して呼び出される定義済みの表示状態があります 。たとえば、ラベル内の "淡色表示" テキストなどです。
フォーカスの変更によって GotFocus または LostFocus イベントが発生する可能性があります。 "FocusedElement" 値 ( GetFocusedElement メソッドを介して公開) はすぐに更新されますが、 GotFocus または LostFocus の変更通知は非同期的に行われます。 この非同期フォーカス設計は、コントロール ロジックがフォーカスの変更に反応しすぎるときに、視覚的な状態遷移のちらつきを回避することを目的としています。
Focus(Microsoft。Ui。Xaml.FocusState) メソッドを使用すると、プログラムによってコントロールにキーボード フォーカスを設定できます。 このメソッドを呼び出すときは慎重に行う必要があります。ユーザーが予期していないときにキーボード フォーカスを移動するのは邪魔になる可能性があります。 Focus(Microsoft の主なシナリオ。Ui。Xaml.FocusState) UI のページ全体が読み込まれるときに最初のキーボード フォーカス ポイントを設定するか、親コントロール コンテナーがトップレベルのフォーカスを受け取った後にコントロールの特定の部分にフォーカスを設定します (コンボ ボックス内のテキスト ボックスのフォーカスなど)。 詳細については、「Focus(Microsoft」を参照してください。Ui。Xaml.FocusState)。 FocusState は、フォーカスがプログラムとユーザー駆動のどちらであるかを追跡します。これにより、表示状態に違いがあります。特に、すべてのコントロールに必要なキーボード フォーカスの視覚フォーカス インジケーターです。
イベント イベント ハンドラーのオーバーライド時
各 OnEvent メソッドは、対応する UIElement イベントの事前に接続されたイベント ハンドラーを表します。 Control から派生した実用的なコントロールは 、Onイベント メソッドをオーバーライドし、これを使用して、その入力イベントのコントロール固有の処理と動作を提供できます。 最も一般的なシナリオは、イベント ハンドラーを使用してイベント データでイベントを Handled としてマークすることです。 コントロール コードは、コントロール インスタンスでワイヤードされたイベント ハンドラーが呼び出される前に、このイベントを処理する最初の機会を持ちます。 イベント データが "処理済み" とマークされている場合、コントロール インスタンス上のハンドラーのような他のハンドラーは呼び出されません。 また、イベントはバブルしません。
コントロールに直接実装されているため、 Onイベント メソッドには空の実装があります。 しかし、コントロールの階層内の各先祖が実装を提供している可能性があります。 この実装は内部ネイティブ コードであるため、表示できません。 場合によっては、コントロールには、イベント処理済みをマークする Onイベントオーバーライドが既に存在します。 コントロールの最初の Onイベント オーバーライドを指定すると、独自のコントロール クラスからさらに派生したコントロールも、定義した Onイベント オーバーライドを継承します。 使用するすべてのインスタンスにもその動作があります。
Note
アプリ コードでは、コントロールの Onイベント メソッド ロジックによって処理済みとしてマークされている可能性があるイベントを処理できますが、UIElement.AddHandler メソッドに handledEventsToo パラメーターを使用する必要があります。 詳細については、 UIElement.AddHandler または イベントとルーティング イベントの概要に関するページを参照してください。
Control クラスは、それぞれフレームワーク レベルの入力イベントに関連付けられている複数の保護された仮想メソッドを定義します。 これらのメソッドは、コントロールがそのコントロールとそのすべてのインスタンスで特定の入力動作を使用するように、入力イベントに対して事前にワイヤードされたイベント ハンドラーを提供することを目的としています。 たとえば、UIElement によって定義された PointerPressed イベントがあります。 コントロールは、空の定義で OnPointerPressed メソッドを定義します。 基本 の Control コンストラクター内では、関連するすべての入力イベントのイベント配線に、リスナー/ハンドラーとして Onイベント メソッドが含まれています。このメソッドは、最初は何も行いません。 ただし、入力イベントの動作を変更するためにコントロールの作成者が必要なのは、 OnEvent メソッドの新しいオーバーライド定義を指定することです (また、コンストラクターがベースを呼び出していることを確認してください)。 別のサブクラスが再びオーバーライドしない限り、その動作はすべてのインスタンスまたはサブクラスに継承されます。 Onイベント イベントは最初に順番に行われるため、UI 定義 XAML の前にイベント データを調整し、イベントに関して他のリスナーに表示される条件を変更する可能性があります。
特定のコントロール クラスの既存の Onイベント 定義は、 OnEvent メソッドを自分でオーバーライドしていない場合でも、コントロールのコンシューマーとして影響を受ける可能性があります。 これは、既存の Onイベント 定義が、イベントのイベント データで Handled プロパティ値を true に設定するイベントの処理を提供している可能性があるためです。 これにより、インスタンスベースのイベント処理でイベントが表示されるのを防ぎ、ハンドラーが呼び出されるのを防ぐことができます。 ここで起きているのは、コントロールロジックと衝突する低レベルのイベントであるか、コントロールに置換ロジックがあるために、特定のイベントがコントロールに関係しないことを強制する意図的なコントロール設計があるということです。 この顕著な例として、 ButtonBase クラスがあります。 ButtonBase クラスには、OnPointerPressed と OnKeyDown のネイティブ オーバーライドによって適用される 2 つの動作があります。 これは、さまざまな入力モードを低レベルで組み合わせ、代わりにコントロール固有の Click イベントとしてレポートするためです。 PointerPressed イベント ハンドラーの場合、Button インスタンスでこれを処理しようとした場合、ハンドラーは呼び出されません。 これは、ネイティブ の OnPointerPressedによって Handled が true に設定され、 PointerPressed がインスタンスとアプリ コードに伝達されなかったためです。 OnKeyDown の場合、ロジックは特定のキー (Ctrl キーと Enter キー) を探していたので、インスタンス ハンドラーはそれらのキーも検索していない限り呼び出すことができます。
Note
実際には、入力イベントの一部に対する OnEvent メソッドのネイティブ処理を回避する方法があります。 これを行うには、 UIElement.AddHandler メソッドと handledEventsToo を使用してハンドラーをワイヤ化する必要があります。 詳細については、「 イベントとルーティング イベントの概要」を参照してください。
テキスト要素パーツを継承するテキスト プロパティ
コントロールは、テキストの表示に関連するいくつかのプロパティを定義します。 これらは次の通りです。
明らかに、すべてのコントロールが、その中にテキストを表示することを意図しているわけではありません。 たとえば、AppBarSeparatorで FontFamily を設定することは有効ですが、まったく効果はありません。 Control が基底クラス レベルでこれらのプロパティを定義する理由は、コントロール テンプレートで {TemplateBinding} マークアップ拡張を 使用して、テンプレート内に存在する 1 つ以上のテキスト要素パーツに最上位レベルのテキスト プロパティを簡単に適用できるようにするためです。 たとえば、 DatePicker のコントロール テンプレートを見ると、ルートがコンテナーであり、そのコンテナー内のより深い部分が、実際にテキスト入力を受け取る複数の ComboBox パーツであることがわかります。 これらの各ステートメントでは、FontWeight="{TemplateBinding FontWeight}"などのステートメントを使用して、DatePicker に設定された最上位の FontWeight を、内部のさまざまな部分で使用します。
また、コントロールのテキスト プロパティは、テキストを表示する ContentPresenter を持つコントロールに対しても暗黙的に継承されます。 たとえば、Button に FontSize を設定した場合、テンプレートまたは ContentPresenter パーツに明示的な {TemplateBinding} マークアップ拡張がなく、最上位の FontSize 値でテンプレートの動作を制御します。 ただし、 Control.FontSize 値は、テンプレートの定義内のコンテキストに基づいて ContentPresenter.FontSize によって暗黙的に継承されるため、 Button 内のテキストは、設定した Control.FontSize を使用して表示されます。
XAML 添付プロパティ
コントロールは、いくつかの XAML 添付プロパティのホスト サービス クラスです。
添付プロパティへの XAML プロセッサ アクセスをサポートし、同等の 取得 操作と 設定 操作をコードに公開するために、各 XAML 添付プロパティには、Get アクセサー メソッドと Set アクセサー メソッドのペアがあります。 コードで値を取得または設定するもう 1 つの方法は、依存関係プロパティ システムを使用して GetValue または SetValue を呼び出し、識別子フィールドを依存関係プロパティ識別子として渡すことです。
| 添付プロパティ | Description |
|---|---|
| IsTemplateFocusTarget | この要素がフォーカス ビジュアルを持つコントロール テンプレートの一部であるかどうかを示す値を取得または設定します。
|
| IsTemplateKeyTipTarget | この要素が KeyTip が配置されるコントロール テンプレートの一部であるかどうかを示す値を取得または設定します。
|
コンストラクター
| 名前 | 説明 |
|---|---|
| Control() |
コントロール派生クラスの基本クラス初期化動作を提供します。 |
プロパティ
| 名前 | 説明 |
|---|---|
| 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 |
コントロールの背景を提供するブラシを取得または設定します。 |
| BackgroundProperty |
Background 依存関係プロパティを識別します。 |
| BackgroundSizing |
この要素の境界線に対する背景の延長距離を示す値を取得または設定します。 |
| BackgroundSizingProperty |
BackgroundSizing 依存関係プロパティを識別します。 |
| BaseUri |
XAML の読み込み時に XAML で構築されたオブジェクトのベース URI を表す URI (Uniform Resource Identifier) を取得します。 このプロパティは、実行時の URI 解決に役立ちます。 (継承元 FrameworkElement) |
| BorderBrush |
コントロールの境界線の塗りつぶしを記述するブラシを取得または設定します。 |
| BorderBrushProperty |
BorderBrush 依存関係プロパティを識別します。 |
| BorderThickness |
コントロールの境界線の太さを取得または設定します。 |
| BorderThicknessProperty |
BorderThickness 依存関係プロパティを識別します。 |
| CacheMode |
レンダリングされたコンテンツを可能な限り複合ビットマップとしてキャッシュする必要があることを示す値を取得または設定します。 (継承元 UIElement) |
| CanBeScrollAnchor |
UIElement をスクロール アンカーの候補にできるかどうかを示す値を取得または設定します。 (継承元 UIElement) |
| CanDrag |
ドラッグ アンド ドロップ操作で要素をデータとしてドラッグできるかどうかを示す値を取得または設定します。 (継承元 UIElement) |
| CenterPoint |
要素の中心点 (回転またはスケーリングが行われる点) を取得または設定します。 要素のレンダリング位置に影響します。 (継承元 UIElement) |
| CharacterSpacing |
em の 1/1000 単位で文字間の均一な間隔を取得または設定します。 |
| CharacterSpacingProperty |
CharacterSpacing 依存関係プロパティを識別します。 |
| Clip |
UIElement の内容のアウトラインを定義するために使用する RectangleGeometry を取得または設定します。 (継承元 UIElement) |
| CompositeMode |
親レイアウトとウィンドウ内の要素の代替コンポジションモードとブレンド モードを宣言するプロパティを取得または設定します。 これは、混合 XAML/Microsoft DirectX UI に関係する要素に関連します。 (継承元 UIElement) |
| ContextFlyout |
この要素に関連付けられているポップアップを取得または設定します。 (継承元 UIElement) |
| CornerRadius |
コントロールの境界線の角の半径を取得または設定します。 |
| CornerRadiusProperty |
CornerRadius 依存関係プロパティを識別します。 |
| DataContext |
FrameworkElement のデータ コンテキストを取得または設定します。 データ コンテキストの一般的な用途は、 |
| DefaultStyleKey |
コントロールの既定のスタイルを参照するキーを取得または設定します。 カスタム コントロールの作成者は、このプロパティを使用して、コントロールが使用するスタイルの既定値を変更します。 |
| DefaultStyleKeyProperty |
DefaultStyleKey 依存関係プロパティを識別します。 |
| DefaultStyleResourceUri |
コントロールの既定のスタイルを含むリソース ファイルへのパスを取得または設定します。 |
| DefaultStyleResourceUriProperty |
DefaultStyleResourceUri 依存関係プロパティを識別します。 |
| DesiredSize |
レイアウト プロセスのメジャー パス中にこの UIElement が計算したサイズを取得します。 (継承元 UIElement) |
| Dispatcher |
Windows App SDK アプリで常に |
| DispatcherQueue |
このオブジェクトが関連付けられている |
| ElementSoundMode |
サウンドを再生するかどうかのコントロールの設定を指定する値を取得または設定します。 |
| ElementSoundModeProperty |
ElementSoundMode 依存関係プロパティを識別します。 |
| ExitDisplayModeOnAccessKeyInvoked |
アクセス キーの呼び出し時にアクセス キーの表示を閉じるかどうかを指定する値を取得または設定します。 (継承元 UIElement) |
| FlowDirection |
レイアウトを制御する任意の親要素内でテキストやその他の UI 要素が流れる方向を取得または設定します。 このプロパティは、 |
| FocusState |
このコントロールにフォーカスがあるかどうかを示す値と、フォーカスが取得されたモードを取得します。 (継承元 UIElement) |
| FocusVisualMargin |
FrameworkElement のフォーカス ビジュアルの外側の余白を取得または設定します。 (継承元 FrameworkElement) |
| FocusVisualPrimaryBrush |
FrameworkElement の |
| FocusVisualPrimaryThickness |
FrameworkElement の |
| FocusVisualSecondaryBrush |
FrameworkElement の |
| FocusVisualSecondaryThickness |
FrameworkElement の |
| FontFamily |
コントロール内のテキストを表示するために使用するフォントを取得または設定します。 |
| FontFamilyProperty |
FontFamily 依存関係プロパティを識別します。 |
| FontSize |
このコントロール内のテキストのサイズを取得または設定します。 |
| FontSizeProperty |
FontSize 依存関係プロパティを識別します。 |
| FontStretch |
画面でフォントを縮小または展開する度合いを取得または設定します。 |
| FontStretchProperty |
FontStretch 依存関係プロパティを識別します。 |
| FontStyle |
テキストをレンダリングするスタイルを取得または設定します。 |
| FontStyleProperty |
FontStyle 依存関係プロパティを識別します。 |
| FontWeight |
指定したフォントの太さを取得または設定します。 |
| FontWeightProperty |
FontWeight 依存関係プロパティを識別します。 |
| Foreground |
前景色を表すブラシを取得または設定します。 |
| ForegroundProperty |
Foreground 依存関係プロパティを識別します。 |
| Height |
FrameworkElement の推奨される高さを取得または設定します。 (継承元 FrameworkElement) |
| HighContrastAdjustment |
ハイ コントラスト テーマが有効な場合に、フレームワークが要素のビジュアル プロパティを自動的に調整するかどうかを示す値を取得または設定します。 (継承元 UIElement) |
| HorizontalAlignment |
パネルや項目コントロールなど、レイアウトの親で構成されている場合に FrameworkElement に適用される水平方向の配置特性を取得または設定します。 (継承元 FrameworkElement) |
| HorizontalContentAlignment |
コントロールのコンテンツの水平方向の配置を取得または設定します。 |
| HorizontalContentAlignmentProperty |
HorizontalContentAlignment 依存関係プロパティを識別します。 |
| IsAccessKeyScope |
要素が独自のアクセス キー スコープを定義するかどうかを示す値を取得または設定します。 (継承元 UIElement) |
| IsDoubleTapEnabled |
DoubleTapped イベントがその要素から発生するかどうかを決定する値を取得または設定します。 (継承元 UIElement) |
| IsEnabled |
ユーザーがコントロールを操作できるかどうかを示す値を取得または設定します。 |
| IsEnabledProperty |
IsEnabled 依存関係プロパティを識別します。 |
| IsFocusEngaged |
ユーザーがゲーム コントローラーの A/Select ボタンを押したときにフォーカスがコントロールに制限されているかどうかを示す値を取得または設定します。 |
| IsFocusEngagedProperty |
IsFocusEngaged 依存関係プロパティを識別します。 |
| IsFocusEngagementEnabled |
ユーザーがゲーム コントローラーの A/Select ボタンを押したときに、コントロールにフォーカスを制限できるかどうかを示す値を取得または設定します。 |
| IsFocusEngagementEnabledProperty |
IsFocusEngagementEnabled 依存関係プロパティを識別します。 |
| IsHitTestVisible |
この UIElement の包含領域がヒット テストの true 値を返すことができるかどうかを取得または設定します。 (継承元 UIElement) |
| IsHoldingEnabled |
Holding イベントがその要素から発生するかどうかを決定する値を取得または設定します。 (継承元 UIElement) |
| IsLoaded |
要素が要素ツリーに追加され、操作の準備ができているかどうかを示す値を取得します。 (継承元 FrameworkElement) |
| IsRightTapEnabled |
RightTapped イベントがその要素から発生するかどうかを決定する値を取得または設定します。 (継承元 UIElement) |
| IsTabStop |
コントロールがタブ ナビゲーションに含まれるかどうかを示す値を取得または設定します。 (継承元 UIElement) |
| IsTapEnabled |
Tapped イベントがその要素から発生するかどうかを決定する値を取得または設定します。 (継承元 UIElement) |
| IsTemplateFocusTargetProperty |
Control.IsTemplateFocusTarget XAML 添付プロパティを識別します。 |
| IsTemplateKeyTipTargetProperty |
Control.IsTemplateKeyTipTarget XAML 添付プロパティを識別します。 |
| IsTextScaleFactorEnabled |
システム テキスト サイズの設定を反映するために、自動テキスト拡大を有効にするかどうかを取得または設定します。 |
| IsTextScaleFactorEnabledProperty |
IsTextScaleFactorEnabled 依存関係プロパティを識別します。 |
| KeyboardAcceleratorPlacementMode |
コントロール ヒント に、関連付けられているキーボード アクセラレータのキーの組み合わせを表示するかどうかを示す値を取得または設定します。 (継承元 UIElement) |
| KeyboardAcceleratorPlacementTarget |
アクセラレータ キーの組み合わせを表示 するコントロールヒント を示す値を取得または設定します。 (継承元 UIElement) |
| KeyboardAccelerators |
キーボードを使用してアクションを呼び出すキーの組み合わせのコレクションを取得します。 アクセラレータは通常、ボタンまたはメニュー項目に割り当てられます。
|
| KeyTipHorizontalOffset |
UIElement に関連してキー ヒントを配置する距離を示す値を取得または設定します。 (継承元 UIElement) |
| KeyTipPlacementMode |
UIElement の境界に対してアクセス キーキーヒントが配置される場所を示す値を取得または設定します。 (継承元 UIElement) |
| KeyTipTarget |
アクセス キーキーヒントの対象となる要素を示す値を取得または設定します。 (継承元 UIElement) |
| KeyTipVerticalOffset |
UI 要素に対するキーヒントの配置距離を示す値を取得または設定します。 (継承元 UIElement) |
| Language |
FrameworkElement に適用されるローカライズ/グローバリゼーション言語情報と、オブジェクト表現および UI の現在の FrameworkElement のすべての子要素に適用される言語情報を取得または設定します。 (継承元 FrameworkElement) |
| 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) |
| Padding |
コントロール内のパディングを取得または設定します。 |
| PaddingProperty |
Padding 依存関係プロパティを識別します。 |
| Parent |
オブジェクト ツリー内のこの FrameworkElement の親オブジェクトを取得します。 (継承元 FrameworkElement) |
| PointerCaptures |
ポインター値として表される、キャプチャされたすべてのポインターのセット を 取得します。 (継承元 UIElement) |
| Projection |
この要素をレンダリングするときに適用するパースペクティブ プロジェクション (3-D 効果) を取得または設定します。 (継承元 UIElement) |
| ProtectedCursor |
ポインターがこの要素の上にあるときに表示されるカーソルを取得または設定します。 既定値は null で、カーソルへの変更がないことを示します。 (継承元 UIElement) |
| RasterizationScale |
図形、画像、テキスト、またはメディアをレンダリングするときに使用する追加のスケール ファクターを表す値を取得します。通常は通常よりも高い解像度でレンダリングします。 (継承元 UIElement) |
| RenderSize |
UIElement の最終的なレンダリング サイズを取得します。 使用は推奨されません。「解説」を参照してください。 (継承元 UIElement) |
| RenderTransform |
UIElement のレンダリング位置に影響する変換情報を取得または設定します。 (継承元 UIElement) |
| RenderTransformOrigin |
UIElement の境界を基準にして RenderTransform によって宣言された、可能なレンダー変換の原点を取得または設定します。 (継承元 UIElement) |
| RequestedTheme |
リソースの決定に UIElement (およびその子要素) によって使用される UI テーマを取得または設定します。
|
| RequiresPointer |
UI 要素がマウス モードをサポートするかどうかを取得または設定します。これは、キーボードやゲーム コントローラーなどのポインター以外の入力デバイスでポインター操作エクスペリエンスをエミュレートします。 |
| RequiresPointerProperty |
RequiresPointer 依存関係プロパティを識別します。 |
| Resources |
ローカルで定義されたリソース ディクショナリを取得します。 XAML では、XAML の暗黙的なコレクション構文を使用して、 |
| Rotation |
時計回りの回転角度を度単位で取得または設定します。 RotationAxis と CenterPoint を基準に回転します。 要素のレンダリング位置に影響します。 (継承元 UIElement) |
| RotationAxis |
要素を回転させる軸を取得または設定します。 (継承元 UIElement) |
| RotationTransition |
Rotation プロパティへの変更をアニメーション化する ScalarTransition を取得または設定します。 (継承元 UIElement) |
| Scale |
要素のスケールを取得または設定します。 要素の CenterPoint を基準にして拡大縮小します。 要素のレンダリング位置に影響します。 (継承元 UIElement) |
| ScaleTransition |
Scale プロパティへの変更をアニメーション化する Vector3Transition を取得または設定します。 (継承元 UIElement) |
| Shadow |
要素によってキャストされるシャドウ効果を取得または設定します。 (継承元 UIElement) |
| Style |
レイアウトおよびレンダリング中にこのオブジェクトに適用されるインスタンス Style を取得または設定します。 (継承元 FrameworkElement) |
| TabFocusNavigation |
このコントロールのタブと TabIndex の動作方法を変更する値を取得または設定します。 (継承元 UIElement) |
| TabIndex |
ユーザーが Tab キーを使用してコントロール内を移動するときに要素がフォーカスを受け取る順序を決定する値を取得または設定します。 (継承元 UIElement) |
| TabNavigation |
このコントロールのタブと UIElement.TabIndex の動作方法を変更する値を取得または設定します。 Note Windows 10 Creators Update (ビルド 10.0.15063) 以降の場合、 TabFocusNavigation プロパティは、UIElement 基底クラスで使用でき、ControlTemplate を使用しないオブジェクトをタブ シーケンスに含めることができます。 |
| TabNavigationProperty |
TabNavigation 依存関係プロパティを識別します。 |
| Tag |
このオブジェクトに関するカスタム情報を格納するために使用できる任意のオブジェクト値を取得または設定します。 (継承元 FrameworkElement) |
| Template |
コントロール テンプレートを取得または設定します。 コントロール テンプレートは、UI でコントロールの外観を定義し、XAML マークアップで定義します。 |
| TemplateProperty |
テンプレートの依存関係プロパティを識別します。 |
| 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 |
コントロールのコンテンツの垂直方向の配置を取得または設定します。 |
| VerticalContentAlignmentProperty |
VerticalContentAlignment 依存関係プロパティを識別します。 |
| 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) |
添付プロパティ
| 名前 | 説明 |
|---|---|
| IsTemplateFocusTarget |
この要素がフォーカス ビジュアルを持つコントロール テンプレートの一部であるかどうかを示す値を取得または設定します。 |
| IsTemplateKeyTipTarget |
この要素がキーヒントが配置されるコントロール テンプレートの一部であるかどうかを示す値を取得または設定します。 |
メソッド
イベント
| 名前 | 説明 |
|---|---|
| AccessKeyDisplayDismissed |
アクセス キーを表示しなくなったときに発生します。 (継承元 UIElement) |
| AccessKeyDisplayRequested |
ユーザーがアクセス キーの表示を要求したときに発生します。 (継承元 UIElement) |
| AccessKeyInvoked |
ユーザーがアクセス キー シーケンスを完了したときに発生します。 (継承元 UIElement) |
| ActualThemeChanged |
ActualTheme プロパティの値が変更されたときに発生します。 (継承元 FrameworkElement) |
| BringIntoViewRequested |
この要素またはその子孫の 1 つで StartBringIntoView が呼び出されたときに発生します。 (継承元 UIElement) |
| CharacterReceived |
1 つの構成済み文字が入力キューで受信されたときに発生します。 (継承元 UIElement) |
| ContextCanceled |
コンテキスト入力ジェスチャが操作ジェスチャに続き、コンテキスト ポップアップを開くべきではないことを要素に通知するときに発生します。 (継承元 UIElement) |
| ContextRequested |
ユーザーが右クリックなどのコンテキスト入力ジェスチャを完了したときに発生します。 (継承元 UIElement) |
| DataContextChanged |
FrameworkElement.DataContext プロパティの値が変更されたときに発生します。 (継承元 FrameworkElement) |
| DoubleTapped |
この要素のヒット テスト領域で、それ以外の場合にハンドルされない DoubleTap 操作が発生したときに発生します。 (継承元 UIElement) |
| DragEnter |
入力システムが、この要素をターゲットとして基になるドラッグ イベントを報告するときに発生します。 (継承元 UIElement) |
| DragLeave |
この要素を原点として基になるドラッグ イベントを入力システムが報告するときに発生します。 (継承元 UIElement) |
| DragOver |
この要素を潜在的なドロップ ターゲットとして使用して、基になるドラッグ イベントを入力システムが報告するときに発生します。 (継承元 UIElement) |
| DragStarting |
ドラッグ操作が開始されたときに発生します。 (継承元 UIElement) |
| Drop |
入力システムが、この要素をドロップ ターゲットとして持つ基になるドロップ イベントを報告するときに発生します。 (継承元 UIElement) |
| DropCompleted |
ソースが終了したときに、この要素を使用したドラッグ アンド ドロップ操作が発生します。 (継承元 UIElement) |
| EffectiveViewportChanged |
FrameworkElement の有効なビューポートが変更されたときに発生します。 (継承元 FrameworkElement) |
| FocusDisengaged |
ユーザーがゲーム コントローラーの B/Back ボタンを押すと、コントロールからフォーカスが離されたときに発生します。 |
| FocusEngaged |
ユーザーがゲーム コントローラーの A/Select ボタンを押すと、フォーカスがコントロールに制限されたときに発生します。 |
| GettingFocus |
UIElement がフォーカスを受け取る前に発生します。 このイベントは、イベントのバブル中にフォーカスが移動されないように同期的に発生します。 (継承元 UIElement) |
| GotFocus |
UIElement がフォーカスを受け取ったときに発生します。 このイベントは非同期的に発生するため、バブルが完了する前にフォーカスを再び移動できます。 (継承元 UIElement) |
| Holding |
この要素のヒット テスト領域で、それ以外のハンドルされない Hold 操作が発生したときに発生します。 (継承元 UIElement) |
| IsEnabledChanged |
IsEnabled プロパティが変更されたときに発生します。 |
| 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) |
| 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) |