XCode 26.6 日本語化計画
元のドキュメント: developer.apple.com/documentation/watchkit/wkinterfacebutton
あなたの watchOS アプリのユーザーインターフェイスにあるボタン。
class WKInterfaceButton
ボタンのタップ可能な領域の内容には、テキストと、オプションで背景色または画像が表示されます。ユーザーがボタンをタップすると、そのボタンに関連したアクションメソッドが呼び出されます。このメソッドは、ボタンを所有するインターフェイスコントローラ内で定義します。このアクションメソッドを使用して、タスクの開始やアプリのインターフェイスの更新を行います。
このクラスを自分でサブクラス化したり、インスタンス化したりしないでください。代わりに、インターフェイスコントローラのクラスでアウトレットを定義し、それらをストーリーボードファイル内の対応するオブジェクトに接続します。例えば、インターフェイス内のボタンオブジェクトを参照するには、インターフェイスコントローラのクラスで以下のような構文を使用してプロパティを定義します。
| Swift | Objective-C |
@IBOutlet weak var myButton: WKInterfaceButton!
@property (weak, nonatomic) IBOutlet WKInterfaceButton* myButton;
あなたのインターフェイスコントローラの初期化中、WatchKit はこのクラスの新しいインスタンスを作成し、それをあなたのアウトレットに割り当てます。その時点で、アウトレット内のオブジェクトを使用して、画面上のボタンを変更することができます。
ボタンへのタップに応答するには、そのボタンを管理するインターフェイスコントローラクラス内で、以下のような形式のメソッドを宣言します。
| Swift | Objective-C |
@IBAction func buttonAction()
- (IBAction)buttonAction
アクションメソッドの名前は、好きなものに変更できます。Xcode のストーリーボードで、ボタンのセレクタをあなたのクラス内で定義したカスタムアクションメソッドに接続してください。
Xcode では、あなたのストーリーボードファイル上でボタンのインターフェイスオブジェクトに関する情報を構成できます。以下の表は、あなたのストーリーボードで構成可能な属性とその意味をまとめたものです。
| 属性 | 説明 |
| Content (内容) | ボタンに含まれるコンテンツの型です。ボタンには、単一のテキストラベル、またはグループを含めることができます。グループを含むボタンの場合、そのグループにテキスト、画像、その他のオブジェクトを追加できます。 |
| Title (タイトル) | インターフェイスコントローラに割り当てられるタイトル文字列です。この値は、setTitle(_:) または setAttributedTitle(_:) メソッドを使用してプログラムから設定することも可能です。 |
| Color (Button) | ボタンのタイトルに適用すべき色。 |
| Font (フォント) | ボタンのタイトルに適用するフォント。setAttributedTitle(_:) メソッドを使用して、プログラムからフォント情報を設定できます。 |
| Enabled (有効化) | ボタンが有効であり、タップ時にイベントを送信するかどうかを示すチェックボックスです。この値は、setEnabled(_:) メソッドを使用してプログラムから構成することもできます。 |
| Background (背景) | ボタンに表示すべき背景画像です。setBackgroundImage(_:)、setBackgroundImageData(_:)、または setBackgroundImageNamed(_:) メソッドを使用して、プログラムからこの値を設定することもできます。 |
| Color (Background) | ボタンの背景色。 |
ボタンのタイトルを指定された文字列に設定します。
func setAttributedTitle(NSAttributedString?)
ボタンのタイトルを指定された属性付き文字列に設定します。
func setBackgroundColor(UIColor?)
ボタンの背景色を設定します。
func setBackgroundImage(UIImage?)
ボタンの背景画像を、指定した画像に設定します。
func setBackgroundImageData(Data?)
ボタンの背景画像を、指定されたデータオブジェクト内の画像に設定します。
func setBackgroundImageNamed(String?)
ボタンの背景画像を、名前の付いたリソースファイル内の画像に設定します。
ボタンを有効または無効にします。
NSObjectProtocol
静的なテキストを表示するインターフェース要素。
現在の日付または時刻を表示するラベル。
カウントダウンまたはカウントアップタイマーを表示するラベル。
class WKInterfaceAuthorizationAppleIDButton
Apple でサインインのリクエストをトリガーするために使用できるボタン。
class WKInterfacePaymentButton
Apple Pay による支払いを行うために使用できるボタン。
class WKInterfaceTextField
編集可能なテキスト領域を表示するインターフェース要素。
class WKInterfaceSwitch
オンとオフの状態を切り替えるインターフェース要素。
class WKInterfaceSlider
ユーザーが値の範囲から単一の浮動小数点数を選択できるようにするインターフェース要素。
class WKInterfaceActivityRing
HealthKit のアクティビティサマリーオブジェクトのデータを表示するビュー。
class WKInterfaceMap
あなたが指定した場所の、操作不可能な地図を表示するインターフェイス要素。