HPS::Publish::DropDownListKit
-
class HPS::Publish::DropDownListKit : public HPS::SprocketKit
The DropDownListKit class is a user space object. It acts as the container for all data that can be used to specify a drop down list for a Publish PDF.
Public Functions
-
DropDownListKit()
The default constructor creates an empty DropDownListKit object.
-
DropDownListKit(DropDownListKit &&in_kit)
The move constructor creates a DropDownListKit by transferring the underlying object of the rvalue reference to this DropDownListKit.
- Parameters
in_kit – An rvalue reference to a DropDownListKit to take the underlying object from.
-
DropDownListKit(DropDownListKit const &in_kit)
The copy constructor creates a new DropDownListKit object that contains the same settings as the source DropDownListKit.
- Parameters
in_kit – The source DropDownListKit to copy.
-
virtual bool Empty() const
Indicates whether this DropDownListKit has any values set on it.
- Returns
true if no values are set on this DropDownListKit, false otherwise.
-
bool Equals(DropDownListKit const &in_kit) const
Check if the source DropDownListKit is equivalent to this DropDownListKit.
- Parameters
in_kit – The source DropDownListKit to compare to this DropDownListKit.
- Returns
true if the objects are equivalent, false otherwise.
-
inline virtual HPS::Type ObjectType() const
This function returns the type the object, as declared (if the object is derived, this does not give the true type of the derived object).
- Returns
The declared type of the object in question, which may differ from the true, underlying type.
-
bool operator!=(DropDownListKit const &in_kit) const
Check if the source DropDownListKit is not equivalent to this DropDownListKit.
- Parameters
in_kit – The source DropDownListKit to compare to this DropDownListKit.
- Returns
true if the objects are not equivalent, false otherwise.
-
DropDownListKit &operator=(DropDownListKit &&in_kit)
The move assignment operator transfers the underlying object of the rvalue reference to this DropDownListKit.
- Parameters
in_kit – An rvalue reference to a DropDownListKit to take the underlying object from.
- Returns
A reference to this DropDownListKit.
-
DropDownListKit &operator=(DropDownListKit const &in_kit)
Copies the source DropDownListKit into this DropDownListKit.
- Parameters
in_kit – The source DropDownListKit to copy.
- Returns
A reference to this DropDownListKit.
-
bool operator==(DropDownListKit const &in_kit) const
Check if the source DropDownListKit is equivalent to this DropDownListKit.
- Parameters
in_kit – The source DropDownListKit to compare to this DropDownListKit.
- Returns
true if the objects are equivalent, false otherwise.
-
void Set(DropDownListKit const &in_kit)
Copies the source DropDownListKit into this DropDownListKit.
- Parameters
in_kit – The source DropDownListKit to copy.
-
DropDownListKit &SetBorder(bool in_state)
Sets whether the drop down list has a border. This corresponds to the value that will be passed to A3DPDFDropDownListData::m_bHasBorder.
- Parameters
in_state – Whether the drop down list has a border.
- Returns
A reference to this DropDownListKit.
-
DropDownListKit &SetBorderColor(RGBColor const &in_color)
Sets the border color for the drop down list. This corresponds to the value that will be passed to A3DPDFDropDownListData::m_sBorderColor.
- Parameters
in_color – The border color of the drop down list.
- Returns
A reference to this DropDownListKit.
-
DropDownListKit &SetBorderStyle(Border::Style in_style)
Sets the border style for the drop down list. This corresponds to the value that will be passed to A3DPDFDropDownListData::m_eLineStyleBorder.
- Parameters
in_style – The border style for the drop down list.
- Returns
A reference to this DropDownListKit.
-
DropDownListKit &SetBorderThickness(Border::Thickness in_thickness)
Sets the border thickness for the drop down list. This corresponds to the value that will be passed to A3DPDFDropDownListData::m_eThicknessBorder.
- Parameters
in_thickness – The border thickness for the drop down list.
- Returns
A reference to this DropDownListKit.
-
DropDownListKit &SetContents(size_t in_count, UTF8 const in_displayed_values[], UTF8 const in_export_values[])
Sets the contents of the drop down list. This corresponds to the value that will be passed to A3DPDFPageFieldListAddItem.
- Parameters
in_count – The size of the arrays passed in.
in_displayed_values – The values displayed in the drop down list
in_export_values – The export values associated with the values displayed
- Returns
A reference to this DropDownListKit.
-
DropDownListKit &SetContents(UTF8Array const &in_displayed_values, UTF8Array const &in_export_values)
Sets the contents of the drop down list. This corresponds to the value that will be passed to A3DPDFPageFieldListAddItem. The two arrays need to have the same size.
- Parameters
in_displayed_values – The values displayed in the drop down list
in_export_values – The export values associated with the values displayed
- Returns
A reference to this DropDownListKit.
-
DropDownListKit &SetCustomText(bool in_state)
Sets whether the user can enter custom text. This corresponds to the value that will be passed to A3DPDFDropDownListData::m_bAllowUserToEnterCustomText.
- Parameters
in_state – Whether the user can enter custom text.
- Returns
A reference to this DropDownListKit.
-
DropDownListKit &SetFillColor(RGBColor const &in_color)
Sets the fill color for the drop down list. This corresponds to the value that will be passed to A3DPDFDropDownListData::m_sFillColor and implicitly sets A3DPDFDropDownListData::m_bHasFillColor to true.
- Parameters
in_color – The fill color for the drop down list.
- Returns
A reference to this DropDownListKit.
-
DropDownListKit &SetFont(char const *in_name, Text::Font::Style in_style = Text::Font::Style::Regular)
Sets a specific font for the drop down list. This corresponds to the value that will be passed to A3DPDFDropDownListData::m_pcFontName.
- Parameters
in_name – UTF8-encoded font name for the drop down list.
in_style – The style of font to use for the drop down list.
- Returns
A reference to this DropDownListKit.
-
DropDownListKit &SetFont(Text::Font::Name in_name)
Sets a builtin font for the drop down list. This corresponds to the value that will be passed to A3DPDFDropDownListData::m_pcFontName.
- Parameters
in_name – The builtin font for the drop down list.
- Returns
A reference to this DropDownListKit.
-
DropDownListKit &SetFontSize(int in_size)
Sets the font size for the drop down list. This corresponds to the value that will be passed to A3DPDFDropDownListData::m_iFontSize.
- Parameters
in_size – The font size for the drop down list.
- Returns
A reference to this DropDownListKit.
-
DropDownListKit &SetImmediateCommit(bool in_state)
Sets whether selected values are committed immediately. This corresponds to the value that will be passed to A3DPDFDropDownListData::m_bCommitImmediate.
- Parameters
in_state – Whether selected values are committed immediately.
- Returns
A reference to this DropDownListKit.
-
DropDownListKit &SetLock(bool in_state)
Sets whether the drop down list is locked. This corresponds to the value that will be passed to A3DPDFDropDownListData::m_bIsLocked.
- Parameters
in_state – Whether the drop down list is locked.
- Returns
A reference to this DropDownListKit.
-
DropDownListKit &SetName(char const *in_name)
Sets the name of the drop down list. This corresponds to the value that will be passed to A3DPDFDropDownListData::m_pcName.
- Parameters
in_name – UTF8-encoded name of the drop down list.
- Returns
A reference to this DropDownListKit.
-
DropDownListKit &SetPrintability(bool in_state)
Sets the printability for the drop down list. This corresponds to the value that will be passed to A3DPDFDropDownListData::m_eFormField.
- Parameters
in_state – The printability for the drop down list.
- Returns
A reference to this DropDownListKit.
-
DropDownListKit &SetSpellChecking(bool in_state)
Sets whether spell checking is enabled. This corresponds to the value that will be passed to A3DPDFDropDownListData::m_bCheckSpelling.
- Parameters
in_state – Whether spell checking is enabled.
- Returns
A reference to this DropDownListKit.
-
DropDownListKit &SetTextColor(RGBColor const &in_color)
Sets the text color for the drop down list. This corresponds to the value that will be passed to A3DPDFDropDownListData::m_sTextColor.
- Parameters
in_color – The text color for the drop down list.
- Returns
A reference to this DropDownListKit.
-
DropDownListKit &SetTextRotation(Text::Rotation in_rotation)
Sets the text rotation for the drop down list. This corresponds to the value that will be passed to A3DPDFDropDownListData::m_eTextOrientation.
- Parameters
in_rotation – The text rotation for the drop down list.
- Returns
A reference to this DropDownListKit.
-
DropDownListKit &SetTooltip(char const *in_tooltip)
Sets the tooltip for the drop down list. This corresponds to the value that will be passed to A3DPDFDropDownListData::m_pcTooltip.
- Parameters
in_tooltip – UTF8-encoded tooltip text for the drop down list.
- Returns
A reference to this DropDownListKit.
-
DropDownListKit &SetVisibility(bool in_state)
Sets the visibility for the drop down list. This corresponds to the value that will be passed to A3DPDFDropDownListData::m_eFormField.
- Parameters
in_state – The visibility for the drop down list.
- Returns
A reference to this DropDownListKit.
-
void Show(DropDownListKit &out_kit) const
Copies this DropDownListKit into the given DropDownListKit.
- Parameters
out_kit – The DropDownListKit to populate with the contents of this DropDownListKit.
-
bool ShowBorder(bool &out_state) const
Shows the border setting for the drop down list.
- Parameters
out_state – Whether the drop down list has a border.
- Returns
true if a border setting was specified, false otherwise.
-
bool ShowBorderColor(RGBColor &out_color) const
Shows the border color for the drop down list.
- Parameters
out_color – The border color of the drop down list.
- Returns
true if a border color was specified, false otherwise.
-
bool ShowBorderStyle(Border::Style &out_style) const
Shows the border style for the drop down list.
- Parameters
out_style – The border style for the drop down list.
- Returns
true if a border style was specified, false otherwise.
-
bool ShowBorderThickness(Border::Thickness &out_thickness) const
Shows the border thickness for the drop down list.
- Parameters
out_thickness – The border thickness for the drop down list.
- Returns
true if a border thickness was specified, false otherwise.
-
bool ShowContents(UTF8Array &out_displayed_values, UTF8Array &out_export_values) const
Shows the content setting for the drop down list
- Parameters
out_displayed_values – The values displayed by the drop down list
out_export_values – The export values associated with the displayed values.
- Returns
true if a content setting was specified, false otherwise.
-
bool ShowCustomText(bool &out_state) const
Shows the custom text setting for the drop down list.
- Parameters
out_state – Whether the user can enter custom text.
- Returns
true if a custom text setting was specified, false otherwise.
-
bool ShowFillColor(RGBColor &out_color) const
Shows the fill color for the drop down list.
- Parameters
out_color – The fill color for the drop down list.
- Returns
true if a fill color was specified, false otherwise.
-
bool ShowFont(Text::Font::Type &out_type, Text::Font::Name &out_font, UTF8 &out_font_name, Text::Font::Style &out_style) const
Shows the font for the drop down list.
- Parameters
out_type – The type of font for the drop down list.
out_font – The built-in font for the drop down list. This is only valid if out_type is Text::Font::Type::BuiltIn.
out_font_name – The explicit font name for the drop down list. This is only valid if out_type is Text::Font::Type::Explicit.
out_style – The font style for the drop down list. This is only valid if out_type is Text::Font::Type::Explicit.
- Returns
true if a font was specified, false otherwise.
-
bool ShowFontSize(int &out_size) const
Shows the font size for the drop down list.
- Parameters
out_size – The font size for the drop down list.
- Returns
true if a font size was specified, false otherwise.
-
bool ShowImmediateCommit(bool &out_state) const
Shows the immediate commit setting for the drop down list.
- Parameters
out_state – Whether selected values are committed immediately.
- Returns
true if an immediate commit setting was specified, false otherwise.
-
bool ShowLock(bool &out_state) const
Shows the lock setting for the drop down list.
- Parameters
in_state – Whether the drop down list is locked.
- Returns
true if a lock setting was specified, false otherwise.
-
bool ShowName(UTF8 &out_name) const
Shows the name for the drop down list.
- Parameters
out_name – The name of the drop down list.
- Returns
true if a name was specified, false otherwise.
-
bool ShowPrintability(bool &out_state) const
Shows the printability for the drop down list.
- Parameters
out_state – The printability for the drop down list.
- Returns
true if a printability was specified, false otherwise.
-
bool ShowSpellChecking(bool &out_state) const
Shows the spell checking setting for the drop down list.
- Parameters
out_state – Whether spell checking is enabled.
- Returns
true if a spell checking setting was specified, false otherwise.
-
bool ShowTextColor(RGBColor &out_color) const
Shows the text color for the drop down list.
- Parameters
out_color – The text color for the drop down list.
- Returns
true if a text color was specified, false otherwise.
-
bool ShowTextRotation(Text::Rotation &out_rotation) const
Shows the text rotation for the drop down list.
- Parameters
out_rotation – The text rotation for the drop down list.
- Returns
true if a rotation was specified, false otherwise.
-
bool ShowTooltip(UTF8 &out_tooltip) const
Shows the tooltip for the drop down list.
- Parameters
out_tooltip – The tooltip text for the drop down list.
- Returns
true if a tooltip was specified, false otherwise.
-
bool ShowVisibility(bool &out_state) const
Shows the visibility for the drop down list.
- Parameters
out_state – The visibility for the drop down list.
- Returns
true if a visibility was specified, false otherwise.
-
DropDownListKit &UnsetBorder()
Removes the border setting.
- Returns
A reference to this DropDownListKit.
-
DropDownListKit &UnsetBorderColor()
Removes the border color setting.
- Returns
A reference to this DropDownListKit.
-
DropDownListKit &UnsetBorderStyle()
Removes the border style setting.
- Returns
A reference to this DropDownListKit.
-
DropDownListKit &UnsetBorderThickness()
Removes the border thickness setting.
- Returns
A reference to this DropDownListKit.
-
DropDownListKit &UnsetContents()
Removes the content setting.
- Returns
A reference to this DropDownListKit.
-
DropDownListKit &UnsetCustomText()
Removes the custom text setting.
- Returns
A reference to this DropDownListKit.
-
DropDownListKit &UnsetEverything()
Removes all data from the drop down list.
- Returns
A reference to this DropDownListKit.
-
DropDownListKit &UnsetFillColor()
Removes the fill color setting.
- Returns
A reference to this DropDownListKit.
-
DropDownListKit &UnsetFont()
Removes the font setting.
- Returns
A reference to this DropDownListKit.
-
DropDownListKit &UnsetFontSize()
Removes the font size setting.
- Returns
A reference to this DropDownListKit.
-
DropDownListKit &UnsetImmediateCommit()
Removes the immediate commit setting.
- Returns
A reference to this DropDownListKit.
-
DropDownListKit &UnsetLock()
Removes the lock setting.
- Returns
A reference to this DropDownListKit.
-
DropDownListKit &UnsetName()
Removes the name setting.
- Returns
A reference to this DropDownListKit.
-
DropDownListKit &UnsetPrintability()
Removes the printability setting.
- Returns
A reference to this DropDownListKit.
-
DropDownListKit &UnsetSpellChecking()
Removes the spell checking setting.
- Returns
A reference to this DropDownListKit.
-
DropDownListKit &UnsetTextColor()
Removes the text color setting.
- Returns
A reference to this DropDownListKit.
-
DropDownListKit &UnsetTextRotation()
Removes the text rotation setting.
- Returns
A reference to this DropDownListKit.
-
DropDownListKit &UnsetTooltip()
Removes the tooltip setting.
- Returns
A reference to this DropDownListKit.
-
DropDownListKit &UnsetVisibility()
Removes the visibility setting.
- Returns
A reference to this DropDownListKit.
-
virtual ~DropDownListKit()
Public Static Functions
-
static DropDownListKit GetDefault()
Creates a DropDownListKit which contains the default settings. The returned object will not necessarily have values for every setting, but it will have them where it is reasonable to have a default. These values will be used for a button unless a setting is overridden by the DropDownListKit passed to a function.
- Returns
A DropDownListKit with the default settings.
Public Static Attributes
-
static const HPS::Type staticType = HPS::Type::PublishDropDownListKit
-
DropDownListKit()