类 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 (const PDFPage &page, objects::PDFDictionary *annot_dict)
	构造函数，使用PDF页面和注释的PDF字典。更多...

	Annot (const Annot &annot)
	构造函数，使用另一个注释对象。更多...

	Annot ()
	构造函数。

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。特别地，这里的旋转值表示逆时针方向。

Public 类型

Public 成员函数

详细描述

成员枚举类型说明

◆ LineSpacingStyle

构造及析构函数说明

◆ Widget()

成员函数说明

◆ GetAction()

◆ GetAppearanceOnStateName()

◆ GetAppearanceState()

◆ GetControl()

◆ GetField()

◆ GetHighlightingMode()

◆ GetLineSpacing()

◆ GetMKBackgroundColor()

◆ GetMKBorderColor()

◆ GetMKDownCaption()

◆ GetMKDownIconBitmap()

◆ GetMKIconCaptionRelation()

◆ GetMKIconFit()

◆ GetMKNormalCaption()

◆ GetMKNormalIconBitmap()

◆ GetMKRolloverCaption()

◆ GetMKRolloverIconBitmap()

◆ GetMKRotation()

◆ HasMKEntry()

◆ RemoveAction()

◆ RemoveMKEntry()

◆ SetAction()

◆ SetAppearanceState()

◆ SetHighlightingMode()

◆ SetLineSpacing()

◆ SetMKBackgroundColor()

◆ SetMKBorderColor()

◆ SetMKDownCaption()

◆ SetMKDownIconBitmap()

◆ SetMKDownIconImage()

◆ SetMKIconCaptionRelation()

◆ SetMKIconFit()

◆ SetMKNormalCaption()

◆ SetMKNormalIconBitmap()

◆ SetMKNormalIconImage()

◆ SetMKRolloverCaption()

◆ SetMKRolloverIconBitmap()

◆ SetMKRolloverIconImage()

◆ SetMKRotation()