Core Foundation > CFAttributedString
CFAttributedString
概観
CFAttributedString のインスタンスは、文字列内の個々の文字または文字の範囲に適用される文字列および関連したセットの属性 (たとえば、フォントやカーニング情報) を管理します。Core Foundation で定義されている CFAttributedString は基本的なコンテナ機能を提供し、上位レベルは標準属性、その値、およびこれらに含まれる追加動作の定義を提供します。CFAttributedString は、作成後に変更可能な属性付き文字列を作成および管理するための不変の文字列 CFMutableAttributedString の使用を表します。
CFAttributedString は CFString の "サブクラス" ではありません。つまり、CFString 関数呼び出しに応答しません。CFAttributedString には、属性を適用する CFString が概念的に含まれています。これにより、シンプル文字列と属性付き文字列の間の意味の違いによって生じる曖昧さから保護されます。
属性は、CFDictionary オブジェクトに格納されたキー/値のペアによって識別されます。キーは CFString オブジェクトでなければならず、対応する値は適切な型の CFType オブジェクトです。標準の属性名については、 "NSAttributedString Application Kit Additions Reference" の属性定数または "NSAttributedString UIKit Additions Reference" を参照してください。
CFAttributedString は、Foundation で対応する NSAttributedString と "通話無料でブリッジ" されています。つまり、Core Foundation 型は、ブリッジされた Foundation オブジェクトを関数またはメソッド呼び出しと交換可能です。したがって、NSAttributedString * パラメータを参照するメソッドでは、CFAttributedStringRef を渡すことができ、CFAttributedStringRef パラメータがある関数では、NSAttributedString インスタンスを渡すことができます。これは、NSAttributedString の具象サブクラスにも当てはまります。通話無料でブリッジの詳細については、通話無料でブリッジされた型 を参照してください。
シンボル
CFAttributedString の作成
func CFAttributedStringCreate(CFAllocator!, CFString!, CFDictionary!)
指定された文字列と属性を持つ属性付き文字列を作成します。
func CFAttributedStringCreateCopy(CFAllocator!, CFAttributedString!)
属性付き文字列の変更不能コピーを作成します。
func CFAttributedStringCreateWithSubstring(CFAllocator!, CFAttributedString!, CFRange)
指定された範囲から属性付きのサブストリングを作成します。
func CFAttributedStringGetLength(CFAttributedString!)
文字の中の属性付き文字列の長さを返します。
func CFAttributedStringGetString(CFAttributedString!)
属性付き文字列用の文字列を返します。
属性へのアクセス
func CFAttributedStringGetAttribute(CFAttributedString!, CFIndex, CFString!, UnsafeMutablePointer<CFRange>!)
指定された場所にある属性付き文字列の与えられた属性の値を返します。
func CFAttributedStringGetAttributes(CFAttributedString!, CFIndex, UnsafeMutablePointer<CFRange>!)
指定された場所にある属性付き文字列の属性を返します。
func CFAttributedStringGetAttributeAndLongestEffectiveRange(CFAttributedString!, CFIndex, CFString!, CFRange, UnsafeMutablePointer<CFRange>!)
指定された場所の属性付き文字列の与えられた属性の値を返します。
func CFAttributedStringGetAttributesAndLongestEffectiveRange(CFAttributedString!, CFIndex, CFRange, UnsafeMutablePointer<CFRange>!)
指定された場所にある属性付き文字列の属性を返します。
属性付き文字列プロパティを取得
func CFAttributedStringGetTypeID()
CFAttributedString 不透明型の型 ID を返します。
データ型
CFAttributedString オブジェクトへの参照。
以下も見よ
関連する文書
Core Foundation のプロパティリストプログラミングトピック
Core Foundation の String プログラミングガイド