Core Graphics > CGPDFDictionary
CGPDFDictionary
PDF 文書内の辞書構造。
概観
辞書オブジェクトは、PDF 文書の主要な基本成分です。辞書内のキー値のペアはエントリと呼ばれます。PDF 辞書では、キーは文字の配列でなければなりません。特定の辞書内では、キーは一意です。すなわち、1 つの辞書内の 2 つのキーが等しく(strcmp によって決定されます) ありません。キーに関連した値は、別の辞書を含む任意の種類の PDF オブジェクトにすることができます。辞書オブジェクトは、PDF 文書の主要な基本成分です。
PDF 辞書から値を取得する関数の多くは、以下の形式をとります：
リスト 1
bool CGPDFDictionaryGet<DataType> ( CGPDFDictionaryRef dictionary, const char *key, <DataType>Ref *value );
これらの関数は、指定されたキーに関連したオブジェクトがあるかどうかをテストします。指定されたキーに関連したオブジェクトがある場合、そのデータ型をテストします。関連したオブジェクトがない場合、または期待された型ではない場合、関数は false を返します。指定されたキーに関連したオブジェクトがあり、期待された型である場合、この関数は true を返し、オブジェクトは value パラメータに返されます。
このオブジェクトは CFType から派生したものではないため、これを保持したり解放する関数はありません。CGPDFDictionary オブジェクトは、CGPDFDocument オブジェクトの構成部分としてのみ存在し、それらのコンテナによって管理されます。
シンボル
関数をすべてのエントリに適用
func CGPDFDictionaryApplyFunction(CGPDFDictionaryRef, CGPDFDictionaryApplierFunction, UnsafeMutableRawPointer?)
関数を辞書の各エントリに適用します。
辞書からデータを取得
func CGPDFDictionaryGetArray(CGPDFDictionaryRef, UnsafePointer<Int8>, UnsafeMutablePointer<CGPDFArrayRef?>?)
PDF 辞書内の指定されたキーに関連した PDF 配列があるかどうかを返し、もしあれば、その配列を取得します。
func CGPDFDictionaryGetBoolean(CGPDFDictionaryRef, UnsafePointer<Int8>, UnsafeMutablePointer<CGPDFBoolean>?)
PDF 辞書内の指定されたキーに関連した PDF ブール値があるかどうかを返し、もしあればブール値を取得します。
func CGPDFDictionaryGetCount(CGPDFDictionaryRef)
PDF 辞書内のエントリ数を返します。
func CGPDFDictionaryGetDictionary(CGPDFDictionaryRef, UnsafePointer<Int8>, UnsafeMutablePointer<CGPDFDictionaryRef?>?)
PDF 辞書内に指定されたキーに関連した別の PDF 辞書があるかどうかを返します。もしあれば、その辞書を取得します。
func CGPDFDictionaryGetInteger(CGPDFDictionaryRef, UnsafePointer<Int8>, UnsafeMutablePointer<CGPDFInteger>?)
PDF 辞書内に指定されたキーに関連した PDF 整数があるかどうかを返します。もしあれば、その整数を取得します。
func CGPDFDictionaryGetName(CGPDFDictionaryRef, UnsafePointer<Int8>, UnsafeMutablePointer<UnsafePointer<Int8>?>?)
PDF 辞書内の指定されたキーを持つオブジェクトが PDF 名参照(定数 C 文字列として表される) かどうかを返します。そうであれば、その名前を取得します。
func CGPDFDictionaryGetNumber(CGPDFDictionaryRef, UnsafePointer<Int8>, UnsafeMutablePointer<CGPDFReal>?)
PDF 辞書内の指定されたキーに関連した PDF 数字があるかどうかを返します。もしあれば、その番号を取得します。
func CGPDFDictionaryGetObject(CGPDFDictionaryRef, UnsafePointer<Int8>, UnsafeMutablePointer<CGPDFObjectRef?>?)
PDF 辞書内の指定されたキーに関連した PDF オブジェクトがあるかどうかを返します。もしあれば、そのオブジェクトを取得します。
func CGPDFDictionaryGetStream(CGPDFDictionaryRef, UnsafePointer<Int8>, UnsafeMutablePointer<CGPDFStreamRef?>?)
PDF 辞書内の指定されたキーに関連した PDF ストリームがあるかどうかを返します。もしあれば、そのストリームを取得します。
func CGPDFDictionaryGetString(CGPDFDictionaryRef, UnsafePointer<Int8>, UnsafeMutablePointer<CGPDFStringRef?>?)
PDF 辞書内の指定されたキーに関連した PDF 文字列があるかどうかを返します。もしあれば、その文字列を取得します。
呼び出し関数
CGPDFDictionaryApplierFunction
オプションのコンテキスト情報を使用して、PDF 辞書からのキー値ペアのカスタム処理を実行します。
データ型
PDF 辞書をカプセル化する型。
以下も見よ
関連した文書