Foxit PDF SDK

Public 类型 | Public 成员函数 | 所有成员列表
foxit::pdf::annots::Widget类 参考
类 foxit::pdf::annots::Widget 继承关系图:

## Public 类型
enum | LineSpacingStyle { e_LineSpacingSingle = 0, e_LineSpacingOneAndHalf = 1, e_LineSpacingDouble = 2, e_LineSpacingExactValue = 3, e_LineSpacingAuto = 4 }
| 行间距样式的枚举。 更多...
Public 类型 继承自 foxit::pdf::annots::Annot
enum | AppearanceType { e_AppearanceTypeNormal = 0, e_AppearanceTypeRollover = 1, e_AppearanceTypeDown = 2 }
| 注释外观类型的枚举。 更多...
enum | Flags { e_FlagInvisible = 0x0001, e_FlagHidden = 0x0002, e_FlagPrint = 0x0004, e_FlagNoZoom = 0x0008, e_FlagNoRotate = 0x0010, e_FlagNoView = 0x0020, e_FlagReadOnly = 0x0040, e_FlagLocked = 0x0080, e_FlagToggleNoView = 0x0100, e_FlagLockedContents = 0x0200 }
| PDF注释标志的枚举。 更多...
enum | HighlightingMode { e_HighlightingNone = 0, e_HighlightingInvert = 1, e_HighlightingOutline = 2, e_HighlightingPush = 3, e_HighlightingToggle = 4 }
| PDF注释高亮模式的枚举。 更多...
enum | MKEntry { e_MKEntryRotation = 0, e_MKEntryBorderColor = 1, e_MKEntryBackgroundColor = 2, e_MKEntryNormalCaption = 3, e_MKEntryRolloverCaption = 4, e_MKEntryDownCaption = 5, e_MKEntryNormalIcon = 6, e_MKEntryRolloverIcon = 7, e_MKEntryDownIcon = 8, e_MKEntryIconFit = 9, e_MKEntryIconCaptionRelation = 10 }
| 注释MK字典（外观特征）条目的枚举。 更多...
enum | MKIconCaptionRelation { e_MKRelationNoIcon = 0, e_MKRelationNoCaption = 1, e_MKRelationCaptionBelowIcon = 2, e_MKRelationCaptionAboveIcon = 3, e_MKRelationCaptionRight = 4, e_MKRelationCaptionLeft = 5, e_MKRelationCaptionOvrlayOnIcon = 6 }
| 注释MK字典中图标和标题相对位置的枚举。 更多...
enum | Property { e_PropertyModifiedDate = 0, e_PropertyCreationDate = 1, e_PropertyBorderColor = 2, e_PropertyFillColor = 3 }
| 某些PDF注释属性的枚举。 更多...
enum | Type { e_UnknownType = 0, e_Note = 1, e_Link = 2, e_FreeText = 3, e_Line = 4, e_Square = 5, e_Circle = 6, e_Polygon = 7, e_PolyLine = 8, e_Highlight = 9, e_Underline = 10, e_Squiggly = 11, e_StrikeOut = 12, e_Stamp = 13, e_Caret = 14, e_Ink = 15, e_PSInk = 16, e_FileAttachment = 17, e_Sound = 18, e_Movie = 19, e_Widget = 20, e_Screen = 21, e_PrinterMark = 22, e_TrapNet = 23, e_Watermark = 24, e_3D = 25, e_Popup = 26, e_Redact = 27, e_RichMedia = 28, e_PagingSeal = 29 }
| PDF注释类型的枚举。 更多...

## Public 成员函数
| Widget ()
| 构造函数。
| Widget (const Annot &annot)
| 构造函数，使用父类对象。 更多...
| ~Widget ()
| 析构函数。
actions::Action | GetAction ()
| 获取动作。 更多...
String | GetAppearanceOnStateName () const
| 获取注释外观"ON"状态的名称。 更多...
String | GetAppearanceState () const
| 获取注释的外观状态，从外观子字典中选择适用的外观流。 更多...
interform::Control | GetControl ()
| 获取关联的表单控件。 更多...
interform::Field | GetField ()
| 获取关联的表单字段。 更多...
HighlightingMode | GetHighlightingMode ()
| 获取高亮模式。 更多...
LineSpacingStyle | GetLineSpacing (float &line_spacing_value)
| 获取当前小部件的行间距。 更多...
RGB | GetMKBackgroundColor () const
| 获取 MK 字典中的背景颜色。 更多...
RGB | GetMKBorderColor () const
| 获取 MK 字典中的边框颜色。 更多...
WString | GetMKDownCaption () const
| 获取 MK 字典中的向下标题字符串。 更多...
common::Bitmap | GetMKDownIconBitmap ()
| 获取MK字典中的按下图标位图。 更多...
MKIconCaptionRelation | GetMKIconCaptionRelation () const
| 获取MK字典中图标和标题的关系。 更多...
IconFit | GetMKIconFit () const
| 获取MK字典中的图标适合信息。 更多...
WString | GetMKNormalCaption () const
| 获取 MK 字典中的普通标题字符串。 更多...
common::Bitmap | GetMKNormalIconBitmap ()
| 获取 MK 字典中的普通图标位图。 更多...
WString | GetMKRolloverCaption () const
| 获取 MK 字典中的翻转标题字符串。 更多...
common::Bitmap | GetMKRolloverIconBitmap ()
| 获取 MK 字典中的翻转图标位图。 更多...
common::Rotation | GetMKRotation () const
| 获取 MK 字典中的旋转值。 更多...
bool | HasMKEntry (MKEntry mk_entry)
| 检查在 MK 字典中是否存在指定的条目。 更多...
void | RemoveAction ()
| 移除动作。 更多...
void | RemoveMKEntry (MKEntry mk_entry)
| 从 MK 字典中移除指定的条目。 更多...
void | SetAction (const actions::Action &action)
| 设置动作。 更多...
void | SetAppearanceState (const String &appearance_state)
| 设置注释的外观状态，从外观子字典中选择适用的外观流。 更多...
void | SetHighlightingMode (HighlightingMode mode)
| 设置高亮模式。 更多...
void | SetLineSpacing (LineSpacingStyle line_spacing_style, float line_spacing_value)
| 设置当前小部件的行间距。 更多...
void | SetMKBackgroundColor (RGB color)
| 设置 MK 字典中的背景颜色。 更多...
void | SetMKBorderColor (RGB color)
| 设置 MK 字典中的边框颜色。 更多...
void | SetMKDownCaption (const wchar_t *caption)
| 设置 MK 字典中的向下标题字符串。 更多...
void | SetMKDownIconBitmap (const common::Bitmap &bitmap)
| 设置MK字典中的按下图标位图。 更多...
void | SetMKDownIconImage (const common::Image &image, int frame_index)
| 设置指定帧索引的图像作为MK字典中的按下图标。 更多...
void | SetMKIconCaptionRelation (MKIconCaptionRelation relation)
| 设置MK字典中图标和标题的关系。 更多...
void | SetMKIconFit (const IconFit &icon_fit)
| 设置MK字典中的图标适合信息。 更多...
void | SetMKNormalCaption (const wchar_t *caption)
| 设置 MK 字典中的普通标题字符串。 更多...
void | SetMKNormalIconBitmap (const common::Bitmap &bitmap)
| 设置一个位图作为 MK 字典中的普通图标。 更多...
void | SetMKNormalIconImage (const common::Image &image, int frame_index)
| 设置指定帧索引的图像作为 MK 字典中的普通图标。 更多...
void | SetMKRolloverCaption (const wchar_t *caption)
| 设置 MK 字典中的翻转标题字符串。 更多...
void | SetMKRolloverIconBitmap (const common::Bitmap &bitmap)
| 设置MK字典中的翻转图标位图。 更多...
void | SetMKRolloverIconImage (const common::Image &image, int frame_index)
| 设置指定帧索引的图像作为MK字典中的翻转图标。 更多...
void | SetMKRotation (common::Rotation rotation)
| 设置 MK 字典中的旋转值。 更多...
Public 成员函数 继承自 foxit::pdf::annots::Annot
| Annot ()
| 构造函数。
| Annot (const Annot &annot)
| 构造函数，使用另一个注释对象。 更多...
| Annot (const PDFPage &page, objects::PDFDictionary *annot_dict)
| 构造函数，使用PDF页面和注释的PDF字典。 更多...
virtual | ~Annot ()
| 析构函数。
objects::PDFStream * | GetAppearanceStream (AppearanceType type, const char *appearance_state="") const
| 获取具有指定类型和状态的注释外观流。 更多...
RGB | GetBorderColor () const
| 获取边框颜色。 更多...
BorderInfo | GetBorderInfo () const
| 获取边框信息。 更多...
WString | GetContent () const
| 获取内容。 更多...
RectI | GetDeviceRect (const Matrix &matrix)
| 获取设备坐标系统中的注释矩形。 更多...
objects::PDFDictionary * | GetDict () const
| 获取注释的字典对象。 更多...
Matrix | GetDisplayMatrix (const Matrix &page_display_matrix)
| 获取显示矩阵，从PDF坐标系统到 目标设备坐标系统。 更多...
uint32 | GetFlags () const
| 获取注释标志。 更多...
int | GetIndex () const
| 获取当前注释在其所属页面中的索引。 更多...
DateTime | GetModifiedDateTime () const
| 获取最后修改日期时间。 更多...
objects::PDFDictionary * | GetOptionalContent () const
| 获取注释可选内容的PDF字典。 更多...
PDFPage | GetPage () const
| 获取相关的PDF页面。 更多...
RectF | GetRect () const
| 获取矩形，以PDF坐标系统表示。 更多...
Type | GetType () const
| 获取当前注释的实际注释类型。 更多...
WString | GetUniqueID () const
| 获取唯一ID。 更多...
bool | HasProperty (Property property) const
| 当前注释是否具有指定的注释属性。 更多...
bool | IsEmpty () const
| 检查当前对象是否为空。 更多...
bool | IsMarkup () const
| 检查当前注释是否为标记注释。 更多...
bool | Move (const RectF &rect)
| 将当前注释移动到新位置，由PDF坐标系统中的新矩形指定。 更多...
bool | Move (const RectF &rect, bool is_reset_appearance)
| 将当前注释移动到新位置，由PDF坐标系统中的新矩形指定。 更多...
bool | operator!= (const Annot &other) const
| 不等于运算符。 更多...
Annot & | operator= (const Annot &annot)
| 赋值运算符。 更多...
bool | operator== (const Annot &other) const
| 等于运算符。 更多...
bool | RemoveProperty (Property property)
| 删除指定的注释属性。 更多...
bool | ResetAppearanceStream ()
| 重置外观流。 更多...
bool | ResetAppearanceStream (bool is_generate_new_appearance_obj)
| 重置外观流。 更多...
void | SetBorderColor (RGB color)
| 设置边框颜色。 更多...
void | SetBorderInfo (const BorderInfo &border)
| 设置边框信息。 更多...
void | SetContent (const WString &content)
| 设置内容。 更多...
void | SetFlags (uint32 flags)
| 设置注释标志。 更多...
void | SetModifiedDateTime (const DateTime &date_time)
| 设置最后修改日期时间。 更多...
void | SetUniqueID (const WString &unique_id)
| 设置唯一ID。 更多...
Public 成员函数 继承自 foxit::Base
FS_HANDLE | Handle () const
| 获取当前对象的句柄。 更多...

## 详细描述

小部件注释用于表示表单字段的外观。
类 annots::Widget 派生自类 Annot，并且还提供了获取/设置小部件注释属性的函数。 函数 Widget::GetField 和 Widget::GetControl 可用于获取关联的表单字段 和表单控件对象。如果小部件注释没有与任何表单字段关联或与 签名字段关联，此小部件仍可以获取/设置属性，但无法重置外观。对于这些情况， Annot::ResetAppearanceStream（从 Widget 的父类继承）将直接返回 false。

参见
  Annot
  interform::Field
  interform::Control

## 成员枚举类型说明

## ◆ LineSpacingStyle

enum foxit::pdf::annots::Widget::LineSpacingStyle

行间距样式的枚举。

此枚举的值应单独使用。

枚举值
e_LineSpacingSingle | 行间距样式：单倍行间距。
e_LineSpacingOneAndHalf | 行间距样式：1.5倍行间距。
e_LineSpacingDouble | 行间距样式：双倍行间距。
e_LineSpacingExactValue | 行间距样式：精确值行间距。
e_LineSpacingAuto | 行间距样式：自动行间距。

## 构造及析构函数说明

## ◆ Widget()

foxit::pdf::annots::Widget::Widget | ( | const Annot & | annot | ) |
| explicit

构造函数，使用父类对象。

参数

  [in] | annot | 父类对象。

## 成员函数说明

## ◆ GetAction()

actions::Action foxit::pdf::annots::Widget::GetAction | ( |  | ) |

获取动作。

此函数不能用于获取用作附加动作的动作。 如果用户想要获取任何附加动作，请参考类 actions::AdditionalAction 了解更多详情。

返回
  接收动作数据的动作对象。如果返回的动作对象的函数 actions::Action::IsEmpty 返回值为 true，那意味着没有动作。

## ◆ GetAppearanceOnStateName()

String foxit::pdf::annots::Widget::GetAppearanceOnStateName | ( |  | ) | const

获取注释外观"ON"状态的名称。

返回
  注释外观"ON"状态的名称。

## ◆ GetAppearanceState()

String foxit::pdf::annots::Widget::GetAppearanceState | ( |  | ) | const

获取注释的外观状态，从外观子字典中选择适用的外观流。

返回
  注释的外观状态。

## ◆ GetControl()

interform::Control foxit::pdf::annots::Widget::GetControl | ( |  | ) |

获取关联的表单控件。

返回
  关联的表单控件对象。

## ◆ GetField()

interform::Field foxit::pdf::annots::Widget::GetField | ( |  | ) |

获取关联的表单字段。

返回
  关联的表单字段对象。

## ◆ GetHighlightingMode()

HighlightingMode foxit::pdf::annots::Widget::GetHighlightingMode | ( |  | ) |

获取高亮模式。

高亮模式是当鼠标按钮在其活动区域内按下或保持按下时使用的视觉效果。

返回
  高亮模式值。请参考从Annot::e_HighlightingNone开始的值， 这将是这些值中的一个。

## ◆ GetLineSpacing()

LineSpacingStyle foxit::pdf::annots::Widget::GetLineSpacing | ( | float & | line_spacing_value | ) |

获取当前小部件的行间距。

这仅适用于与包含标志interform::Field::e_FlagTextMultiline的文本字段关联的小部件。 对于其他类型的字段，这将无用。

参数

  [out] | line_spacing_value | 接收行间距精确值的输出参数。

返回
  行间距样式。请参考从Widget::e_LineSpacingSingle开始的值， 这将是这些值中的一个。

## ◆ GetMKBackgroundColor()

RGB foxit::pdf::annots::Widget::GetMKBackgroundColor | ( |  | ) | const

获取 MK 字典中的背景颜色。

MK 字典是一个外观特性字典，用于构建动态外观流， 指定注释在页面上的视觉呈现。

返回
  MK 字典中的背景颜色。值格式：0xRRGGBB。
  0 可能表示 MK 字典中没有背景颜色。在这种情况下，请使用值 Annot::e_MKEntryBackgroundColor 调用函数 Widget::HasMKEntry 进行检查。

## ◆ GetMKBorderColor()

RGB foxit::pdf::annots::Widget::GetMKBorderColor | ( |  | ) | const

获取 MK 字典中的边框颜色。

MK 字典是一个外观特性字典，用于构建动态外观流， 指定注释在页面上的视觉呈现。

返回
  MK 字典中的边框颜色。值格式：0xRRGGBB。
  0 可能表示 MK 字典中没有边框颜色。在这种情况下，请使用值 Annot::e_MKEntryBorderColor 调用函数 Widget::HasMKEntry 进行检查。

## ◆ GetMKDownCaption()

WString foxit::pdf::annots::Widget::GetMKDownCaption | ( |  | ) | const

获取 MK 字典中的向下标题字符串。

MK 字典是一个外观特性字典，用于构建动态外观流， 指定注释在页面上的视觉呈现。 MK 字典中的向下标题（或备用标题）用于在鼠标按钮在其活动区域内按下时显示。 这适用于与按钮字段关联的小部件。对于其他类型的字段，这将无用。

返回
  向下标题字符串。空字符串可能表示 MK 字典中没有向下标题。在这种情况下， 请使用值 Annot::e_MKEntryDownCaption 调用函数 Widget::HasMKEntry 进行检查。

## ◆ GetMKDownIconBitmap()

common::Bitmap foxit::pdf::annots::Widget::GetMKDownIconBitmap | ( |  | ) |

获取MK字典中的按下图标位图。

MK字典是一个外观特性字典，用于构建动态外观流， 指定注释在页面上的视觉呈现。 MK字典中的按下图标（或备用图标）用于在鼠标按钮在其活动区域内 按下时显示。这适用于与按钮字段关联的小部件。 对于其他类型的字段，这将无用。

返回
  按下图标位图。如果返回的位图对象的函数common::Bitmap::IsEmpty返回true， 则表示当前小部件注释没有按下图标位图。

## ◆ GetMKIconCaptionRelation()

MKIconCaptionRelation foxit::pdf::annots::Widget::GetMKIconCaptionRelation | ( |  | ) | const

获取MK字典中图标和标题的关系。

MK字典是一个外观特性字典，用于构建动态外观流， 指定注释在页面上的视觉呈现。 标题和图标的关系位置指定小部件注释标题文本相对于其图标的位置。 这适用于与按钮字段关联的小部件。对于其他类型的字段， 这将无用。

返回
  标题和图标的关系位置。请参考Annot::e_MKRelationNoIcon 值，这应该是这些值中的一个。

## ◆ GetMKIconFit()

IconFit foxit::pdf::annots::Widget::GetMKIconFit | ( |  | ) | const

获取MK字典中的图标适合信息。

MK字典是一个外观特性字典，用于构建动态外观流， 指定注释在页面上的视觉呈现。 图标适合信息指定如何在注释矩形内显示小部件注释的图标。 如果存在，图标适合信息适用于注释的所有图标。 这适用于与按钮字段关联的小部件。对于其他类型的字段， 这将无用。

返回
  图标适合对象，包含MK字典中的图标适合信息。 如果图标适合对象的缩放方式类型是值IconFit::e_ScaleWayNone， 则表示MK字典中没有图标适合信息。

## ◆ GetMKNormalCaption()

WString foxit::pdf::annots::Widget::GetMKNormalCaption | ( |  | ) | const

获取 MK 字典中的普通标题字符串。

MK 字典是一个外观特性字典，用于构建动态外观流， 指定注释在页面上的视觉呈现。 MK 字典中的普通标题用于在小部件不与用户交互时显示。 这适用于与按钮字段、复选框字段或单选按钮字段关联的小部件。 对于其他类型的字段，这将无用。

返回
  普通标题字符串。 空字符串可能表示 MK 字典中没有普通标题。在这种情况下，请使用值 Annot::e_MKEntryNormalCaption 调用函数 Widget::HasMKEntry 进行检查。

## ◆ GetMKNormalIconBitmap()

common::Bitmap foxit::pdf::annots::Widget::GetMKNormalIconBitmap | ( |  | ) |

获取 MK 字典中的普通图标位图。

MK 字典是一个外观特性字典，用于构建动态外观流， 指定注释在页面上的视觉呈现。 MK 字典中的普通图标用于在小部件不与用户交互时显示。 这适用于与按钮字段关联的小部件。对于其他类型的字段，这将无用。

返回
  普通图标位图。如果返回的位图对象的函数 common::Bitmap::IsEmpty 返回 true， 那意味着当前小部件注释没有普通图标位图。

## ◆ GetMKRolloverCaption()

WString foxit::pdf::annots::Widget::GetMKRolloverCaption | ( |  | ) | const

获取 MK 字典中的翻转标题字符串。

MK 字典是一个外观特性字典，用于构建动态外观流， 指定注释在页面上的视觉呈现。 MK 字典中的翻转标题用于在用户将光标移动到其活动区域内 但不按下鼠标按钮时显示。 这适用于与按钮字段关联的小部件。对于其他类型的字段， 这将无用。

返回
  翻转标题字符串。 空字符串可能表示 MK 字典中没有翻转标题。在这种情况下，请使用值 Annot::e_MKEntryRolloverCaption 调用函数 Widget::HasMKEntry 进行检查。

## ◆ GetMKRolloverIconBitmap()

common::Bitmap foxit::pdf::annots::Widget::GetMKRolloverIconBitmap | ( |  | ) |

获取 MK 字典中的翻转图标位图。

MK 字典是一个外观特性字典，用于构建动态外观流， 指定注释在页面上的视觉呈现。 MK 字典中的翻转图标用于在用户将光标移动到其活动区域内 但不按下鼠标按钮时显示。 这适用于与按钮字段关联的小部件。对于其他类型的字段，这将无用。

返回
  翻转图标位图。如果返回的位图对象的函数 common::Bitmap::IsEmpty 返回 true，那意味着当前小部件注释没有翻转图标位图。

## ◆ GetMKRotation()

common::Rotation foxit::pdf::annots::Widget::GetMKRotation | ( |  | ) | const

获取 MK 字典中的旋转值。

MK 字典是一个外观特性字典，用于构建动态外观流， 指定注释在页面上的视觉呈现。 MK 字典中的旋转指定了小部件注释相对于页面逆时针旋转的度数。

返回
  MK 字典中的旋转值。请参考从 common::e_Rotation0 开始的值， 这将是这些值中的一个。值 common::e_RotationUnknown 表示 MK 字典中没有旋转。 特别地，返回的旋转值表示逆时针方向。

## ◆ HasMKEntry()

bool foxit::pdf::annots::Widget::HasMKEntry | ( | MKEntry | mk_entry | ) |

检查在 MK 字典中是否存在指定的条目。

MK 字典是一个外观特性字典，用于构建动态外观流， 指定注释在页面上的视觉呈现。

参数

  [in] | mk_entry | MK 字典中的一个条目。请参考从 Annot::e_MKEntryRotation 开始的值，这应该是这些值中的一个。

返回
  true 表示指定的条目存在于 MK 字典中，而 false 表示不存在。

## ◆ RemoveAction()

void foxit::pdf::annots::Widget::RemoveAction | ( |  | ) |

移除动作。

此函数不能用于移除用作附加动作的动作。 如果用户想要移除任何附加动作，请参考类 actions::AdditionalAction 了解更多详情。

返回
  无。

## ◆ RemoveMKEntry()

void foxit::pdf::annots::Widget::RemoveMKEntry | ( | MKEntry | mk_entry | ) |

从 MK 字典中移除指定的条目。

MK 字典是一个外观特性字典，用于构建动态外观流， 指定注释在页面上的视觉呈现。

参数

  [in] | mk_entry | MK 字典中的一个条目。请参考从 Annot::e_MKEntryRotation 开始的值，这应该是这些值中的一个。

返回
  无。

## ◆ SetAction()

void foxit::pdf::annots::Widget::SetAction | ( | const actions::Action & | action | ) |

设置动作。

此函数不能用于设置用作附加动作的动作。 如果用户想要设置任何附加动作，请参考类 actions::AdditionalAction 了解更多详情。

参数

  [in] | action | 要设置的新动作。它应该是有效的。 当前仅支持以下类型作为新动作： actions::Action::e_TypeGoto, actions::Action::e_TypeURI, actions::Action::e_TypeJavaScript, actions::Action::e_TypeNamed, actions::Action::e_TypeGoToR, actions::Action::e_TypeGoToE, actions::Action::e_TypeSubmitForm, actions::Action::e_TypeResetForm, actions::Action::e_TypeHide, actions::Action::e_TypeLaunch, actions::Action::e_TypeImportData, actions::Action::e_TypeRendition。

返回
  无。

## ◆ SetAppearanceState()

void foxit::pdf::annots::Widget::SetAppearanceState | ( | const String & | appearance_state | ) |

设置注释的外观状态，从外观子字典中选择适用的外观流。

参数

  [in] | appearance_state | 注释的外观状态。

返回
  无。

## ◆ SetHighlightingMode()

void foxit::pdf::annots::Widget::SetHighlightingMode | ( | HighlightingMode | mode | ) |

设置高亮模式。

高亮模式是当鼠标按钮在其活动区域内按下或保持按下时使用的视觉效果。

参数

  [in] | mode | 新的高亮模式值。请参考从 Annot::e_HighlightingNone 开始的值， 这应该是这些值中的一个。

返回
  无。

## ◆ SetLineSpacing()

void foxit::pdf::annots::Widget::SetLineSpacing | ( | LineSpacingStyle | line_spacing_style,
|  | float | line_spacing_value
| ) |  |

设置当前小部件的行间距。

这仅适用于与包含标志interform::Field::e_FlagTextMultiline的文本字段关联的小部件。 对于其他类型的字段，这将无用。

参数

  [in] | line_spacing_style | 要设置给当前小部件的行间距样式。请参考从Widget::e_LineSpacingSingle开始的值， 这应该是这些值中的一个。
  [in] | line_spacing_value | 当参数line_spacing_style为 Widget::e_LineSpacingExactValue时，要设置给当前小部件的行间距精确值。 当此参数有用时，此参数必须是非负值，单位应为"pt"（称为点）。 如果此值为零，行间距的效果将与单倍行间距相同。

返回
  无。

## ◆ SetMKBackgroundColor()

void foxit::pdf::annots::Widget::SetMKBackgroundColor | ( | RGB | color | ) |

设置 MK 字典中的背景颜色。

MK 字典是一个外观特性字典，用于构建动态外观流， 指定注释在页面上的视觉呈现。

参数

  [in] | color | 要在 MK 字典中设置的背景颜色。值格式：0xRRGGBB。

返回
  无。

## ◆ SetMKBorderColor()

void foxit::pdf::annots::Widget::SetMKBorderColor | ( | RGB | color | ) |

设置 MK 字典中的边框颜色。

MK 字典是一个外观特性字典，用于构建动态外观流， 指定注释在页面上的视觉呈现。

参数

  [in] | color | 要在 MK 字典中设置的边框颜色。值格式：0xRRGGBB。

返回
  无。

## ◆ SetMKDownCaption()

void foxit::pdf::annots::Widget::SetMKDownCaption | ( | const wchar_t * | caption | ) |

设置 MK 字典中的向下标题字符串。

MK 字典是一个外观特性字典，用于构建动态外观流， 指定注释在页面上的视觉呈现。 MK 字典中的向下标题（或备用标题）用于在鼠标按钮在其活动区域内按下时显示。 这适用于与按钮字段关联的小部件。对于其他类型的字段，这将无用。

参数

  [in] | caption | 要在 MK 字典中设置的向下标题字符串。它可以是空字符串。

返回
  无。

## ◆ SetMKDownIconBitmap()

void foxit::pdf::annots::Widget::SetMKDownIconBitmap | ( | const common::Bitmap & | bitmap | ) |

设置MK字典中的按下图标位图。

MK字典是一个外观特性字典，用于构建动态外观流， 指定注释在页面上的视觉呈现。 MK字典中的按下图标（或备用图标）用于在鼠标按钮在其活动区域内 按下时显示。这适用于与按钮字段关联的小部件。 对于其他类型的字段，这将无用。

参数

  [in] | bitmap | 要设置为MK字典中按下图标的有效位图。

返回
  无。

## ◆ SetMKDownIconImage()

void foxit::pdf::annots::Widget::SetMKDownIconImage | ( | const common::Image & | image,
|  | int | frame_index
| ) |  |

设置指定帧索引的图像作为MK字典中的按下图标。

MK字典是一个外观特性字典，用于构建动态外观流， 指定注释在页面上的视觉呈现。 MK字典中的按下图标（或备用图标）用于在鼠标按钮在其活动区域内 按下时显示。这适用于与按钮字段关联的小部件。 对于其他类型的字段，这将无用。

参数

  [in] | image | 图像。其中一帧将被设置为MK字典中的按下图标。 此图像应包含至少一帧，图像类型不应为 common::Image::e_Unknown。
  [in] | frame_index | 帧索引。有效范围：从0到(count-1)。 count由函数common::Image::GetFrameCount返回。

## ◆ SetMKIconCaptionRelation()

void foxit::pdf::annots::Widget::SetMKIconCaptionRelation | ( | MKIconCaptionRelation | relation | ) |

设置MK字典中图标和标题的关系。

MK字典是一个外观特性字典，用于构建动态外观流， 指定注释在页面上的视觉呈现。 标题和图标的关系位置指定小部件注释标题文本相对于其图标的位置。 这适用于与按钮字段关联的小部件。对于其他类型的字段， 这将无用。

参数

  [in] | relation | 标题和图标的关系位置。请参考从 Annot::e_MKRelationNoIcon开始的值，这应该是这些值中的一个。

返回
  无。

## ◆ SetMKIconFit()

void foxit::pdf::annots::Widget::SetMKIconFit | ( | const IconFit & | icon_fit | ) |

设置MK字典中的图标适合信息。

MK字典是一个外观特性字典，用于构建动态外观流， 指定注释在页面上的视觉呈现。 图标适合信息指定如何在注释矩形内显示小部件注释的图标。 如果存在，图标适合信息适用于注释的所有图标。 这适用于与按钮字段关联的小部件。对于其他类型的字段， 这将无用。

参数

  [in] | icon_fit | 表示要在MK字典中设置的图标适合信息的图标适合对象。 如果此对象中任何成员的值无效，此函数将抛出异常 foxit::e_ErrParam。 请参考类IconFit检查每个成员的有效值范围。

返回
  无。

## ◆ SetMKNormalCaption()

void foxit::pdf::annots::Widget::SetMKNormalCaption | ( | const wchar_t * | caption | ) |

设置 MK 字典中的普通标题字符串。

MK 字典是一个外观特性字典，用于构建动态外观流， 指定注释在页面上的视觉呈现。 MK 字典中的普通标题用于在小部件不与用户交互时显示。 这适用于与按钮字段、复选框字段或单选按钮字段关联的小部件。 对于其他类型的字段，这将无用。

参数

  [in] | caption | 要在 MK 字典中设置的普通标题字符串。它可以是空字符串。

返回
  无。

## ◆ SetMKNormalIconBitmap()

void foxit::pdf::annots::Widget::SetMKNormalIconBitmap | ( | const common::Bitmap & | bitmap | ) |

设置一个位图作为 MK 字典中的普通图标。

MK 字典是一个外观特性字典，用于构建动态外观流， 指定注释在页面上的视觉呈现。 MK 字典中的普通图标用于在小部件不与用户交互时显示。 这适用于与按钮字段关联的小部件。对于其他类型的字段，这将无用。

参数

  [in] | bitmap | 要在 MK 字典中设置为普通图标的有效位图。

返回
  无。

## ◆ SetMKNormalIconImage()

void foxit::pdf::annots::Widget::SetMKNormalIconImage | ( | const common::Image & | image,
|  | int | frame_index
| ) |  |

设置指定帧索引的图像作为 MK 字典中的普通图标。

MK 字典是一个外观特性字典，用于构建动态外观流， 指定注释在页面上的视觉呈现。 MK 字典中的普通图标用于在小部件不与用户交互时显示。 这适用于与按钮字段关联的小部件。对于其他类型的字段，这将无用。

参数

  [in] | image | 图像。其中一帧将被设置为 MK 字典中的普通图标。 此图像应包含至少一帧，且图像类型不应为 common::Image::e_Unknown。
  [in] | frame_index | 帧索引。有效范围：从 0 到（count-1）。 count 由函数 common::Image::GetFrameCount 返回。

## ◆ SetMKRolloverCaption()

void foxit::pdf::annots::Widget::SetMKRolloverCaption | ( | const wchar_t * | caption | ) |

设置 MK 字典中的翻转标题字符串。

MK 字典是一个外观特性字典，用于构建动态外观流， 指定注释在页面上的视觉呈现。 MK 字典中的翻转标题用于在用户将光标移动到其活动区域内 但不按下鼠标按钮时显示。 这适用于与按钮字段关联的小部件。对于其他类型的字段， 这将无用。

参数

  [in] | caption | 要在 MK 字典中设置的翻转标题字符串。它可以是空字符串。

返回
  无。

## ◆ SetMKRolloverIconBitmap()

void foxit::pdf::annots::Widget::SetMKRolloverIconBitmap | ( | const common::Bitmap & | bitmap | ) |

设置MK字典中的翻转图标位图。

MK字典是一个外观特性字典，用于构建动态外观流， 指定注释在页面上的视觉呈现。 MK字典中的翻转图标用于在用户将光标移动到其活动区域内 但不按下鼠标按钮时显示。 这适用于与按钮字段关联的小部件。对于其他类型的字段，这将无用。

参数

  [in] | bitmap | 要设置为MK字典中翻转图标的有效位图。

返回
  无。

## ◆ SetMKRolloverIconImage()

void foxit::pdf::annots::Widget::SetMKRolloverIconImage | ( | const common::Image & | image,
|  | int | frame_index
| ) |  |

设置指定帧索引的图像作为MK字典中的翻转图标。

MK字典是一个外观特性字典，用于构建动态外观流， 指定注释在页面上的视觉呈现。 MK字典中的翻转图标用于在用户将光标移动到其活动区域内 但不按下鼠标按钮时显示。 这适用于与按钮字段关联的小部件。对于其他类型的字段，这将无用。

参数

  [in] | image | 图像。其中一帧将被设置为MK字典中的翻转图标。 此图像应包含至少一帧，图像类型不应为 common::Image::e_Unknown。
  [in] | frame_index | 帧索引。有效范围：从0到(count-1)。 count由函数common::Image::GetFrameCount返回。

## ◆ SetMKRotation()

void foxit::pdf::annots::Widget::SetMKRotation | ( | common::Rotation | rotation | ) |

设置 MK 字典中的旋转值。

MK 字典是一个外观特性字典，用于构建动态外观流， 指定注释在页面上的视觉呈现。 MK 字典中的旋转指定了小部件注释相对于页面逆时针旋转的度数。

参数

  [in] | rotation | 要在 MK 字典中设置的旋转值。请参考从 common::e_Rotation0 开始的值，这应该是这些值中的一个，除了 common::e_RotationUnknown。特别地，这里的旋转值表示逆时针方向。