Control クラス
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
ControlTemplate を使用して外観を定義する UI 要素の基本クラスを表します。 ContentControl、UserControl、ItemsControl、およびいくつかの実用的なコントロールの親クラス。
public ref class Control : FrameworkElement/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 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(Windows.Foundation.UniversalApiContract), 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- 継承
- 派生
- 属性
Windows の要件
| デバイス ファミリ |
Windows 10 (10.0.10240.0 で導入)
|
| API contract |
Windows.Foundation.UniversalApiContract (v1.0 で導入)
|
注釈
Control クラスは、アプリとその UI に追加する多くのコントロールの基本クラスです。 Control クラスは動作をほとんど定義しません。UI 用の XAML に実際の Control 要素を追加できますが、通常は Control から直接または間接的に継承するもの ( Button や ListBox など) を追加します。 使用できるコントロールの一覧については、「 関数別のコントロール」を参照してください。
型 ControlTemplate を使用する Template プロパティは、コントロールの外観を指定します。 コントロールの外観を変更しても機能を保持する場合は、新しい Control ベースのクラスを定義する代わりに、新しい ControlTemplate を作成することを検討する必要があります。 詳細については、「 コントロール テンプレート」を参照してください。
Control は UserControl の親です。 UserControl は、視覚的な状態を必要としない軽量コントロールの目的の基底クラスです。 UserControl は技術的には Template プロパティを継承しますが、UserControl にテンプレートを適用することはできません。
コントロールの暗黙的なスタイル
XAML 用に定義されている実用的な各コントロールには、既定のコントロール テンプレートを含む既定のスタイルがあります。 コントロールには暗黙的なスタイルを指定できます。つまり、 FrameworkElement.Style プロパティが明示的に設定されていません。 暗黙的なスタイルを使用できるようになったら、その Style の Setter 要素を使用して、コントロールの他のほぼすべてのプロパティを設定できます。 Style は、コントロールロジックの残りの部分とは別にコントロールを初期化でき、各プロパティのコードベースの既定値ではない値を設定できます。
暗黙的なスタイルは、XAML のバイナリ表現として内部的に格納される、Windows ランタイムの一部であるキー付きリソースとして存在します。 特定のコントロールのスタイルまたはスタイルの完全なセットのコピーを取得して、スタイルとコントロール テンプレートの定義方法を見ることができます。
特定のコントロール型と、既定で使用する暗黙的なスタイルのキー/名前との関連付けは、 DefaultStyleKey プロパティの値によって確立されます。 DefaultStyleKey プロパティは保護されているため、コントロール クラスをサブクラス化するユーザーのみが値を変更できます。 XAML UI でコントロールを宣言するなど、コントロール インスタンスを作成するだけの場合、既定のスタイルはコントロールの型に基づく暗黙的なスタイルです。 詳細については、「 DefaultStyleKey の解説」を参照してください。 別のスタイルを使用するように DefaultStyleKey 値を変更する必要はありません。暗黙的なスタイル参照に一致し 、XAML リソース として存在する TargetType と同じ独自の XAML スタイルを定義するだけで済みます。 詳細については、「 コントロール テンプレート」を参照してください。
ビジュアル状態モデル
ビジュアル状態モデルは、コントロールのテンプレートで定義されているいくつかのプロパティのみを変更する手法です。 コントロールの動作を示す視覚的フィードバックをユーザーに提供し、可能な UI 操作をさらにヒントにするために、プロパティ値を変更します。 コントロールは、テンプレート内の一部のプロパティに 0 期間または短い期間のストーリーボードアニメーションを適用することで変更されます。 状態間の遷移に適用される短い期間のアニメーションを定義することもできます。
ビジュアル状態自体は、コントロール テンプレートの一部として定義されます。 各ビジュアル状態には名前が付いているため、コントロール ロジックは、特定のロジック状態に必要なときに各ビジュアル状態を読み込む GoToState メソッドを呼び出すことができます。 ビジュアル状態はビジュアル状態グループ内で宣言されるため、相互に排他的なビジュアル状態では、一度に 1 つの状態のみがアクティブになります。 同じグループの別のビジュアル状態が読み込まれるとすぐに、前の状態のアニメーションは適用されなくなりますが、別のグループ内のアニメーションは引き続き実行され、変更と視覚的な動作が適用されている可能性があります。 たとえば、コントロールにはキーボード フォーカス用のビジュアル インジケーターとポインターオーバー用のビジュアル インジケーターが含まれます。 これらは互いに独立して調整できる UI モードであり、同時に発生する可能性があるため、それぞれ異なるビジュアル状態グループで定義されています。
コントロール テンプレートの一部として XAML で定義されているため、UI で使用するすべての XAML コントロールのビジュアル状態の動作を変更できます。 ただし、ロジックは、特定のビジュアル状態グループと名前付きビジュアル状態を検索することを期待するコントロールに基づいています。 そのため、コントロールの動作のすべての側面をユーザーに表示する正しい名前付きの構造化されたビジュアル状態を提供するように注意する必要があります。 詳しくは、「表示状態用にストーリーボードに設定されたアニメーション」をご覧ください。 ビジュアルの状態は、 コントロール テンプレートでも簡単に紹介されています。
コントロールの既定の表示状態では、ライブラリ アニメーションが使用される場合があります。 これらのアニメーションは UI でのコントロールの外観の重要な部分であるため、コントロール テンプレートまたはビジュアルの状態を置き換える場合は、ライブラリ アニメーションを保持する必要があります。 詳しくは、「アニメーションの概要」をご覧ください。
コントロールとフォーカス
Control クラスは、UI のキーボード フォーカス動作に影響を与えるいくつかの API を定義します。 Focus メソッド、 FocusState プロパティ、 IsEnabled プロパティと IsTabStop プロパティです。 キーボード フォーカスを有効にすることは、UI がアクセス可能であることを保証する重要な部分です。これは、フォーカス可能な各要素が UI のタブ オーダーの一部になるためです。 通常、キーボード フォーカスを受け取るために有効になっているのは、対話型の UI 要素のみです。 たとえば、 TextBox はユーザーがテキストを入力できるため対話型ですが、テキストは読み取り専用であるため TextBlock は対話型ではありません。 Control から派生するほとんどのクラスは正当に対話型であるため、フォーカスを設定でき、タブ オーダーにする必要があります。
フォーカスを設定できるようにするには、これらのそれぞれが true である必要があります。
- 可視性 が 表示される
- IsEnabled は true です
- IsTabStop は true です
- コントロールは、テンプレートを読み込んでインスタンス化する必要があります (読み込まれた 、アプリのルート ビジュアルに接続されているコントロール)。 コントロールにフォーカスを設定しないようにする場合は、 IsTabStop を false に設定できます。 ただし、コントロールにフォーカスを設定しない理由が UI で対話型ではない場合は、 IsEnabled を false に設定して、操作の欠如をすべてのユーザーに明らかにすることをお勧めします。 多くのコントロールには、 IsEnabled =false に対して呼び出される定義済みのビジュアル状態があります 。たとえば、ラベル内の "淡色表示" テキストなどです。
フォーカスの変更は 、GotFocus または LostFocus イベントを発生させることができます。 "FocusedElement" 値 ( GetFocusedElement メソッドを介して公開) は直ちに更新されますが、 GotFocus または LostFocus の変更通知は非同期的に行われます。 この非同期フォーカス設計は、コントロール ロジックがフォーカスの変更に反応しすぎるときに、ビジュアル状態の遷移がちらつくのを回避することを目的としています。
Focus メソッドを使用すると、キーボード フォーカスをプログラムでコントロールに移動できます。 このメソッドを呼び出すときは慎重に行う必要があります。ユーザーが予期していないときにキーボードフォーカスを移動するのは邪魔になる可能性があります。 フォーカスのメインシナリオでは、UI のページ全体が読み込まれるときに最初のキーボード フォーカス ポイントを設定するか、親コントロール コンテナーがトップレベルのフォーカスを受け取った後にコントロールの特定の部分にフォーカスを設定します (コンボボックス内のテキスト ボックスにフォーカスを設定するなど)。 詳細については、「 フォーカス」を参照してください。 FocusState は、フォーカスがプログラムとユーザー駆動のどちらであるかを追跡します。これにより、視覚状態に違いがあります。特に、すべてのコントロールに必要なキーボード フォーカスのビジュアル フォーカス インジケーターです。
イベント イベント ハンドラーのオーバーライド時
各 OnEvent メソッドは、対応する UIElement イベントの事前に接続されたイベント ハンドラーを表します。 Control から派生した実用的なコントロールは 、OnEvent メソッドをオーバーライドし、これを使用して、その入力イベントのコントロール固有の処理と動作を提供できます。 最も一般的なシナリオは、イベント ハンドラーを使用して、イベント データでイベントを Handled としてマークすることです。 コントロール コードは、コントロール インスタンスでワイヤードされたイベント ハンドラーが呼び出される前に、このイベントを処理する最初の機会があります。 イベント データが Handled とマークされている場合、コントロール インスタンス上のハンドラーなどの他のハンドラーは呼び出されません。 また、イベントはバブルしません。
コントロールに直接実装されているため、 Onイベント メソッドには空の実装があります。 ただし、コントロールの階層内の各先祖は、実装を提供している可能性があります。 この実装は内部ネイティブ コードであるため、表示できません。 場合によっては、コントロールには、イベントの処理をマークする OnEvent オーバーライドが既に存在します。 コントロールに対して最初の OnEvent オーバーライドを指定すると、独自のコントロール クラスからさらに派生したコントロールも、定義した OnEvent オーバーライドを継承します。 使用するインスタンスにも、その動作があります。
注意
アプリ コードでは、コントロールの OnEvent メソッド ロジックによって Handled とマークされている可能性があるイベントを処理できますが、UIElement.AddHandler メソッドには handledEventsToo パラメーターを使用する必要があります。 詳細については、「 UIElement.AddHandler 」または 「イベントとルーティング イベントの概要」を参照してください。
Control クラスは、それぞれフレームワーク レベルの入力イベントに関連付けられているいくつかの保護された仮想メソッドを定義します。 これらのメソッドは、コントロールがそのコントロールとそのすべてのインスタンスで特定の入力動作を使用するように、入力イベントの事前ワイヤード イベント ハンドラーを提供することを目的としています。 たとえば、UIElement によって定義された PointerPressed イベントがあります。 コントロールは、空の定義を使用して OnPointerPressed メソッドを定義します。 基本 の Control コンストラクター内では、関連するすべての入力イベントのイベント配線に、リスナー/ハンドラーとしての OnEvent メソッドが含まれます。これは、最初は何も行いません。 ただし、入力イベントの動作を変更するためにコントロール作成者として必要なのは、 OnEvent メソッドの新しいオーバーライド定義を指定することです (また、コンストラクターが base を呼び出していることを確認してください)。 その動作は、別のサブクラスが再度オーバーライドしない限り、すべてのインスタンスまたはサブクラスに継承されます。 OnEvent イベントは最初に順番に行われるため、UI 定義 XAML の前にイベント データを調整し、イベントに関して他のリスナーに表示される条件を変更する可能性があります。
特定のコントロール クラスの既存の Onイベント 定義は、 OnEvent メソッドを自分でオーバーライドしていない場合でも、コントロールのコンシューマーとして影響を受ける可能性があります。 これは、既存の Onイベント 定義が、イベントのイベント データで Handled プロパティ値を true に設定するイベントの処理を提供している可能性があるためです。 これにより、インスタンスベースのイベント処理でイベントが表示されるのを防ぎ、ハンドラーが呼び出されるのを防ぎます。 ここで起こっているのは、コントロールロジックと競合する低レベルのイベントであるか、コントロールに置換ロジックがあるために、特定のイベントがコントロールに関係しないことを強制する意図的なコントロール設計があることです。 この顕著な例として、 ButtonBase クラスがあります。 ButtonBase クラスには、OnPointerPressed と OnKeyDown のネイティブ オーバーライドによって適用される 2 つの動作があります。 これは、低レベルのさまざまな入力モードを組み合わせ、代わりにコントロール固有の Click イベントとしてレポートするためです。 PointerPressed イベント ハンドラーの場合、Button インスタンスでこれを処理しようとした場合、ハンドラーは呼び出されません。 これは、ネイティブ の OnPointerPressedによって Handled が true に設定され、 PointerPressed がインスタンスとアプリ コードに伝達できなかったためです。 OnKeyDown の場合、ロジックは特定のキー (Ctrl キーと Enter キー) を探していたため、これらのキーも探していない限り、インスタンス ハンドラーは引き続き呼び出すことができます。
注意
実際には、入力イベントの一部に対して OnEvent メソッドのネイティブ処理を回避する方法があります。 これを行うには、 AddHandler メソッドと handledEventsToo を使用してハンドラーをワイヤ化する必要があります。 詳細については、「 AddHandler または イベントとルーティング イベントの概要」を参照してください。
テキスト要素パーツに継承するテキスト プロパティ
コントロールは、テキストの表示に関連するいくつかのプロパティを定義します。 これらのボタンの役割は、次のとおりです。
明らかに、すべてのコントロールが内部のテキストを表示することを意図しているわけではありません。 たとえば、AppBarSeparatorに FontFamily を設定することは有効ですが、まったく効果はありません。 Control が基底クラス レベルでこれらのプロパティを定義する理由は、コントロール テンプレートで {TemplateBinding} マークアップ拡張を 使用して、テンプレート内に存在する 1 つ以上のテキスト要素パーツに最上位レベルのテキスト プロパティを適用しやすくするためです。 たとえば、 DatePicker のコントロール テンプレートを見ると、ルートがコンテナーであり、そのコンテナー内のより深い部分が、実際にテキスト入力を受け取る 複数の ComboBox パーツであることがわかります。 これらの各では、 などのFontWeight="{TemplateBinding FontWeight}"ステートメントを使用して、DatePicker で設定された最上位の FontWeight を内のさまざまな部分で使用します。
Control のテキスト プロパティは、テキストを表示する ContentPresenter を持つコントロールに対しても暗黙的に継承されます。 たとえば、Button に FontSize を設定した場合、テンプレートに明示的な {TemplateBinding} マークアップ拡張や、最上位の FontSize 値を使用してテンプレートの動作を制御する ContentPresenter パーツはありません。 ただし、 Control.FontSize 値は、テンプレートの定義内のコンテキストに基づいて ContentPresenter.FontSize によって暗黙的に継承されるため、 Button 内のテキストは、設定した Control.FontSize を使用して表示されます。
XAML 添付プロパティ
Control は、 いくつかの XAML 添付プロパティのホスト サービス クラスです。
アタッチされたプロパティへの XAML プロセッサ アクセスをサポートし、同等の get 操作と set 操作をコードに公開するために、各 XAML 添付プロパティには Get メソッドと Set アクセサー メソッドのペアがあります。 コードで値を取得または設定するもう 1 つの方法は、依存関係プロパティ システムを使用して GetValue または SetValue を呼び出し、識別子フィールドを依存関係プロパティ識別子として渡すことです。
| 添付プロパティ | 説明 |
|---|---|
| IsTemplateFocusTarget | この要素がフォーカス ビジュアルを持つコントロール テンプレートの一部であるかどうかを示す値を取得または設定します。 |
| IsTemplateKeyTipTarget | この要素が が配置されているコントロール テンプレート KeyTip の一部であるかどうかを示す値を取得または設定します。 |
バージョン履歴
| Windows のバージョン | SDK バージョン | 追加された値 |
|---|---|---|
| 1607 | 14393 | ElementSoundMode |
| 1607 | 14393 | FocusDisengaged |
| 1607 | 14393 | FocusEngaged |
| 1607 | 14393 | IsFocusEngaged |
| 1607 | 14393 | IsFocusEngagementEnabled |
| 1607 | 14393 | RemoveFocusEngagement |
| 1607 | 14393 | RequiresPointer |
| 1607 | 14393 | XYFocusDown |
| 1607 | 14393 | XYFocusLeft |
| 1607 | 14393 | XYFocusRight |
| 1607 | 14393 | XYFocusUp |
| 1703 | 15063 | DefaultStyleResourceUri |
| 1703 | 15063 | GetIsTemplateKeyTipTarget |
| 1703 | 15063 | SetIsTemplateKeyTipTarget |
| 1709 | 16299 | OnCharacterReceived |
| 1709 | 16299 | OnPreviewKeyDown |
| 1709 | 16299 | OnPreviewKeyUp |
| 1809 | 17763 | BackgroundSizing |
| 1809 | 17763 | CornerRadius |
コンストラクター
| Control() |
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 (Uniform Resource Identifier) を表す Uniform Resource Identifier (URI) を取得します。 このプロパティは、実行時の URI (Uniform Resource Identifier) 解決に役立ちます。 (継承元 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 のデータ コンテキストを取得または設定します。 データ コンテキストの一般的な用途は、 FrameworkElement が {Binding} マークアップ拡張機能を使用し、データ バインディングに参加する場合です。 (継承元 FrameworkElement) |
| DefaultStyleKey |
コントロールの既定のスタイルを参照するキーを取得または設定します。 カスタム コントロールの作成者は、このプロパティを使用して、コントロールが使用するスタイルの既定値を変更します。 |
| DefaultStyleKeyProperty |
DefaultStyleKey 依存関係プロパティを識別します。 |
| DefaultStyleResourceUri |
コントロールの既定のスタイルを含むリソース ファイルへのパスを取得または設定します。 |
| DefaultStyleResourceUriProperty |
DefaultStyleResourceUri 依存関係プロパティを識別します。 |
| DesiredSize |
レイアウト プロセスのメジャー パス中にこの UIElement が計算したサイズを取得します。 (継承元 UIElement) |
| Dispatcher |
このオブジェクトが関連付けられている CoreDispatcher を取得します。 CoreDispatcher は、コードが UI 以外のスレッドによって開始された場合でも、UI スレッド上の DependencyObject にアクセスできる機能を表します。 (継承元 DependencyObject) |
| ElementSoundMode |
サウンドを再生するかどうかのコントロールの設定を指定する値を取得または設定します。 |
| ElementSoundModeProperty |
ElementSoundMode 依存関係プロパティを識別します。 |
| ExitDisplayModeOnAccessKeyInvoked |
アクセス キーが呼び出されたときにアクセス キーの表示を閉じるかどうかを指定する値を取得または設定します。 (継承元 UIElement) |
| FlowDirection |
レイアウトを制御する任意の親要素内でテキストやその他の UI 要素が流れる方向を取得または設定します。 このプロパティは、 LeftToRight または RightToLeft のいずれかに設定できます。 任意の要素で FlowDirection を RightToLeft に設定すると、配置が右に設定され、読み取り順序が右から左に設定され、コントロールのレイアウトが右から左にフローします。 (継承元 FrameworkElement) |
| FocusState |
このコントロールにフォーカスがあるかどうかを示す値と、フォーカスが取得されたモードを取得します。 |
| FocusStateProperty |
FocusState 依存関係プロパティを識別します。 |
| 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 |
コントロール境界内でフォーカスが制限されているかどうかを示す値を取得または設定します (ゲーム パッド/リモート操作の場合)。 |
| IsFocusEngagedProperty |
IsFocusEngaged 依存関係プロパティを識別します。 |
| IsFocusEngagementEnabled |
コントロール境界内でフォーカスを制限できるかどうかを示す値を取得または設定します (ゲーム パッド/リモート操作の場合)。 |
| IsFocusEngagementEnabledProperty |
IsFocusEngagementEnabled 依存関係プロパティを識別します。 |
| IsHitTestVisible |
この UIElement の包含領域がヒット テストの true 値を返すことができるかどうかを取得または設定します。 (継承元 UIElement) |
| IsHoldingEnabled |
Holding イベントがその要素から発生するかどうかを決定する値を取得または設定します。 (継承元 UIElement) |
| IsLoaded |
要素が要素ツリーに追加され、操作の準備ができているかどうかを示す値を取得します。 (継承元 FrameworkElement) |
| IsRightTapEnabled |
RightTapped イベントがその要素から発生するかどうかを決定する値を取得または設定します。 (継承元 UIElement) |
| IsTabStop |
コントロールがタブ ナビゲーションに含まれるかどうかを示す値を取得または設定します。 |
| IsTabStopProperty |
IsTabStop 依存関係プロパティを識別します。 |
| 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 |
Pointer 値として表されるすべてのキャプチャされたポインターのセット を取得します 。 (継承元 UIElement) |
| Projection |
この要素をレンダリングするときに適用するパースペクティブ プロジェクション (3-D 効果) を取得または設定します。 (継承元 UIElement) |
| RenderSize |
UIElement の最終的なレンダリング サイズを取得します。 使用は推奨されません。「解説」を参照してください。 (継承元 UIElement) |
| RenderTransform |
UIElement のレンダリング位置に影響する変換情報を取得または設定します。 (継承元 UIElement) |
| RenderTransformOrigin |
UIElement の境界を基準にして、RenderTransform によって宣言された可能なレンダー変換の原点を取得または設定します。 (継承元 UIElement) |
| RequestedTheme |
リソースを決定するために UIElement (およびその子要素) によって使用される UI テーマを取得または設定します。 RequestedTheme で指定した UI テーマは、アプリ レベルの RequestedTheme をオーバーライドできます。 (継承元 FrameworkElement) |
| 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 キーを使用してアプリ UI を移動したときに要素がフォーカスを受け取る順序を示す値を取得または設定します。 |
| TabIndexProperty |
TabIndex 依存関係プロパティを識別します。 |
| TabNavigation |
このコントロールのタブと TabIndex の動作方法を変更する値を取得または設定します。 注意 Windows 10 Creators Update (ビルド 10.0.15063) 以降では、UiElement 基本クラスで TabFocusNavigation プロパティを使用して、ControlTemplate を使用しないオブジェクトをタブ シーケンスに含めることができます。 |
| TabNavigationProperty |
TabNavigation 依存関係プロパティを識別します。 |
| Tag |
このオブジェクトに関するカスタム情報を格納するために使用できる任意のオブジェクト値を取得または設定します。 (継承元 FrameworkElement) |
| Template |
コントロール テンプレートを取得または設定します。 コントロール テンプレートは、UI でのコントロールの視覚的な外観を定義し、XAML マークアップで定義されています。 |
| TemplateProperty |
Template 依存関係プロパティを識別します。 |
| Transform3D |
この要素をレンダリングするときに適用する 3-D 変換効果を取得または設定します。 (継承元 UIElement) |
| TransformMatrix |
要素に適用する変換マトリックスを取得または設定します。 (継承元 UIElement) |
| Transitions |
UIElement に適用される Transition スタイル要素のコレクションを取得または設定します。 (継承元 UIElement) |
| Translation |
要素の x、y、z のレンダリング位置を取得または設定します。 (継承元 UIElement) |
| TranslationTransition |
Translation プロパティの変更をアニメーション化する Vector3Transition を取得または設定します。 (継承元 UIElement) |
| Triggers |
FrameworkElement に対して定義されているアニメーションのトリガーのコレクションを取得します。 一般的に使用されません。 「解説」を参照してください。 (継承元 FrameworkElement) |
| UIContext |
要素のコンテキスト識別子を取得します。 (継承元 UIElement) |
| UseLayoutRounding |
オブジェクトとそのビジュアル サブツリーのレンダリングで、レンダリングをピクセル全体に合わせた丸め動作を使用するかどうかを決定する値を取得または設定します。 (継承元 UIElement) |
| UseSystemFocusVisuals |
システムによって描画されるフォーカス ビジュアルをコントロールで使用するか、コントロール テンプレートで定義されたビジュアルを使用するかを示す値を取得または設定します。 |
| UseSystemFocusVisualsProperty |
UseSystemFocusVisuals 依存関係プロパティを識別します。 |
| VerticalAlignment |
パネルや項目コントロールなどの親オブジェクトで構成されている場合に FrameworkElement に適用される垂直方向の配置特性を取得または設定します。 (継承元 FrameworkElement) |
| VerticalContentAlignment |
コントロールのコンテンツの垂直方向の配置を取得または設定します。 |
| VerticalContentAlignmentProperty |
VerticalContentAlignment 依存関係プロパティを識別します。 |
| Visibility |
UIElement の可視性を取得または設定します。 表示されない UIElement はレンダリングされず、目的のサイズをレイアウトに伝達しません。 (継承元 UIElement) |
| Width |
FrameworkElement の幅を取得または設定します。 (継承元 FrameworkElement) |
| XamlRoot |
この要素が表示される を |
| XYFocusDown |
ユーザーが方向パッド (D パッド) を押したときにフォーカスを取得するオブジェクトを取得または設定します。 |
| XYFocusDownNavigationStrategy |
ダウン ナビゲーションのターゲット要素を決定するために使用する戦略を指定する値を取得または設定します。 (継承元 UIElement) |
| XYFocusDownProperty |
XYFocusDown 依存関係プロパティを識別します。 |
| XYFocusKeyboardNavigation |
キーボード方向矢印を使用してナビゲーションを有効または無効にする値を取得または設定します。 (継承元 UIElement) |
| XYFocusLeft |
ユーザーが方向パッド (D パッド) を左に押したときにフォーカスを取得するオブジェクトを取得または設定します。 |
| XYFocusLeftNavigationStrategy |
左側のナビゲーションのターゲット要素を決定するために使用される戦略を指定する値を取得または設定します。 (継承元 UIElement) |
| XYFocusLeftProperty |
XYFocusLeft 依存関係プロパティを識別します。 |
| XYFocusRight |
ユーザーが方向パッド (D パッド) を右に押したときにフォーカスを取得するオブジェクトを取得または設定します。 |
| XYFocusRightNavigationStrategy |
右ナビゲーションのターゲット要素を決定するために使用される戦略を指定する値を取得または設定します。 (継承元 UIElement) |
| XYFocusRightProperty |
XYFocusRight 依存関係プロパティを識別します。 |
| XYFocusUp |
ユーザーが方向パッド (D パッド) を上に押したときにフォーカスを取得するオブジェクトを取得または設定します。 |
| XYFocusUpNavigationStrategy |
アップ ナビゲーションのターゲット要素を決定するために使用する戦略を指定する値を取得または設定します。 (継承元 UIElement) |
| XYFocusUpProperty |
XYFocusUp 依存関係プロパティを識別します。 |
添付プロパティ
| IsTemplateFocusTarget |
この要素がフォーカス ビジュアルを持つコントロール テンプレートの一部であるかどうかを示す値を取得または設定します。 |
| IsTemplateKeyTipTarget |
この要素が KeyTip が配置されるコントロール テンプレートの一部であるかどうかを示す値を取得または設定します。 |
メソッド
イベント
| AccessKeyDisplayDismissed |
アクセス キーが表示されなくなったときに発生します。 (継承元 UIElement) |
| AccessKeyDisplayRequested |
ユーザーがアクセス キーの表示を要求したときに発生します。 (継承元 UIElement) |
| AccessKeyInvoked |
ユーザーがアクセス キー シーケンスを完了したときに発生します。 (継承元 UIElement) |
| ActualThemeChanged |
ActualTheme プロパティの値が変更されたときに発生します。 (継承元 FrameworkElement) |
| BringIntoViewRequested |
この要素またはその子孫のいずれかで 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 |
コントロール境界からフォーカスが離されたときに発生します (ゲーム パッド/リモート操作の場合)。 |
| FocusEngaged |
コントロールの境界内でフォーカスが制限されている場合に発生します (ゲーム パッド/リモート操作の場合)。 |
| GettingFocus |
UIElement がフォーカスを受け取る前に発生します。 このイベントは、イベントがバブルしている間にフォーカスが移動されないように同期的に発生します。 (継承元 UIElement) |
| GotFocus |
UIElement がフォーカスを受け取ったときに発生します。 このイベントは非同期的に発生するため、バブルが完了する前にフォーカスを再び移動できます。 (継承元 UIElement) |
| Holding |
この要素のヒット テスト領域で、それ以外の場合はハンドルされない 保留 操作が発生したときに発生します。 (継承元 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 アクションの終了が PointerReleased イベントを発生させる保証はされないことに注意してください。他のイベントが発生する可能性があります。 詳細については、「解説」を参照してください。 (継承元 UIElement) |
| PointerWheelChanged |
ポインター ホイールのデルタ値が変更されたときに発生します。 (継承元 UIElement) |
| PreviewKeyDown |
UIElement にフォーカスがあるときにキーボード キーが押されたときに発生します。 (継承元 UIElement) |
| PreviewKeyUp |
UIElement にフォーカスがあるときにキーボード キーが解放されたときに発生します。 (継承元 UIElement) |
| ProcessKeyboardAccelerators |
キーボード ショートカット (またはアクセラレータ) が押されたときに発生します。 (継承元 UIElement) |
| RightTapped |
ポインターが 要素の上にある間に右タップ入力刺激が発生したときに発生します。 (継承元 UIElement) |
| SizeChanged |
ActualHeight または ActualWidth プロパティが FrameworkElement の値を変更したときに発生します。 (継承元 FrameworkElement) |
| Tapped |
この要素のヒット テスト領域で、それ以外の場合はハンドルされない Tap 操作が発生したときに発生します。 (継承元 UIElement) |
| Unloaded |
このオブジェクトがメイン オブジェクト ツリーに接続されなくなったときに発生します。 (継承元 FrameworkElement) |
適用対象
こちらもご覧ください
フィードバック
以下は間もなく提供いたします。2024 年を通じて、コンテンツのフィードバック メカニズムとして GitHub の issue を段階的に廃止し、新しいフィードバック システムに置き換えます。 詳細については、「https://aka.ms/ContentUserFeedback」を参照してください。
フィードバックの送信と表示