Instance Method インスタンスメソッド

loadNibNamed(_:owner:options:)

Unarchives the contents of a nib file located in the receiver's bundle. レシーバの持つバンドルの中にロードされるnibファイルの内容をアンアーカイブします。

Declaration 宣言

func loadNibNamed(_ name: String, 
            owner: Any?, 
          options: [UINib.OptionsKey : Any]? = nil) -> [Any]?

Parameters パラメータ

name

The name of the nib file, which need not include the .nib extension. nibファイルの名前、それは.nib拡張子を含む必要はありません。

owner

The object to assign as the nib’s File's Owner object. nibのもつFile's Ownerオブジェクトとしてアサインすることになるオブジェクト。

options オプション

A dictionary containing the options to use when opening the nib file. For a list of available keys for this dictionary, see UIKit Nib Loading Options. nibファイルを開く時に使うオプションを含んでいる辞書。この辞書のために利用可能なキーのリストとして、UIKit Nib Loading Optionsを見てください。

Return Value 戻り値

An array containing the top-level objects in the nib file. The array does not contain references to the File’s Owner or any proxy objects; it contains only those objects that were instantiated when the nib file was unarchived. You should retain either the returned array or the objects it contains manually to prevent the nib file objects from being released prematurely. nibファイルの中のトップレベルオブジェクトを含んでいる配列。配列は、File’s Ownerまたは何らかのプロキシオブジェクトへの参照を含みません;それは、nibファイルがアンアーカイブされた時にインスタンス化されたオブジェクトそれらのみを含みます。あなたは、返される配列またはそれが手動で含むいくらかのオブジェクトのどちらもリテイン(保持)して、nibファイルオブジェクトが早まってリリースされるのを予防すべきです。

Discussion 議論

You can use this method to load user interfaces and make the objects available to your code. During the loading process, this method unarchives each object, initializes it, sets its properties to their configured values, and reestablishes any connections to other objects. (To establish outlet connections, this method uses the setValue:forKey: method, which may cause the object in the outlet to be retained automatically.) For detailed information about the nib-loading process, see Resource Programming Guide. あなたはこのメソッドを使って、ユーザインターフェイスをロードして、オブジェクトをあなたのコードで利用可能にできます。ロード処理の間、このメソッドはめいめいのオブジェクトをアンアーカイブして、それを初期化して、それのいくらかのプロパティをそれらの構成設定の値に設定して、そして他のオブジェクトへのあらゆる接続を再確立します。(アウトレット接続を確立するために、このメソッドはsetValue:forKey:メソッドを使います、それはアウトレットの中のオブジェクトが自動的にリテインされることを引き起こすかもしれません。)nibロード処理についての詳細情報として、Resource Programming Guideを見てください。

If the nib file contains any proxy objects beyond just the File’s Owner proxy object, you can specify the runtime replacement objects for those proxies using the options dictionary. In that dictionary, add the UINibExternalObjects key and set its value to a dictionary containing the names of any proxy objects (the keys) and the real objects to use in their place. The proxy object’s name is the string you assign to it in the Identifier field of the Interface Builder inspector window. nibファイルがFile’s Ownerプロキシオブジェクトだけでなく何らかのプロキシオブジェクトを含むならば、あなたは実行時置換オブジェクトをそういったプロキシに対してオプション辞書を使って指定できます。その辞書において、UINibExternalObjectsキーを追加して、それの値を、あらゆるプロキシオブジェクトの名前(キー)とそれらの場所で使う実際のオブジェクトを含んでいるある辞書に設定しください。プロキシオブジェクトの持つ名前は、Interface BuilderのインスペクタウインドウのIdentifier欄であなたが割り当てるその文字列です。

See Also 参照

Loading Nib Files nibファイルをロードする