Class

NSAttributedString

A string with associated attributes (such as visual style, hyperlinks, or accessibility data) for portions of its text. それのテキストの一部に対する結び付けられた属性(たとえば視覚形式、ハイパーリンク、またはアクセシビリティ・データなど)をもつ文字列。

Declaration 宣言

class NSAttributedString : NSObject

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オブジェクトは、文字列と、文字列中の個々の文字または文字範囲に適用される関連する属性一式(例えば、フォントとカーニング(文字詰め))を管理します。文字とそれらの属性の結合したものは、属性付文字と呼ばれます。クラスタのもつ2つのパブリッククラス、NSAttributedStringNSMutableAttributedStringは、それぞれ読出し専用属性付文字列と修正可属性付文字列に対するプログラムインターフェイスを宣言します。

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, CFAttributedString. See Toll-Free Bridging for more information. NSAttributedStringクラスは、それのCore Foundation相当物、CFAttributedStringと「トールフリーブリッジ(通行料無料の橋渡し)」されます。さらなる情報のためにToll-Free Bridgingを見てください。

Topics 話題

Creating an Attributed String 属性付き文字列を作成する

Loading an Attributed String from HTML 属性付き文字列をHTMLからロードする

To create an attributed string from HTML using these methods, you must import the WebKit framework. 属性付き文字列をHTMLからこれらメソッドを使って作成するには、あなたはWebKitフレームワークをインポートする必要があります。

Creating an Attributed String from Markdown 属性付き文字列をMarkdownから作成する

Creating a Reference-Type Attributed String from a Value Type

Retrieving Character Information 文字情報を回収する

Retrieving Attribute Information 属性情報を回収する

Comparing Attributed Strings 属性付文字列を比較する

Extracting a Substring 下位文字列の抽出

Enumerating over Attributes in a String 文字列中の属性の全てを列挙する

Retrieving Font Attribute Information フォント属性情報を回収する

Calculating Linguistic Units 言語学的単位を計算する

Calculating Ranges 範囲を計算する

Generating Data データの生成

Performing Automatic Grammar Agreement 自動文法一致を実行する

Drawing the String 文字列を描画する

Getting Metrics for the String 文字列に対する寸法を得る

Testing String Data Sources 文字列データソースをテストする

Specifying Text Attributes テキスト属性を指定する

Specifying Document Attributes 書類属性を指定する

Specifying Document Reading Options 書類読出しオプションを指定する

Constants 定数

Deprecated 非推奨

See Also 参照

Strings with Metadata メタデータを持つ文字列