#include <sprk_publish.h>
Static Public Member Functions | |
static TextFieldKit | GetDefault () |
![]() | |
template<typename T > | |
static intptr_t | ClassID () |
Additional Inherited Members | |
![]() | |
enum | UpdateType { Synchronous, Asynchronous } |
The TextFieldKit class is a user space object. It acts as the container for all data that can be used to specify a text field for a Publish PDF.
HPS::Publish::TextFieldKit::TextFieldKit | ( | ) |
The default constructor creates an empty TextFieldKit object.
HPS::Publish::TextFieldKit::TextFieldKit | ( | TextFieldKit const & | in_kit | ) |
The copy constructor creates a new TextFieldKit object that contains the same settings as the source TextFieldKit.
in_kit | The source TextFieldKit to copy. |
HPS::Publish::TextFieldKit::TextFieldKit | ( | TextFieldKit && | in_kit | ) |
The move constructor creates a TextFieldKit by transferring the underlying object of the rvalue reference to this TextFieldKit.
in_kit | An rvalue reference to a TextFieldKit to take the underlying object from. |
|
virtual |
Indicates whether this TextFieldKit has any values set on it.
Reimplemented from HPS::Object.
bool HPS::Publish::TextFieldKit::Equals | ( | TextFieldKit const & | in_kit | ) | const |
Check if the source TextFieldKit is equivalent to this TextFieldKit.
in_kit | The source TextFieldKit to compare to this TextFieldKit. |
|
static |
Creates a TextFieldKit 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 text field unless a setting is overridden by the TextFieldKit passed to a function.
|
inlinevirtual |
This function returns the type the object, as declared. This does not necessarily give the true type of the underlying object.
Reimplemented from HPS::Object.
bool HPS::Publish::TextFieldKit::operator!= | ( | TextFieldKit const & | in_kit | ) | const |
Check if the source TextFieldKit is not equivalent to this TextFieldKit.
in_kit | The source TextFieldKit to compare to this TextFieldKit. |
TextFieldKit& HPS::Publish::TextFieldKit::operator= | ( | TextFieldKit const & | in_kit | ) |
Copies the source TextFieldKit into this TextFieldKit.
in_kit | The source TextFieldKit to copy. |
TextFieldKit& HPS::Publish::TextFieldKit::operator= | ( | TextFieldKit && | in_kit | ) |
The move assignment operator transfers the underlying object of the rvalue reference to this TextFieldKit.
in_kit | An rvalue reference to a TextFieldKit to take the underlying object from. |
bool HPS::Publish::TextFieldKit::operator== | ( | TextFieldKit const & | in_kit | ) | const |
Check if the source TextFieldKit is equivalent to this TextFieldKit.
in_kit | The source TextFieldKit to compare to this TextFieldKit. |
void HPS::Publish::TextFieldKit::Set | ( | TextFieldKit const & | in_kit | ) |
Copies the source TextFieldKit into this TextFieldKit.
in_kit | The source TextFieldKit to copy. |
TextFieldKit& HPS::Publish::TextFieldKit::SetBorder | ( | bool | in_state | ) |
Sets whether the text field has a border. This corresponds to the value that will be passed to A3DPDFTextFieldData::m_bHasBorder.
in_state | Whether the text field has a border. |
TextFieldKit& HPS::Publish::TextFieldKit::SetBorderColor | ( | RGBColor const & | in_color | ) |
Sets the border color for the text field. This corresponds to the value that will be passed to A3DPDFTextFieldData::m_sBorderColor.
in_color | The border color of the text field. |
TextFieldKit& HPS::Publish::TextFieldKit::SetBorderStyle | ( | Border::Style | in_style | ) |
Sets the border style for the text field. This corresponds to the value that will be passed to A3DPDFTextFieldData::m_eLineStyleBorder.
in_style | The border style for the text field. |
TextFieldKit& HPS::Publish::TextFieldKit::SetBorderThickness | ( | Border::Thickness | in_thickness | ) |
Sets the border thickness for the text field. This corresponds to the value that will be passed to A3DPDFTextFieldData::m_eThicknessBorder.
in_thickness | The border thickness for the text field. |
TextFieldKit& HPS::Publish::TextFieldKit::SetDefaultValue | ( | char const * | in_value | ) |
Sets the default value for the text field. This corresponds to the value that will be passed to A3DPDFTextFieldData::m_pcDefaultValue.
in_value | UT8-encoded default value for the text field. |
TextFieldKit& HPS::Publish::TextFieldKit::SetFillColor | ( | RGBColor const & | in_color | ) |
Sets the fill color for the text field. This corresponds to the value that will be passed to A3DPDFTextFieldData::m_sFillColor and implicitly sets A3DPDFTextFieldData::m_bHasFillColor to true.
in_color | The fill color for the text field. |
TextFieldKit& HPS::Publish::TextFieldKit::SetFont | ( | Text::Font::Name | in_name | ) |
Sets a builtin font for the text field. This corresponds to the value that will be passed to A3DPDFTextFieldData::m_pcFontName.
in_name | The builtin font for the text field. |
TextFieldKit& HPS::Publish::TextFieldKit::SetFont | ( | char const * | in_name, |
Text::Font::Style | in_style = Text::Font::Style::Regular |
||
) |
Sets a specific font for the text field. This corresponds to the value that will be passed to A3DPDFTextFieldData::m_pcFontName.
in_name | UTF8-encoded font name for the text field. |
in_style | The style of font to use for the text field. |
TextFieldKit& HPS::Publish::TextFieldKit::SetFontSize | ( | int | in_size | ) |
Sets the font size for the text field. This corresponds to the value that will be passed to A3DPDFTextFieldData::m_iFontSize.
in_size | The font size for the text field. |
TextFieldKit& HPS::Publish::TextFieldKit::SetLock | ( | bool | in_state | ) |
Sets whether the text field is locked. This corresponds to the value that will be passed to A3DPDFTextFieldData::m_bIsLocked.
in_state | Whether the text field is locked. |
TextFieldKit& HPS::Publish::TextFieldKit::SetMultiline | ( | bool | in_state | ) |
Sets whether the text field is multiline. This corresponds to the value that will be passed to A3DPDFTextFieldData::m_bMultiline.
in_state | Whether the text field is multiline. |
TextFieldKit& HPS::Publish::TextFieldKit::SetName | ( | char const * | in_name | ) |
Sets the name of the text field. This corresponds to the value that will be passed to A3DPDFTextFieldData::m_pcName.
in_name | UTF8-encoded name of the text field. |
TextFieldKit& HPS::Publish::TextFieldKit::SetPrintability | ( | bool | in_state | ) |
Sets the printability for the text field. This corresponds to the value that will be passed to A3DPDFTextFieldData::m_eFormField.
in_state | The printability for the text field. |
TextFieldKit& HPS::Publish::TextFieldKit::SetReadOnly | ( | bool | in_state | ) |
Sets whether the text field is read only. This corresponds to the value that will be passed to A3DPDFTextFieldData::m_bReadOnly.
in_state | Whether the text field can scroll. |
TextFieldKit& HPS::Publish::TextFieldKit::SetScrolling | ( | bool | in_state | ) |
Sets whether the text field can scroll. This corresponds to the (inverted) value that will be passed to A3DPDFTextFieldData::m_bDoNotScroll.
in_state | Whether the text field can scroll. |
TextFieldKit& HPS::Publish::TextFieldKit::SetTextColor | ( | RGBColor const & | in_color | ) |
Sets the text color for the text field. This corresponds to the value that will be passed to A3DPDFTextFieldData::m_sTextColor.
in_color | The text color for the text field. |
TextFieldKit& HPS::Publish::TextFieldKit::SetTextJustification | ( | HPS::Text::Justification | in_justification | ) |
Sets the text justification for the text field. This corresponds to the value that will be passed to A3DPDFTextFieldData::m_eTextAlignment.
in_justification | The text justification for the text field. |
TextFieldKit& HPS::Publish::TextFieldKit::SetTextRotation | ( | Text::Rotation | in_rotation | ) |
Sets the text rotation for the text field. This corresponds to the value that will be passed to A3DPDFTextFieldData::m_eTextOrientation.
in_rotation | The text rotation for the text field. |
TextFieldKit& HPS::Publish::TextFieldKit::SetTooltip | ( | char const * | in_tooltip | ) |
Sets the tooltip for the text field. This corresponds to the value that will be passed to A3DPDFTextFieldData::m_pcTooltip.
in_tooltip | UTF8-encoded tooltip text for the text field. |
TextFieldKit& HPS::Publish::TextFieldKit::SetVisibility | ( | bool | in_state | ) |
Sets the visibility for the text field. This corresponds to the value that will be passed to A3DPDFTextFieldData::m_eFormField.
in_state | The visibility for the text field. |
void HPS::Publish::TextFieldKit::Show | ( | TextFieldKit & | out_kit | ) | const |
Copies this TextFieldKit into the given TextFieldKit.
out_kit | The TextFieldKit to populate with the contents of this TextFieldKit. |
bool HPS::Publish::TextFieldKit::ShowBorder | ( | bool & | out_state | ) | const |
Shows the border setting for the text field.
out_state | Whether the text field has a border. |
bool HPS::Publish::TextFieldKit::ShowBorderColor | ( | RGBColor & | out_color | ) | const |
Shows the border color for the text field.
out_color | The border color of the text field. |
bool HPS::Publish::TextFieldKit::ShowBorderStyle | ( | Border::Style & | out_style | ) | const |
Shows the border style for the text field.
out_style | The border style for the text field. |
bool HPS::Publish::TextFieldKit::ShowBorderThickness | ( | Border::Thickness & | out_thickness | ) | const |
Shows the border thickness for the text field.
out_thickness | The border thickness for the text field. |
bool HPS::Publish::TextFieldKit::ShowDefaultValue | ( | UTF8 & | out_value | ) | const |
Shows the default value for the text field.
out_value | The default value for the text field. |
bool HPS::Publish::TextFieldKit::ShowFillColor | ( | RGBColor & | out_color | ) | const |
Shows the fill color for the text field.
out_color | The fill color for the text field. |
bool HPS::Publish::TextFieldKit::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 text field.
out_type | The type of font for the text field. |
out_font | The built-in font for the text field. This is only valid if out_type is Text::Font::Type::BuiltIn. |
out_font_name | The explicit font name for the text field. This is only valid if out_type is Text::Font::Type::Explicit. |
out_style | The font style for the text field. This is only valid if out_type is Text::Font::Type::Explicit. |
bool HPS::Publish::TextFieldKit::ShowFontSize | ( | int & | out_size | ) | const |
Shows the font size for the text field.
out_size | The font size for the text field. |
bool HPS::Publish::TextFieldKit::ShowLock | ( | bool & | out_state | ) | const |
Shows the lock setting for the text field.
in_state | Whether the text field is locked. |
bool HPS::Publish::TextFieldKit::ShowMultiline | ( | bool & | out_state | ) | const |
Shows the multiline setting for the text field.
out_state | Whether the text field is multiline. |
bool HPS::Publish::TextFieldKit::ShowName | ( | UTF8 & | out_name | ) | const |
Shows the name for the text field.
out_name | The name of the text field. |
bool HPS::Publish::TextFieldKit::ShowPrintability | ( | bool & | out_state | ) | const |
Shows the printability for the text field.
out_state | The printability for the text field. |
bool HPS::Publish::TextFieldKit::ShowReadOnly | ( | bool & | out_state | ) | const |
Shows the read-only setting for the text field.
out_state | Whether the text field is read only. |
bool HPS::Publish::TextFieldKit::ShowScrolling | ( | bool & | out_state | ) | const |
Shows the scrolling setting for the text field.
out_state | Whether the text field can scroll. |
bool HPS::Publish::TextFieldKit::ShowTextColor | ( | RGBColor & | out_color | ) | const |
Shows the text color for the text field.
out_color | The text color for the text field. |
bool HPS::Publish::TextFieldKit::ShowTextJustification | ( | HPS::Text::Justification & | out_justification | ) | const |
Shows the text justification for the text field.
out_justification | The text justification for the text field. |
bool HPS::Publish::TextFieldKit::ShowTextRotation | ( | Text::Rotation & | out_rotation | ) | const |
Shows the text rotation for the text field.
out_rotation | The text rotation for the text field. |
bool HPS::Publish::TextFieldKit::ShowTooltip | ( | UTF8 & | out_tooltip | ) | const |
Shows the tooltip for the text field.
out_tooltip | The tooltip text for the text field. |
bool HPS::Publish::TextFieldKit::ShowVisibility | ( | bool & | out_state | ) | const |
Shows the visibility for the text field.
out_state | The visibility for the text field. |
TextFieldKit& HPS::Publish::TextFieldKit::UnsetBorder | ( | ) |
Removes the border setting.
TextFieldKit& HPS::Publish::TextFieldKit::UnsetBorderColor | ( | ) |
Removes the border color setting.
TextFieldKit& HPS::Publish::TextFieldKit::UnsetBorderStyle | ( | ) |
Removes the border style setting.
TextFieldKit& HPS::Publish::TextFieldKit::UnsetBorderThickness | ( | ) |
Removes the border thickness setting.
TextFieldKit& HPS::Publish::TextFieldKit::UnsetDefaultValue | ( | ) |
Removes the default value setting.
TextFieldKit& HPS::Publish::TextFieldKit::UnsetEverything | ( | ) |
Removes all data from the text field.
TextFieldKit& HPS::Publish::TextFieldKit::UnsetFillColor | ( | ) |
Removes the fill color setting.
TextFieldKit& HPS::Publish::TextFieldKit::UnsetFont | ( | ) |
Removes the font setting.
TextFieldKit& HPS::Publish::TextFieldKit::UnsetFontSize | ( | ) |
Removes the font size setting.
TextFieldKit& HPS::Publish::TextFieldKit::UnsetLock | ( | ) |
Removes the lock setting.
TextFieldKit& HPS::Publish::TextFieldKit::UnsetMultiline | ( | ) |
Removes the multiline setting.
TextFieldKit& HPS::Publish::TextFieldKit::UnsetName | ( | ) |
Removes the name setting.
TextFieldKit& HPS::Publish::TextFieldKit::UnsetPrintability | ( | ) |
Removes the printability setting.
TextFieldKit& HPS::Publish::TextFieldKit::UnsetReadOnly | ( | ) |
Removes the read-only setting.
TextFieldKit& HPS::Publish::TextFieldKit::UnsetScrolling | ( | ) |
Removes the scrolling setting.
TextFieldKit& HPS::Publish::TextFieldKit::UnsetTextColor | ( | ) |
Removes the text color setting.
TextFieldKit& HPS::Publish::TextFieldKit::UnsetTextJustification | ( | ) |
Removes the text justification setting.
TextFieldKit& HPS::Publish::TextFieldKit::UnsetTextRotation | ( | ) |
Removes the text rotation setting.
TextFieldKit& HPS::Publish::TextFieldKit::UnsetTooltip | ( | ) |
Removes the tooltip setting.
TextFieldKit& HPS::Publish::TextFieldKit::UnsetVisibility | ( | ) |
Removes the visibility setting.