Foxit PDF SDK
foxit.pdf.objects.PDFDictionary类 参考
类 foxit.pdf.objects.PDFDictionary 继承关系图:
foxit.pdf.objects.PDFObject

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 ( )
inlinestatic

创建新的字典对象。

如果创建的对象尚未添加/设置到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