XCode 26.5 日本語化計画
元のドキュメント: developer.apple.com/documentation/watchkit/wkinterfaceobject
あなたの watchOS アプリ内のすべてのインターフェイスオブジェクトに共通する情報を提供するオブジェクト。
class WKInterfaceObject
WatchKit 拡張機能では、Apple Watch に表示される視覚的要素を操作するためにインターフェイスオブジェクトを使用します。具体的には、このクラスのメソッドを使用して、それらの要素のサイズ、配置、および表示状態を変更します。また、VoiceOver などの支援技術を通じて表示されるアクセシビリティ情報を構成することも可能です。
このクラスやそのサブクラスを自分でサブクラス化したり、インスタンス化したりしないでください。代わりに、インターフェイスコントローラクラスでアウトレットを定義し、それらをストーリーボードファイル内の対応するオブジェクトに接続します。例えば、インターフェイス内のボタンを参照するには、インターフェイスコントローラクラスで以下のような構文を使用してプロパティを定義します。
| Swift | Objective-C |
実行時には、WatchKit は適切なインターフェイスオブジェクトを生成し、それらをあなたのインターフェイスコントローラのアウトレットに割り当てます。
WatchKit は、拡張機能(エクステンション)内のインターフェイスオブジェクトと、watchOS アプリ内の対応するインターフェイス要素との間で、一方向の通信を提供します。インターフェイスオブジェクトの値を設定することはできますが、現在の値を取得することはできません。属性の現在の値を知る必要がある場合は、その値を自分で保存しておかなければなりません。
Xcode では、ストーリーボードファイル内のグループのインターフェイスオブジェクトに関する情報を構成できます。以下の表は、ストーリーボードで構成可能な属性とその意味をまとめたものです。
| 属性 | 説明 |
| Alpha (アルファ) | オブジェクトの不透明度。値が 1.0 の場合は完全に不透明で、0.0 の場合は完全に透明であることを表します。 |
| Hidden (非表示) | 項目が初期状態で非表示かどうかを示すチェックボックスです。setHidden(_:) メソッドを呼び出すことでプログラムから項目の表示状態を切り替えることができます。 |
| Installed (インストール済) | 現在のデバイスにその項目がインストールされているかどうかを示すチェックボックス。 |
| Horizontal (水平) | 項目の水平方向の配置です。この属性を使用して、直近の親要素に対する項目の水平位置を構成します。 |
| Vertical (垂直) | 項目の垂直方向の配置です。この属性を使用して、直近の親要素に対する項目の垂直位置を構成します。 |
| Width (幅) | オブジェクトの幅。固定幅を指定するか、そのコンテナの幅に対するパーセンテージとして値を設定します。 |
| Height (高さ) | オブジェクトの高さ。固定の高さを指定するか、そのコンテナの高さに対するパーセンテージとして値を設定します。 |
あなたのユーザーインターフェイス内のインターフェイスオブジェクトを非表示または表示します。
インターフェースオブジェクトの不透明度を設定します。