NumberBox クラス

定義

名前空間:

Microsoft.UI.Xaml.Controls

数値の表示と編集に使用できるコントロールを表します。

このドキュメントは、UWP 用 WinUI 2 に適用されます (Windows アプリ SDKの WinUI の場合は、Windows アプリ SDK名前空間を参照してください)。

/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
/// [Windows.Foundation.Metadata.ContractVersion(Microsoft.UI.Xaml.XamlContract, 65536)]
class NumberBox : Control

[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
[Windows.Foundation.Metadata.ContractVersion(typeof(Microsoft.UI.Xaml.XamlContract), 65536)]
public class NumberBox : Control

Public Class NumberBox
Inherits Control

継承

Control

NumberBox

属性

MarshalingBehaviorAttribute ThreadingAttribute ContractVersionAttribute

例

ヒント

詳細、設計ガイダンス、およびコード例については、「 数値ボックス」を参照してください。

WinUI 2 ギャラリー アプリを開き、NumberBox の動作を確認します。

WinUI 2 ギャラリー アプリには、ほとんどの WinUI 2 コントロールと機能の対話型の例が含まれています。 Microsoft Store からアプリを入手するか、GitHub でソース コードを取得します。

注釈

このコントロールでは、乗算、除算、加算、減算などの基本数式の検証、インクリメント ステップ実行、およびインライン計算がサポートされています。

コントロールのスタイルとテンプレート

既定の スタイル と ControlTemplate を変更して、コントロールに一意の外観を与えることができます。 コントロールのスタイルとテンプレートの変更については、「 XAML スタイル」を参照してください。 コントロールの外観を定義する既定のスタイル、テンプレート、およびリソースがファイルに generic.xaml 含まれます。 設計上の目的で、 generic.xaml は WinUI (Microsoft.UI.Xaml) NuGet パッケージと共にインストールされます。 既定では、この場所は \Users\<username>\.nuget\packages\microsoft.ui.xaml\<version>\lib\uap10.0\Microsoft.UI.Xaml\Themes\generic.xaml です。 WinUI の異なるバージョンのスタイルとリソースの値が異なる場合があります。

XAML には、コントロール テンプレートを変更せずに、さまざまなビジュアル状態のコントロールの色を変更するために使用できるリソースも含まれています。 これらのリソースを変更することは、 Background や Foreground などのプロパティを設定する場合に適 しています。 詳細については、XAML スタイルに関する記事の「軽量スタイル設定」セクションを参照してください。

コンストラクター

NumberBox()

NumberBox クラスの新しいインスタンスを初期化します。 このドキュメントは、UWP 用 WinUI 2 に適用されます (Windows アプリ SDKの WinUI の場合は、Windows アプリ SDK名前空間を参照してください)。

プロパティ

AcceptsExpression	入力として入力された基本的な数式をコントロールが受け入れて評価するかどうかを切り替えます。 このドキュメントは、UWP 用 WinUI 2 に適用されます (Windows アプリ SDKの WinUI の場合は、Windows アプリ SDK名前空間を参照してください)。
AcceptsExpressionProperty	AcceptsExpression 依存関係プロパティを識別します。 このドキュメントは、UWP 用 WinUI 2 に適用されます (Windows アプリ SDKの WinUI の場合は、Windows アプリ SDK名前空間を参照してください)。
Description	コントロールの下に表示されるコンテンツを取得または設定します。 コンテンツは、コントロールによって期待される入力に関するガイダンスを提供する必要があります。 このドキュメントは、UWP 用 WinUI 2 に適用されます (Windows アプリ SDKの WinUI の場合は、Windows アプリ SDK名前空間を参照してください)。
DescriptionProperty	Description 依存関係プロパティを識別します。 このドキュメントは、UWP 用 WinUI 2 に適用されます (Windows アプリ SDKの WinUI の場合は、Windows アプリ SDK名前空間を参照してください)。
Header	コントロールのヘッダーの内容を取得または設定します。 このドキュメントは、UWP 用 WinUI 2 に適用されます (Windows アプリ SDKの WinUI の場合は、Windows アプリ SDK名前空間を参照してください)。
HeaderProperty	Header 依存関係プロパティを識別します。 このドキュメントは、UWP 用 WinUI 2 に適用されます (Windows アプリ SDKの WinUI の場合は、Windows アプリ SDK名前空間を参照してください)。
HeaderTemplate	コントロールのヘッダーの内容を表示するために使用する DataTemplate を取得または設定します。 このドキュメントは、UWP 用 WinUI 2 に適用されます (Windows アプリ SDKの WinUI の場合は、Windows アプリ SDK名前空間を参照してください)。
HeaderTemplateProperty	HeaderTemplate 依存関係プロパティを識別します。 このドキュメントは、UWP 用 WinUI 2 に適用されます (Windows アプリ SDKの WinUI の場合は、Windows アプリ SDK名前空間を参照してください)。
IsWrapEnabled	テキストの行がコントロールの使用可能な幅を超える場合に改行を行うかどうかを切り替えます。 このドキュメントは、UWP 用 WinUI 2 に適用されます (Windows アプリ SDKの WinUI の場合は、Windows アプリ SDK名前空間を参照してください)。
IsWrapEnabledProperty	IsWrapEnabled 依存関係プロパティを識別します。 このドキュメントは、UWP 用 WinUI 2 に適用されます (Windows アプリ SDKの WinUI の場合は、Windows アプリ SDK名前空間を参照してください)。
LargeChange	PageUP キーや PageDown キーなど、大きな変更が加えられたときに Value に加算または減算される値を取得または設定します。 このドキュメントは、UWP 用 WinUI 2 に適用されます (Windows アプリ SDKの WinUI の場合は、Windows アプリ SDK名前空間を参照してください)。
LargeChangeProperty	LargeChange 依存関係プロパティを識別します。 このドキュメントは、UWP 用 WinUI 2 に適用されます (Windows アプリ SDKの WinUI の場合は、Windows アプリ SDK名前空間を参照してください)。
Maximum	Value の最大値を取得または設定 します。 このドキュメントは、UWP 用 WinUI 2 に適用されます (Windows アプリ SDKの WinUI の場合は、Windows アプリ SDK名前空間を参照してください)。
MaximumProperty	最大依存関係プロパティを識別します。 このドキュメントは、UWP 用 WinUI 2 に適用されます (Windows アプリ SDKの WinUI の場合は、Windows アプリ SDK名前空間を参照してください)。
Minimum	Value の最小値を取得または設定 します。 このドキュメントは、UWP 用 WinUI 2 に適用されます (Windows アプリ SDKの WinUI の場合は、Windows アプリ SDK名前空間を参照してください)。
MinimumProperty	最小依存関係プロパティを識別します。 このドキュメントは、UWP 用 WinUI 2 に適用されます (Windows アプリ SDKの WinUI の場合は、Windows アプリ SDK名前空間を参照してください)。
NumberFormatter	Value の書式を指定するために使用するオブジェクトを取得または設定 します。 このドキュメントは、UWP 用 WinUI 2 に適用されます (Windows アプリ SDKの WinUI の場合は、Windows アプリ SDK名前空間を参照してください)。
NumberFormatterProperty	NumberFormatter 依存関係プロパティを識別します。 このドキュメントは、UWP 用 WinUI 2 に適用されます (Windows アプリ SDKの WinUI の場合は、Windows アプリ SDK名前空間を参照してください)。
PlaceholderText	ユーザー アクションまたはその他の操作によって値が変更されるまでコントロールに表示されるテキストを取得または設定します。 このドキュメントは、UWP 用 WinUI 2 に適用されます (Windows アプリ SDKの WinUI の場合は、Windows アプリ SDK名前空間を参照してください)。
PlaceholderTextProperty	PlaceholderText 依存関係プロパティを識別します。 このドキュメントは、UWP 用 WinUI 2 に適用されます (Windows アプリ SDKの WinUI の場合は、Windows アプリ SDK名前空間を参照してください)。
PreventKeyboardDisplayOnProgrammaticFocus	コントロールがプログラムでフォーカスを受け取ったときにスクリーン キーボードを表示するかどうかを示す値を取得または設定します。 このドキュメントは、UWP 用 WinUI 2 に適用されます (Windows アプリ SDKの WinUI の場合は、Windows アプリ SDK名前空間を参照してください)。
PreventKeyboardDisplayOnProgrammaticFocusProperty	PreventKeyboardDisplayOnProgrammaticFocus 依存関係プロパティを識別します。 このドキュメントは、UWP 用 WinUI 2 に適用されます (Windows アプリ SDKの WinUI の場合は、Windows アプリ SDK名前空間を参照してください)。
SelectionFlyout	テキストを選択したときに表示されるポップアップを取得または設定します。ポップアップが表示されない場合は null を設定します 。 このドキュメントは、UWP 用 WinUI 2 に適用されます (Windows アプリ SDKの WinUI の場合は、Windows アプリ SDK名前空間を参照してください)。
SelectionFlyoutProperty	SelectionFlyout 依存関係プロパティを識別します。 このドキュメントは、UWP 用 WinUI 2 に適用されます (Windows アプリ SDKの WinUI の場合は、Windows アプリ SDK名前空間を参照してください)。
SelectionHighlightColor	選択したテキストを強調表示するために使用するブラシを取得または設定します。 このドキュメントは、UWP 用 WinUI 2 に適用されます (Windows アプリ SDKの WinUI の場合は、Windows アプリ SDK名前空間を参照してください)。
SelectionHighlightColorProperty	SelectionHighlightColor 依存関係プロパティを識別します。 このドキュメントは、UWP 用 WinUI 2 に適用されます (Windows アプリ SDKの WinUI の場合は、Windows アプリ SDK名前空間を参照してください)。
SmallChange	矢印キーやスクロールなど、小さな変更が行われたときに Value に加算または減算される値を取得または設定します。 このドキュメントは、UWP 用 WinUI 2 に適用されます (Windows アプリ SDKの WinUI の場合は、Windows アプリ SDK名前空間を参照してください)。
SmallChangeProperty	SmallChange 依存関係プロパティを識別します。 このドキュメントは、UWP 用 WinUI 2 に適用されます (Windows アプリ SDKの WinUI の場合は、Windows アプリ SDK名前空間を参照してください)。
SpinButtonPlacementMode	Value プロパティをインクリメントまたはデクリメントするために使用するボタンの配置を示す値を取得または設定します。 このドキュメントは、UWP 用 WinUI 2 に適用されます (Windows アプリ SDKの WinUI の場合は、Windows アプリ SDK名前空間を参照してください)。
SpinButtonPlacementModeProperty	SpinButtonPlacementMode 依存関係プロパティを識別します。 このドキュメントは、UWP 用 WinUI 2 に適用されます (Windows アプリ SDKの WinUI の場合は、Windows アプリ SDK名前空間を参照してください)。
Text	Value プロパティの文字列型表現を取得または設定します。 このドキュメントは、UWP 用 WinUI 2 に適用されます (Windows アプリ SDKの WinUI の場合は、Windows アプリ SDK名前空間を参照してください)。
TextProperty	Text 依存関係プロパティを識別します。 このドキュメントは、UWP 用 WinUI 2 に適用されます (Windows アプリ SDKの WinUI の場合は、Windows アプリ SDK名前空間を参照してください)。
TextReadingOrder	NumberBox の読み取り順序の決定方法を示す値を取得または設定します。 このドキュメントは、UWP 用 WinUI 2 に適用されます (Windows アプリ SDKの WinUI の場合は、Windows アプリ SDK名前空間を参照してください)。
TextReadingOrderProperty	TextReadingOrder 依存関係プロパティを識別します。 このドキュメントは、UWP 用 WinUI 2 に適用されます (Windows アプリ SDKの WinUI の場合は、Windows アプリ SDK名前空間を参照してください)。
ValidationMode	無効な入力が入力されたときに呼び出す入力検証動作を取得または設定します。 このドキュメントは、UWP 用 WinUI 2 に適用されます (Windows アプリ SDKの WinUI の場合は、Windows アプリ SDK名前空間を参照してください)。
ValidationModeProperty	ValidationMode 依存関係プロパティを識別します。 このドキュメントは、UWP 用 WinUI 2 に適用されます (Windows アプリ SDKの WinUI の場合は、Windows アプリ SDK名前空間を参照してください)。
Value	NumberBox の数値を取得または設定します。 このドキュメントは、UWP 用 WinUI 2 に適用されます (Windows アプリ SDKの WinUI の場合は、Windows アプリ SDK名前空間を参照してください)。
ValueProperty	Value 依存関係プロパティを識別します。 このドキュメントは、UWP 用 WinUI 2 に適用されます (Windows アプリ SDKの WinUI の場合は、Windows アプリ SDK名前空間を参照してください)。

イベント

ValueChanged

Enter キーを押すか、スピン ボタンをクリックするか、フォーカスを変更して、ユーザーが新しい入力の評価をトリガーした後に発生します。 このドキュメントは、UWP 用 WinUI 2 に適用されます (Windows アプリ SDKの WinUI の場合は、Windows アプリ SDK名前空間を参照してください)。

こちらもご覧ください

• NumberBoxSpinButtonPlacementMode
• NumberBoxValidationMode
• NumberBoxValueChangedEventArgs