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

image(forResource:)

Returns an NSImage instance associated with the specified name, which can be backed by multiple files representing different resolution versions of the image. 指定された名前と関連付けられるNSImageインスタンスを返します、それはその画像の異なる解像度バージョンを表している複数のファイルによって裏で支えられることができます。

Declaration 宣言 

func image(forResource name: NSImage.Name) -> NSImage?

Parameters パラメータ

name

The filename of the image resource file. Including a filename extension is optional. 画像リソースファイルのファイル名。ファイル名拡張子を含めることは任意です。

Return Value 戻り値

The NSImage object associated with the specified name, or nil if no file is found. 指定された名前と結びつけられたNSImageオブジェクト、またはファイルが見つからないならばnil。

Discussion 議論

This method accommodates Apple’s naming conventions for high-resolution versions of the image. For example, if your bundle contains files named button.png, button@2x.png, and button.pdf then imageForResource:@"button" returns an NSImage object backed by all three files. Each time the NSImage object is drawn, it selects the representation best for the drawing context. このメソッドは、画像のハイレゾリューション版のためのApple命名規則に対応します。例えば、あなたのバンドルがbutton.png、button@2x.png、そしてbutton.pdfと命名されるファイルを含むならば、そのときimageForResource:@"button"は３つのファイル全てが背後にあるNSImageオブジェクトを返します。NSImageオブジェクトが描画されるたびに、それは描画コンテキストに最良の表現を選択します。

Images requested using this method whose name ends in the word Template are automatically marked as template images. このメソッドを使って要求された、それの名前が単語Templateで終わる画像は、自動的に雛形画像として印されます。

This method does not look up images based on setName(_:) or get named system images. Use init(named:) for that purpose. このメソッドは、setName(_:)に基づく画像の検索や、名前付システム画像の取得を行いません。init(named:)をその目的のために使ってください。

This method does not cache its search results. このメソッドは、それの検索結果をキャッシュしません。

See Also 参照

Finding Image Resources 画像リソースを見つける

func urlForImageResource(NSImage.Name) -> URL?
Returns the location of the specified image resource as an NSURL. 指定された画像リソースの位置をNSURLとして返します。
func pathForImageResource(NSImage.Name) -> String?
Returns the location of the specified image resource file. 指定された画像リソースの位置を返します。

Related Documentation 関連文書

init?(named: NSImage.Name)
Returns the image object associated with the specified name. 指定された名前と結びつけられた画像を返します。