Button クラス
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
タッチ イベントに反応するボタン View。
public ref class Button : Microsoft::Maui::Controls::View, Microsoft::Maui::Controls::IBorderElement, Microsoft::Maui::Controls::IButtonController, Microsoft::Maui::Controls::IElementConfiguration<Microsoft::Maui::Controls::Button ^>, Microsoft::Maui::Controls::IImageController, Microsoft::Maui::Controls::IImageElement, Microsoft::Maui::Controls::Internals::IFontElement, Microsoft::Maui::Controls::IPaddingElement, Microsoft::Maui::IImageButton, Microsoft::Maui::ITextButtonpublic class Button : Microsoft.Maui.Controls.View, Microsoft.Maui.Controls.IBorderElement, Microsoft.Maui.Controls.IButtonController, Microsoft.Maui.Controls.IElementConfiguration<Microsoft.Maui.Controls.Button>, Microsoft.Maui.Controls.IImageController, Microsoft.Maui.Controls.IImageElement, Microsoft.Maui.Controls.Internals.IFontElement, Microsoft.Maui.Controls.IPaddingElement, Microsoft.Maui.IImageButton, Microsoft.Maui.ITextButtontype Button = class
inherit View
interface IFontElement
interface IBorderElement
interface IButtonController
interface IViewController
interface IVisualElementController
interface IElementController
interface IElementConfiguration<Button>
interface IPaddingElement
interface IImageController
interface IImageElement
interface IButton
interface IView
interface IElement
interface ITransform
interface IPadding
interface IButtonStroke
interface ITextButton
interface IText
interface ITextStyle
interface IImageButton
interface IImage
interface IImageSourcePartPublic Class Button
Inherits View
Implements IBorderElement, IButtonController, IElementConfiguration(Of Button), IFontElement, IImageButton, IImageController, IImageElement, IPaddingElement, ITextButton- 継承
- 実装
-
IBorderElement IButtonController IElementConfiguration<Button> IElementController IImageController IImageElement IFontElement IPaddingElement IViewController IVisualElementController IButton IButtonStroke IElement IImage IImageButton IImageSourcePart IPadding IText ITextButton ITextStyle ITransform IView
注釈
ボタンの外観
Button クラスは、すべてのViewオブジェクトに共通する外観プロパティに加えて、、BorderWidth、および プロパティをBorderColorImageSource提供します。
次の XAML コード スニペットは、これらのプロパティを使用して、"Press me!" というテキストを含む基本的なボタンを作成する方法を示しています。 ボタンが表示される画像は、左から右の言語の左側であるレイアウトの開始側に表示されます。
<Button Text="Press me!"
Image="icon.png"
BackgroundColor="White"
BorderWidth="2"
BorderColor="Black"
HorizontalOptions="Center"/>
上記の XAML でイメージを icon.png 表示するには、開発者は、各プラットフォーム プロジェクトに固有の適切なビルド アクションを使用して、適切な場所に配置する必要があります。 Images トピックでは、Microsoft.Maui.Controls での画像の操作に関するこれと他の重要な詳細について説明します。
ボタン イベント
ボタンは、それぞれ、および イベントを含むイベントをPressedReleasedClicked押し、離し、クリックすると開発者に通知します。
次の XAML では、次の 2 つのボタン イベントにハンドラーが割り当てられます。
<Button x:Name="PressMeButton"
Text="Press Me!"
Pressed="PressMeButton_Pressed"
Clicked="PressMeButton_Clicked"/>
上記の XAML では、分離コード ファイル内の次のイベント ハンドラーによって、これらのイベントが発生したときにボタンのテキストが変更されます。
private void PressMeButton_Pressed(object sender, EventArgs e)
{
(sender as Button).Text = "You pressed me!";
}
private void PressMeButton_Clicked(object sender, EventArgs e)
{
(sender as Button).Text = "I was just clicked!";
}
コマンド
ボタン用のコマンド API を使用すると、開発者は Clicked イベントに応答してコマンドを実行できます。
次の XAML は、ボタンがクリックされたときに実行するコマンドを指定します。 コマンドは、 という名前 modelUpdateCountのビュー モデル プロパティを更新します。このプロパティは、ボタンを使用してそのテキストを更新するために使用します。 (テキスト バインドは完全のために表示されます。コマンド コードのみが関連しています。):
<Button Text="{Binding modelUpdateCount, StringFormat='Number of updates to the model: {0:D}'}"
Command="{Binding IncrementLabelCommand}" />
上記の XAML では、開発者は最初にビュー モデルで プロパティを定義 IncrementLabelCommand し、後で コマンドをインスタンス化する メソッドを実装します。
public ICommand IncrementLabelCommand { get; private set; }
void IncrementLabel()
{
modelUpdateCount++;
}
次に、開発者は メソッド (またはアクション) を使用してコマンドを初期化します。
public ViewModelDemo()
{
IncrementLabelCommand = new Command(IncrementLabel);
}
最後に、開発者は、メイン ページのコンストラクターのバインド コンテキストを、 プロパティが実装されているビュー モデルのバインディング コンテキストに設定する必要があります。
public MainPage()
{
InitializeComponent();
BindingContext = new ViewModelDemo();
}
コンストラクター
| Button() |
Button クラスの新しいインスタンスを初期化します。 |
フィールド
プロパティ
| AnchorX |
要素の境界を基準にして、変換操作の中心点の X コンポーネントを取得または設定します。 これはバインド可能なプロパティです。 (継承元 VisualElement) |
| AnchorY |
要素の境界を基準にして、変換操作の中心点の Y コンポーネントを取得または設定します。 これはバインド可能なプロパティです。 (継承元 VisualElement) |
| AutomationId |
自動化フレームワークがこの要素を見つけ、対話することを可能にする値を取得または設定します。 (継承元 Element) |
| Background |
要素の背景を Brush 塗りつぶすために使用される を取得または設定します。 これはバインド可能なプロパティです。 (継承元 VisualElement) |
| BackgroundColor |
要素の背景を Color 塗りつぶす を取得または設定します。 これはバインド可能なプロパティです。 (継承元 VisualElement) |
| Batched |
この要素に対してバッチ処理された変更が行われることを示す値を取得します。 (継承元 VisualElement) |
| Behaviors |
この要素に関連付けられているオブジェクトの Behavior 一覧を取得します。 これはバインド可能な読み取り専用プロパティです。 (継承元 VisualElement) |
| BindingContext |
この BindableObjectに属するバインドされたプロパティの対象となるプロパティを含むオブジェクトを取得または設定します。 これはバインド可能なプロパティです。 (継承元 BindableObject) |
| BorderColor |
ボタンの境界線のストローク色を表す色を取得または設定します。 これはバインド可能なプロパティです。 |
| BorderWidth |
境界線の幅をデバイスに依存しない単位で取得または設定します。 これはバインド可能なプロパティです。 |
| Bounds |
デバイスに依存しない単位で要素の境界を取得します。 (継承元 VisualElement) |
| CharacterSpacing |
ボタンに表示される の各文字間の Text 間隔を取得または設定します。 これはバインド可能なプロパティです。 |
| class |
タッチ イベントに反応するボタン View。 (継承元 NavigableElement) |
| ClassId |
意味的に同類の要素の集合を識別するために使用される値を取得または設定します。 (継承元 Element) |
| Clip |
要素のクリッピング領域を指定します。 これはバインド可能なプロパティです。 (継承元 VisualElement) |
| Command |
このボタンがアクティブになったときに呼び出すコマンドを取得または設定します。 これはバインド可能なプロパティです。 |
| CommandParameter |
Command プロパティに渡すパラメーターを取得または設定します。
既定値は |
| ContentLayout |
ボタン画像の位置と、ボタン画像とボタンテキストの間隔を制御するオブジェクトを取得または設定します。 これはバインド可能なプロパティです。 |
| CornerRadius |
デバイス非依存ユニットでボタンの角の半径を取得または設定します。 これはバインド可能なプロパティです。 |
| DesiredSize |
レイアウト処理の測定パスの実行中に、この要素が計算したサイズを取得します。 (継承元 VisualElement) |
| DisableLayout |
この要素のレイアウトが無効になっていることを示す値を取得します。 (継承元 VisualElement) |
| Dispatcher |
このバインド可能なオブジェクトが作成されたときに使用可能だったディスパッチャーを取得します。それ以外の場合は、使用可能な最も近いディスパッチャー (おそらくウィンドウ/アプリ) を検索しようとします。 (継承元 BindableObject) |
| EffectControlProvider |
.NET MAUI による内部使用用。 (継承元 Element) |
| Effects |
実行時に要素に適用されるスタイルとプロパティを取得または設定します。 (継承元 Element) |
| FlowDirection |
レイアウトのフロー方向を取得または設定します。 これはバインド可能なプロパティです。 (継承元 VisualElement) |
| FontAttributes |
このボタンのテキストのフォントが太字、斜体、またはどちらでもないかどうかを示す値を取得または設定します。 これはバインド可能なプロパティです。 |
| FontAutoScalingEnabled |
オペレーティング システムの設定に従って、このエントリのフォントを自動的にスケーリングするかどうかを決定します。 既定値は |
| FontFamily |
このエントリのテキストのフォント ファミリを取得または設定します。 これはバインド可能なプロパティです。 |
| FontSize |
このエントリのテキストのフォントのサイズを取得または設定します。 これはバインド可能なプロパティです。 |
| Frame |
この要素が画面上に存在するフレームを取得または設定します。 (継承元 VisualElement) |
| GestureController |
タッチ イベントに反応するボタン View。 (継承元 View) |
| GestureRecognizers |
このビューに関連付けられているジェスチャ レコグナイザーのコレクション。 (継承元 View) |
| Handler |
この要素に関連付けられている を IViewHandler 取得または設定します。 (継承元 VisualElement) |
| Height |
この要素の描画時の現在の高さを取得します。 これはバインド可能な読み取り専用プロパティです。 (継承元 VisualElement) |
| HeightRequest |
この要素の必要な高さオーバーライドを取得または設定します。 これはバインド可能なプロパティです。 (継承元 VisualElement) |
| HorizontalOptions |
要素が LayoutOptions レイアウト サイクルでどのようにレイアウトされるかを定義する を取得または設定します。 これはバインド可能なプロパティです。 (継承元 View) |
| Id |
アプリケーションの実行全体で要素を一意に識別するために使用できる値を取得します。 (継承元 Element) |
| ImageSource |
ボタンのビットマップ画像を表示します。 これはバインド可能なプロパティです。 |
| InputTransparent |
ユーザー操作中にこの要素がヒット テストに応答するかどうかを示す値を取得または設定します。 これはバインド可能なプロパティです。 (継承元 VisualElement) |
| IsEnabled |
この要素をユーザー インターフェイスで有効にするかどうかを示す値を取得または設定します。 これはバインド可能なプロパティです。 (継承元 VisualElement) |
| IsEnabledCore |
タッチ イベントに反応するボタン View。 |
| IsEnabledCore |
この値は、累積 IsEnabled 値を表します。 このプロパティをオーバーライドするすべての型は、値が変更される場合に RefreshIsEnabledProperty() メソッドも呼び出す必要があります。 (継承元 VisualElement) |
| IsFocused |
この要素に現在フォーカスがあるかどうかを示す値を取得します。 これはバインド可能なプロパティです。 (継承元 VisualElement) |
| IsInPlatformLayout |
この要素が現在プラットフォーム レイアウト サイクルを通過していることを示す値を取得または設定します。 (継承元 VisualElement) |
| IsLoaded |
要素がメイン オブジェクト ツリーに接続されているかどうかを示します。 (継承元 VisualElement) |
| IsPlatformEnabled |
この要素のプラットフォームに相当する要素が有効かどうかを示す値を取得または設定します。 (継承元 VisualElement) |
| IsPlatformStateConsistent |
この要素がプラットフォームの同等の要素の状態と現在一致していることを示す値を取得または設定します。 (継承元 VisualElement) |
| IsPressed |
ボタンが現在押されているかどうかを取得します。 |
| IsVisible |
この要素を画面上に表示し、レイアウト内の領域を占有するかどうかを決定する値を取得または設定します。 これはバインド可能なプロパティです。 (継承元 VisualElement) |
| LineBreakMode |
長さがこのボタンのサイズをオーバーフローしている場合の表示方法 Text を決定します。 これはバインド可能なプロパティです。 |
| LogicalChildren |
古い.
Microsoft.Maui.Controls プラットフォームによる内部使用。 (継承元 Element) |
| Margin |
ビューの余白を取得または設定します。 (継承元 View) |
| MaximumHeightRequest |
レイアウト中に要素が要求する最大高さを取得または設定します。 これはバインド可能なプロパティです。 (継承元 VisualElement) |
| MaximumWidthRequest |
レイアウト中に要素が要求する最大幅を取得または設定します。 これはバインド可能なプロパティです。 (継承元 VisualElement) |
| MinimumHeightRequest |
レイアウト中に要素が要求する最小高さを取得または設定します。 これはバインド可能なプロパティです。 (継承元 VisualElement) |
| MinimumWidthRequest |
レイアウト中に要素が要求する最小幅を取得または設定します。 これはバインド可能なプロパティです。 (継承元 VisualElement) |
| Navigation |
タッチ イベントに反応するボタン View。 (継承元 NavigableElement) |
| NavigationProxy |
タッチ イベントに反応するボタン View。 (継承元 NavigableElement) |
| Opacity |
描画時に要素に適用する不透明度値を取得または設定します。 この値の範囲は 0 ~ 1 です。この範囲外の値は、最も近い有効な値に設定されます。 これはバインド可能なプロパティです。 (継承元 VisualElement) |
| Padding |
ボタンの埋め込みを取得または設定します。 これはバインド可能なプロパティです。 |
| Parent |
この要素の親 Element を取得または設定します。 (継承元 Element) |
| RealParent |
.NET MAUI による内部使用用。 (継承元 Element) |
| Resources |
ローカルのリソース ディクショナリを取得または設定します。 (継承元 VisualElement) |
| Rotation |
要素の描画時に、Z 軸を中心とする回転 (アフィン回転) (度単位) を取得または設定します。 これはバインド可能なプロパティです。 (継承元 VisualElement) |
| RotationX |
要素の描画時に、X 軸を中心とする回転 (パースペクティブ回転) (度単位) を取得または設定します。 これはバインド可能なプロパティです。 (継承元 VisualElement) |
| RotationY |
要素の描画時に、Y 軸を中心とする回転 (パースペクティブ回転) (度単位) を取得または設定します。 これはバインド可能なプロパティです。 (継承元 VisualElement) |
| Scale |
要素に適用するスケール ファクターを取得または設定します。 これはバインド可能なプロパティです。 (継承元 VisualElement) |
| ScaleX |
X 方向に適用するスケールの値を取得または設定します。 これはバインド可能なプロパティです。 (継承元 VisualElement) |
| ScaleY |
Y 方向に適用するスケールの値を取得または設定します。 これはバインド可能なプロパティです。 (継承元 VisualElement) |
| Shadow |
要素によってキャストされる影の効果を取得または設定します。 これはバインド可能なプロパティです。 (継承元 VisualElement) |
| Style |
タッチ イベントに反応するボタン View。 (継承元 NavigableElement) |
| StyleClass |
タッチ イベントに反応するボタン View。 (継承元 NavigableElement) |
| StyleId |
要素を一意に識別するユーザー定義の値を取得または設定します。 (継承元 Element) |
| Text |
ボタンの内容として表示されるテキストを取得または設定します。
既定値は |
| TextColor |
ボタンのテキストの Color を取得または設定します。 これはバインド可能なプロパティです。 |
| TextTransform |
このボタンに表示される に Text テキスト変換を適用します。 これはバインド可能なプロパティです。 |
| TranslationX |
要素の X 変換差分を取得または設定します。 これはバインド可能なプロパティです。 (継承元 VisualElement) |
| TranslationY |
要素の Y 変換差分を取得または設定します。 これはバインド可能なプロパティです。 (継承元 VisualElement) |
| Triggers |
この要素に関連付けられているオブジェクトの TriggerBase 一覧を取得します。 これはバインド可能な読み取り専用プロパティです。 (継承元 VisualElement) |
| VerticalOptions |
要素が LayoutOptions レイアウト サイクルでどのようにレイアウトされるかを定義する を取得または設定します。 これはバインド可能なプロパティです。 (継承元 View) |
| Visual |
要素の外観を IVisual オーバーライドする実装を取得または設定します。 これはバインド可能なプロパティです。 (継承元 VisualElement) |
| Width |
この要素の現在の幅を取得します。 これはバインド可能な読み取り専用プロパティです。 (継承元 VisualElement) |
| WidthRequest |
この要素の必要な幅オーバーライドを取得または設定します。 これはバインド可能なプロパティです。 (継承元 VisualElement) |
| Window |
要素に Window 関連付けられている を取得します。 これはバインド可能な読み取り専用プロパティです。 (継承元 VisualElement) |
| X |
この要素の現在の X 位置を取得します。 これはバインド可能な読み取り専用プロパティです。 (継承元 VisualElement) |
| Y |
この要素の現在の Y 位置を取得します。 これはバインド可能な読み取り専用プロパティです。 (継承元 VisualElement) |
| ZIndex |
レイアウト内の要素の前後の z インデックスを取得または設定します。 これはバインド可能なプロパティです。 (継承元 VisualElement) |
メソッド
イベント
| BatchCommitted |
プロパティ変更のバッチが を呼び出 BatchCommit()してコミットされたときに発生します。 (継承元 VisualElement) |
| BindingContextChanged |
BindingContext プロパティの値が変化したときに発生します。 (継承元 BindableObject) |
| ChildAdded |
子要素が 要素に追加されるたびに発生します。 (継承元 Element) |
| ChildRemoved |
子要素が 要素から削除されるたびに発生します。 (継承元 Element) |
| ChildrenReordered |
この要素の子の順序が変更されたときに発生します。 (継承元 VisualElement) |
| Clicked |
ボタンがクリックまたはタップされたときに発生します。 |
| DescendantAdded |
子要素が要素のサブツリーに追加されるたびに発生します。 (継承元 Element) |
| DescendantRemoved |
子要素が要素サブツリーから削除されるたびに発生します。 (継承元 Element) |
| FocusChangeRequested |
古い.
タッチ イベントに反応するボタン View。 (継承元 VisualElement) |
| Focused |
この要素にフォーカスがある場合に発生します。 (継承元 VisualElement) |
| HandlerChanged |
要素のハンドラーが変更されるたびに発生します。 (継承元 Element) |
| HandlerChanging |
要素のハンドラーが変更を開始するたびに発生します。 (継承元 Element) |
| Loaded |
要素が構築され、オブジェクト ツリーに追加されたときに発生します。 (継承元 VisualElement) |
| MeasureInvalidated |
要素の現在のメジャーが無効になったときに発生します。 (継承元 VisualElement) |
| ParentChanged |
要素の親が変更されるたびに発生します。 (継承元 Element) |
| ParentChanging |
要素の変更が開始されるたびに発生します。 (継承元 Element) |
| Pressed |
ボタンが押されたときに発生します。 |
| PropertyChanged |
プロパティ値が変更するときに発生します。 (継承元 BindableObject) |
| PropertyChanging |
プロパティ値が変更されようとしている場合に発生します。 (継承元 BindableObject) |
| Released |
ボタンが離されたときに発生します。 |
| SizeChanged |
要素のサイズが変更されたときに発生します。 (継承元 VisualElement) |
| Unfocused |
この要素がフォーカスされていない場合に発生します。 (継承元 VisualElement) |
| Unloaded |
要素がメイン オブジェクト ツリーに接続されなくなったときに発生します。 (継承元 VisualElement) |
明示的なインターフェイスの実装
拡張メソッド
適用対象
.NET MAUI
フィードバック
以下は間もなく提供いたします。2024 年を通じて、コンテンツのフィードバック メカニズムとして GitHub の issue を段階的に廃止し、新しいフィードバック システムに置き換えます。 詳細については、「https://aka.ms/ContentUserFeedback」を参照してください。
フィードバックの送信と表示