NSAttributedString

Overview 概要

An NSAttributedString object manages character strings and associated sets of attributes (for example, font and kerning) that apply to individual characters or ranges of characters in the string. An association of characters and their attributes is called an attributed string. The cluster’s two public classes, NSAttributedString and NSMutableAttributedString, declare the programmatic interface for read-only attributed strings and modifiable attributed strings, respectively. NSAttributedStringオブジェクトは、文字列と、文字列中の個々の文字または文字範囲に適用される関連する属性一式（例えば、フォントとカーニング（文字詰め））を管理します。文字とそれらの属性の結合したものは、属性付文字と呼ばれます。クラスタのもつ２つのパブリッククラス、NSAttributedStringとNSMutableAttributedStringは、それぞれ読出し専用属性付文字列と修正可属性付文字列に対するプログラムインターフェイスを宣言します。

An attributed string identifies attributes by name, using an NSDictionary object to store a value under the specified name. You can assign any attribute name/value pair you wish to a range of characters—it is up to your application to interpret custom attributes (see Attributed String Programming Guide). If you are using attributed strings with the Core Text framework, you can also use the attribute keys defined by that framework. 属性付文字列は、属性を名前によって識別します、NSDictionaryオブジェクトを使うことである値をその指定された名前のもと格納しています。あなたは、随意の属性名/値のペアをあなたが望む文字の範囲に割り当てることが可能です — あなたのアプリケーションにはそれらカスタム属性を解釈する義務があります（Attributed String Programming Guideを見てください）。あなたが属性付文字列をCore Textフレームワークとともに使っているならば、あなたはまたそのフレームワークによって定義される属性キーを使うことができます。

You use attributed strings with any APIs that accept them, such as Core Text. The AppKit and UIKit frameworks also provide a subclass of NSMutableAttributedString, called NSTextStorage, to provide the storage for the extended text-handling system. In iOS 6 and later you can use attributed strings to display formatted text in text views, text fields, and some other controls. Both AppKit and UIKit also define extensions to the basic attributed string interface that allows you to draw their contents in the current graphic context. あなたは、属性付文字列をそれらを受け取る随意のAPIで使います、例えばCore Textなど。AppKitとUIKitフレームワークはまた、NSMutableAttributedStringのサブクラス、NSTextStorageと呼ばれるものを提供して、拡張テキスト処理システムに対するストレージを提供します。iOS 6以降ではあなたは属性付文字列を使うことで、書式設定されたテキストをテキストビュー、そして何か他のコントロールにおいて表示できます。AppKitとUIKitの両方とも、拡張を定義することで、基本的な属性付文字列インターフェイスを定義できます、それはあなたにそれらの内容を現在のグラフィック文脈において描画させるものです。

The default font for NSAttributedString objects is Helvetica 12-point, which may differ from the default system font for the platform. Thus, you might want to create new strings with non-default attributes suitable for your application. You can also use the NSParagraphStyle class and its subclass NSMutableParagraphStyle to encapsulate the paragraph or ruler attributes used by the NSAttributedString classes. NSAttributedStringに対する省略時のフォントは、Helvetica 12ポイントです、それはプラットホームのための省略時のシステムフォントとは異なるかもしれません。したがって、あなたは新しい文字列を省略時のものでない属性であなたのアプリケーションにふさわしく作成したいかもしれません。あなたはまた、NSParagraphStyleクラスとそれのサブクラスNSMutableParagraphStyleを使って、NSAttributedStringクラスによって使われる段落またはルーラー属性をカプセル化できます。

Be aware that comparisons of NSAttributedString objects using the isEqual: method look for exact equality. The comparison includes both a character-by-character string equality check and an equality check of all attributes. Such a comparison is not likely to yield a match if the string has many attributes, such as attachments, lists, and tables, for example. NSAttributedStringオブジェクトそれらのisEqual:メソッドを使う比較は正確な同等性を求めることを承知していてください。その比較は、文字ごとの文字列同等性検査そして全ての属性の同等性検査の両方を含みます。そのような比較は、文字列が多くの属性、例えば添付書類、箇条書き、そして表などを、例えば持つならば、一致を生み出す可能性は低いです。

The NSAttributedString class is “toll-free bridged” with its Core Foundation counterpart, CFAttributedStringRef. See Toll-Free Bridging for more information. NSAttributedStringクラスは、それのCore Foundation相当物CFAttributedStringRefと「トールフリーブリッジ（通行料無料の橋渡し）」されます。Toll-Free Bridgingをさらなる情報として見てください。