Foxit PDF SDK

Public 成员函数 | 静态 Public 成员函数 | 所有成员列表
foxit.pdf.objects.PDFDictionary类 参考
类 foxit.pdf.objects.PDFDictionary 继承关系图:

## Public 成员函数
PDFObject | GetElement (string key)
| 获取具有指定键的条目的值元素。 更多...
string | GetKey (long position)
| 获取由位置指定的条目的键。 更多...
PDFObject | GetValue (long position)
| 获取由位置指定的条目的值元素。 更多...
bool | HasKey (string key)
| 检查当前字典中是否存在具有指定键的条目。 更多...
long | MoveNext (long position)
| 移动到第一个或下一个条目的位置。 更多...
void | RemoveAt (string key)
| 移除由键指定的条目。 更多...
void | SetAt (string key, PDFObject pdf_object)
| 将直接PDF对象（其对象编号总是等于0）作为值元素设置到由键指定的条目。 更多...
void | SetAtBoolean (string key, bool value)
| 将布尔元素设置到由键指定的条目。 更多...
void | SetAtDateTime (string key, DateTime value)
| 将Datetime对象作为值元素设置到由键指定的条目。 更多...
void | SetAtFloat (string key, float value)
| 将浮点数元素设置到由键指定的条目。 更多...
void | SetAtInteger (string key, int value)
| 将整数元素设置到由键指定的条目。 更多...
void | SetAtMatrix (string key, Matrix2D value)
| 将矩阵对象作为值元素设置到由键指定的条目。 更多...
void | SetAtName (string key, string value)
| 将字符串（作为PDF名称对象）作为值元素设置到由键指定的条目。 更多...
void | SetAtRect (string key, RectF value)
| 将矩形对象作为值元素设置到由键指定的条目。 更多...
void | SetAtReference (string key, PDFObject pdf_object, PDFDoc document)
| 将间接PDF对象（其对象编号总是大于0）的引用对象作为值元素设置到由键指定的条目。 更多...
void | SetAtString (string key, string value)
| 将字符串作为值元素设置到由键指定的条目。 更多...
Public 成员函数 继承自 foxit.pdf.objects.PDFObject
PDFObject | CloneObject ()
| 克隆当前PDF对象并获取克隆的PDF对象。 更多...
PDFObject | DeepCloneObject ()
| 克隆当前PDF对象并获取克隆的PDF对象。 更多...
PDFArray | GetArray ()
| 获取当前PDF对象的PDF数组对象。 更多...
bool | GetBoolean ()
| 获取当前PDF对象的布尔值。 更多...
DateTime | GetDateTime ()
| 获取当前PDF对象的日期时间值。 更多...
PDFDictionary | GetDict ()
| 获取当前PDF对象的PDF字典对象。 更多...
PDFObject | GetDirectObject ()
| 获取当前PDF对象的直接对象。 更多...
float | GetFloat ()
| 获取当前PDF对象的浮点数值。 更多...
int | GetInteger ()
| 获取当前PDF对象的整数值。 更多...
Matrix2D | GetMatrix ()
| 获取当前PDF对象的矩阵值。 更多...
string | GetName ()
| 获取当前PDF对象的名称值。 更多...
int | GetObjNum ()
| 获取当前PDF对象的间接对象编号。 更多...
RectF | GetRect ()
| 获取当前PDF对象的矩形值。 更多...
PDFStream | GetStream ()
| 获取当前PDF对象的PDF流对象。 更多...
byte [] | GetString ()
| 获取当前PDF对象的字符串值。 更多...
PDFObject.Type | GetType ()
| 获取当前PDF对象的类型。 更多...
string | GetWideString ()
| 获取当前PDF对象的宽字符串值。 更多...
bool | IsIdentical (PDFObject pdf_obj)
| 检查输入的PDF对象是否与当前PDF对象相同。 更多...
void | Release ()
| 释放新创建的PDF对象或克隆PDF对象， 该对象与PDF文档或其他PDF对象无关且不会再使用。 更多...

## 静态 Public 成员函数
static PDFDictionary | Create ()
| 创建新的字典对象。 更多...
静态 Public 成员函数 继承自 foxit.pdf.objects.PDFObject
static PDFObject | CreateFromBoolean (bool boolean_value)
| 从布尔值创建PDF对象。 更多...
static PDFObject | CreateFromDateTime (DateTime date_time)
| 从日期时间创建PDF对象。 更多...
static PDFObject | CreateFromFloat (float float_value)
| 从浮点数创建PDF对象。 更多...
static PDFObject | CreateFromInteger (int integer_value)
| Create a PDF object from a integer number. 更多...
static PDFObject | CreateFromName (string name)
| 从表示名称的字符串创建PDF对象。 更多...
static PDFObject | CreateFromNameW (string name)
| 从表示名称的字符串创建PDF对象。 更多...
static PDFObject | CreateFromString (string string_value)
| 从字符串创建PDF对象。 更多...
static PDFObject | CreateFromString (string string_value, int length)
| 从字符串创建PDF对象。 更多...
static PDFObject | CreateReference (PDFDoc document, int object_number)
| 为间接对象创建引用。 更多...

## 额外继承的成员函数
Public 类型 继承自 foxit.pdf.objects.PDFObject
enum | Type { Type.e_InvalidType = 0, Type.e_Boolean = 1, Type.e_Number = 2, Type.e_String = 3, Type.e_Name = 4, Type.e_Array = 5, Type.e_Dictionary = 6, Type.e_Stream = 7, Type.e_Null = 8, Type.e_Reference = 9 }
| PDF对象类型的枚举。 更多...

## 详细描述

PDF字典对象是一个关联表，包含成对的对象，称为字典的条目。 每个条目的第一个元素是键，它必须是一个PDF名称对象。第二个元素是值， 它可以是任何种类的PDF对象，包括另一个字典。在同一个字典中， 不应有两个条目具有相同的键。有关更多详细信息，请参阅<PDF Reference 1.7>中的第3.2.6节“字典对象”。
类foxit.pdf.objects.PDFDictionary 派生自PDFObject ，并提供函数来创建新的PDF字典对象以及 获取/设置PDF字典对象中的条目。

参见
  PDFObject

## 成员函数说明

## ◆ Create()

static PDFDictionary foxit.pdf.objects.PDFDictionary.Create | ( |  | ) |
| inline static

创建新的字典对象。

如果创建的对象尚未添加/设置到PDF文档或其他PDF对象中且不会再使用， 请调用函数PDFObject.Release 来释放该对象。

返回
  一个新的PDFDictionary 对象。 如果有任何错误，此函数将返回null。

## ◆ GetElement()

PDFObject foxit.pdf.objects.PDFDictionary.GetElement | ( | string | key | ) |
| inline

获取具有指定键的条目的值元素。

参数

  [in] | key | 条目的键。它不应为空字符串。

返回
  一个PDFObject 对象，接收具有指定键的值。 如果未找到，此函数将返回null。

## ◆ GetKey()

string foxit.pdf.objects.PDFDictionary.GetKey | ( | long | position | ) |
| inline

获取由位置指定的条目的键。

参数

  [in] | position | 指定条目位置的POSITION。它不应为null或0。

返回
  指定条目的键。

## ◆ GetValue()

PDFObject foxit.pdf.objects.PDFDictionary.GetValue | ( | long | position | ) |
| inline

获取由位置指定的条目的值元素。

参数

  [in] | position | 指定条目位置的POSITION。它不应为null或0。

返回
  一个PDFObject ，接收指定条目的值元素。 如果有任何错误，此函数将返回null。

## ◆ HasKey()

bool foxit.pdf.objects.PDFDictionary.HasKey | ( | string | key | ) |
| inline

检查当前字典中是否存在具有指定键的条目。

参数

  [in] | key | 要检查的键。它不应为空字符串。

返回
  true表示指定的键存在于当前字典中，而false表示不存在。

## ◆ MoveNext()

long foxit.pdf.objects.PDFDictionary.MoveNext | ( | long | position | ) |
| inline

移动到第一个或下一个条目的位置。

参数

  [in] | position | 一个POSITION，指示字典中当前条目的位置。 如果为null或0，将返回字典中第一个条目的位置。

返回
  一个POSITION，表示字典中下一个条目的位置。 null或0表示当前条目是字典中的最后一个。

## ◆ RemoveAt()

void foxit.pdf.objects.PDFDictionary.RemoveAt | ( | string | key | ) |
| inline

移除由键指定的条目。

参数

  [in] | key | 要移除的条目的键。它不应为空字符串。

返回
  无。

## ◆ SetAt()

void foxit.pdf.objects.PDFDictionary.SetAt | ( | string | key,
|  | PDFObject | pdf_object
| ) |  |
| inline

将直接PDF对象（其对象编号总是等于0）作为值元素设置到由键指定的条目。

如果用户想要将间接PDF对象（其对象编号总是大于0）设置到条目， 请参考函数PDFDictionary.SetAtReference 。

参数

  [in] | key | 条目的键，其值元素将被设置。它不应为空字符串。
  [in] | pdf_object | 一个PDFObject 对象，它是一个直接PDF对象（其对象编号总是等于0），将被设置到条目。 它不应为null。

返回
  无。

## ◆ SetAtBoolean()

void foxit.pdf.objects.PDFDictionary.SetAtBoolean | ( | string | key,
|  | bool | value
| ) |  |
| inline

将布尔元素设置到由键指定的条目。

参数

  [in] | key | 条目的键，其值元素将被设置。它不应为空字符串。
  [in] | value | 将被设置到条目的布尔元素。

返回
  无。

## ◆ SetAtDateTime()

void foxit.pdf.objects.PDFDictionary.SetAtDateTime | ( | string | key,
|  | DateTime | value
| ) |  |
| inline

将Datetime对象作为值元素设置到由键指定的条目。

参数

  [in] | key | 条目的键，其值元素将被设置。它不应为空字符串。
  [in] | value | 将被设置到条目的日期时间信息。

返回
  无。

## ◆ SetAtFloat()

void foxit.pdf.objects.PDFDictionary.SetAtFloat | ( | string | key,
|  | float | value
| ) |  |
| inline

将浮点数元素设置到由键指定的条目。

参数

  [in] | key | 条目的键，其值元素将被设置。它不应为空字符串。
  [in] | value | 将被设置到条目的浮点数值。

返回
  无。

## ◆ SetAtInteger()

void foxit.pdf.objects.PDFDictionary.SetAtInteger | ( | string | key,
|  | int | value
| ) |  |
| inline

将整数元素设置到由键指定的条目。

参数

  [in] | key | 条目的键，其值元素将被设置。它不应为空字符串。
  [in] | value | 将被设置到条目的整数值。

返回
  无。

## ◆ SetAtMatrix()

void foxit.pdf.objects.PDFDictionary.SetAtMatrix | ( | string | key,
|  | Matrix2D | value
| ) |  |
| inline

将矩阵对象作为值元素设置到由键指定的条目。

参数

  [in] | key | 条目的键，其值元素将被设置。它不应为空字符串。
  [in] | value | 将被设置到条目的矩阵。

返回
  无。

## ◆ SetAtName()

void foxit.pdf.objects.PDFDictionary.SetAtName | ( | string | key,
|  | string | value
| ) |  |
| inline

将字符串（作为PDF名称对象）作为值元素设置到由键指定的条目。

参数

  [in] | key | 条目的键，其值元素将被设置。它不应为空字符串。
  [in] | value | 将作为PDF名称对象设置到条目的字符串。它不应为空字符串。

返回
  无。

## ◆ SetAtRect()

void foxit.pdf.objects.PDFDictionary.SetAtRect | ( | string | key,
|  | RectF | value
| ) |  |
| inline

将矩形对象作为值元素设置到由键指定的条目。

参数

  [in] | key | 条目的键，其值元素将被设置。它不应为空字符串。
  [in] | value | 将被设置到条目的矩形。

返回
  无。

## ◆ SetAtReference()

void foxit.pdf.objects.PDFDictionary.SetAtReference | ( | string | key,
|  | PDFObject | pdf_object,
|  | PDFDoc | document
| ) |  |
| inline

将间接PDF对象（其对象编号总是大于0）的引用对象作为值元素设置到由键指定的条目。

如果用户想要将直接PDF对象（其对象编号总是等于0）设置到条目， 请参考函数PDFDictionary.SetAt 。

参数

  [in] | key | 条目的键，其值元素将被设置。它不应为空字符串。
  [in] | pdf_object | 一个PDFObject 对象，它是一个间接PDF对象（其对象编号总是大于0）， 将通过引用此间接对象的引用对象设置到条目。它不应为null。
  [in] | document | 一个有效的PDF文档对象，当前PDF字典对象属于该文档， 且参数pdf_object是或将是其中的间接对象。

返回
  无。

## ◆ SetAtString()

void foxit.pdf.objects.PDFDictionary.SetAtString | ( | string | key,
|  | string | value
| ) |  |
| inline

将字符串作为值元素设置到由键指定的条目。

参数

  [in] | key | 条目的键，其值元素将被设置。它不应为空字符串。
  [in] | value | 将作为PDF字符串对象设置到条目的宽字符串。

返回
  无。

注解
  如果要获取字符串值，请调用函数PDFObject.GetWideString 。