HPS::Publish::SignatureFieldKit

class HPS.Publish.SignatureFieldKit : public HPS.SprocketKit

The SignatureFieldKit class is a user space object. It acts as the container for all data that can be used to specify a signature field for a Publish PDF.

Public Functions

override void Dispose ()
override bool Empty ()

Indicates whether this SignatureFieldKit has any values set on it.

Return

true if no values are set on this SignatureFieldKit, false otherwise.

bool Equals (HPS.Publish.SignatureFieldKit in_kit)

Check if the source SignatureFieldKit is equivalent to this SignatureFieldKit.

Param in_kit

The source SignatureFieldKit to compare to this SignatureFieldKit.

Return

true if the objects are equivalent, false otherwise.

override bool Equals (Object obj)
override int GetHashCode ()
override HPS.Type ObjectType ()

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).

Return

The declared type of the object in question, which may differ from the true, underlying type.

void Set (HPS.Publish.SignatureFieldKit in_kit)

Copies the source SignatureFieldKit into this SignatureFieldKit.

Param in_kit

The source SignatureFieldKit to copy.

HPS.Publish.SignatureFieldKit SetBorder (bool in_state)

Sets whether the signature field has a border. This corresponds to the value that will be passed to A3DPDFDigitalSignatureData::m_bHasBorder.

Param in_state

Whether the signature field has a border.

Return

A reference to this SignatureFieldKit.

HPS.Publish.SignatureFieldKit SetBorderColor (HPS.RGBColor in_color)

Sets the border color for the signature field. This corresponds to the value that will be passed to A3DPDFDigitalSignatureData::m_sBorderColor.

Param in_color

The border color of the signature field.

Return

A reference to this SignatureFieldKit.

HPS.Publish.SignatureFieldKit SetBorderStyle (HPS.Publish.Border.Style in_style)

Sets the border style for the signature field. This corresponds to the value that will be passed to A3DPDFDigitalSignatureData::m_eLineStyleBorder.

Param in_style

The border style for the signature field.

Return

A reference to this SignatureFieldKit.

HPS.Publish.SignatureFieldKit SetBorderThickness (HPS.Publish.Border.Thickness in_thickness)

Sets the border thickness for the signature field. This corresponds to the value that will be passed to A3DPDFDigitalSignatureData::m_eThicknessBorder.

Param in_thickness

The border thickness for the signature field.

Return

A reference to this SignatureFieldKit.

HPS.Publish.SignatureFieldKit SetFillColor (HPS.RGBColor in_color)

Sets the fill color for the signature field. This corresponds to the value that will be passed to A3DPDFDigitalSignatureData::m_sFillColor and implicitly sets A3DPDFDigitalSignatureData::m_bHasFillColor to true.

Param in_color

The fill color for the signature field.

Return

A reference to this SignatureFieldKit.

HPS.Publish.SignatureFieldKit SetFont (HPS.Publish.Text.Font.Name in_name)

Sets a builtin font for the signature field. This corresponds to the value that will be passed to A3DPDFDigitalSignatureData::m_pcFontName.

Param in_name

The builtin font for the signature field.

Return

A reference to this SignatureFieldKit.

HPS.Publish.SignatureFieldKit SetFont (string in_name)

Sets a specific font for the signature field. This corresponds to the value that will be passed to A3DPDFDigitalSignatureData::m_pcFontName.

Param in_name

UTF8-encoded font name for the signature field.

Return

A reference to this SignatureFieldKit.

HPS.Publish.SignatureFieldKit SetFont (string in_name, HPS.Publish.Text.Font.Style in_style)

Sets a specific font for the signature field. This corresponds to the value that will be passed to A3DPDFDigitalSignatureData::m_pcFontName.

Param in_name

UTF8-encoded font name for the signature field.

Param in_style

The style of font to use for the signature field.

Return

A reference to this SignatureFieldKit.

HPS.Publish.SignatureFieldKit SetFontSize (int in_size)

Sets the font size for the signature field. This corresponds to the value that will be passed to A3DPDFDigitalSignatureData::m_iFontSize.

Param in_size

The font size for the signature field.

Return

A reference to this SignatureFieldKit.

HPS.Publish.SignatureFieldKit SetLock (bool in_state)

Sets whether the signature field is locked. This corresponds to the value that will be passed to A3DPDFDigitalSignatureData::m_bIsLocked.

Param in_state

Whether the signature field is locked.

Return

A reference to this SignatureFieldKit.

HPS.Publish.SignatureFieldKit SetName (string in_name)

Sets the name of the signature field. This corresponds to the value that will be passed to A3DPDFDigitalSignatureData::m_pcName.

Param in_name

UTF8-encoded name of the signature field.

Return

A reference to this SignatureFieldKit.

HPS.Publish.SignatureFieldKit SetPrintability (bool in_state)

Sets the printability for the signature field. This corresponds to the value that will be passed to A3DPDFDigitalSignatureData::m_eFormField.

Param in_state

The printability for the signature field.

Return

A reference to this SignatureFieldKit.

HPS.Publish.SignatureFieldKit SetTextColor (HPS.RGBColor in_color)

Sets the text color for the signature field. This corresponds to the value that will be passed to A3DPDFDigitalSignatureData::m_sTextColor.

Param in_color

The text color for the signature field.

Return

A reference to this SignatureFieldKit.

HPS.Publish.SignatureFieldKit SetTextRotation (HPS.Publish.Text.Rotation in_rotation)

Sets the text rotation for the signature field. This corresponds to the value that will be passed to A3DPDFDigitalSignatureData::m_eTextOrientation.

Param in_rotation

The text rotation for the signature field.

Return

A reference to this SignatureFieldKit.

HPS.Publish.SignatureFieldKit SetTooltip (string in_tooltip)

Sets the tooltip for the signature field. This corresponds to the value that will be passed to A3DPDFDigitalSignatureData::m_pcTooltip.

Param in_tooltip

UTF8-encoded tooltip text for the signature field.

Return

A reference to this SignatureFieldKit.

HPS.Publish.SignatureFieldKit SetVisibility (bool in_state)

Sets the visibility for the signature field. This corresponds to the value that will be passed to A3DPDFDigitalSignatureData::m_eFormField.

Param in_state

The visibility for the signature field.

Return

A reference to this SignatureFieldKit.

void Show (out HPS.Publish.SignatureFieldKit out_kit)

Copies this SignatureFieldKit into the given SignatureFieldKit.

Param out_kit

The SignatureFieldKit to populate with the contents of this SignatureFieldKit.

bool ShowBorder (out bool out_state)

Shows the border setting for the signature field.

Param out_state

Whether the signature field has a border.

Return

true if a border setting was specified, false otherwise.

bool ShowBorderColor (out HPS.RGBColor out_color)

Shows the border color for the signature field.

Param out_color

The border color of the signature field.

Return

true if a border color was specified, false otherwise.

bool ShowBorderStyle (out HPS.Publish.Border.Style out_style)

Shows the border style for the signature field.

Param out_style

The border style for the signature field.

Return

true if a border style was specified, false otherwise.

bool ShowBorderThickness (out HPS.Publish.Border.Thickness out_thickness)

Shows the border thickness for the signature field.

Param out_thickness

The border thickness for the signature field.

Return

true if a border thickness was specified, false otherwise.

bool ShowFillColor (out HPS.RGBColor out_color)

Shows the fill color for the signature field.

Param out_color

The fill color for the signature field.

Return

true if a fill color was specified, false otherwise.

bool ShowFont (out HPS.Publish.Text.Font.Type out_type, out HPS.Publish.Text.Font.Name out_font, out string out_font_name, out HPS.Publish.Text.Font.Style out_style)

Shows the font for the signature field.

Param out_type

The type of font for the signature field.

Param out_font

The built-in font for the signature field. This is only valid if out_type is Text.Font.Type.BuiltIn.

Param out_font_name

The explicit font name for the signature field. This is only valid if out_type is Text.Font.Type.Explicit.

Param out_style

The font style for the signature field. This is only valid if out_type is Text.Font.Type.Explicit.

Return

true if a font was specified, false otherwise.

bool ShowFontSize (out int out_size)

Shows the font size for the signature field.

Param out_size

The font size for the signature field.

Return

true if a font size was specified, false otherwise.

bool ShowLock (out bool out_state)

Shows the lock setting for the signature field.

Return

true if a lock setting was specified, false otherwise.

bool ShowName (out string out_name)

Shows the name for the signature field.

Param out_name

The name of the signature field.

Return

true if a name was specified, false otherwise.

bool ShowPrintability (out bool out_state)

Shows the printability for the signature field.

Param out_state

The printability for the signature field.

Return

true if a printability was specified, false otherwise.

bool ShowTextColor (out HPS.RGBColor out_color)

Shows the text color for the signature field.

Param out_color

The text color for the signature field.

Return

true if a text color was specified, false otherwise.

bool ShowTextRotation (out HPS.Publish.Text.Rotation out_rotation)

Shows the text rotation for the signature field.

Param out_rotation

The text rotation for the signature field.

Return

true if a rotation was specified, false otherwise.

bool ShowTooltip (out string out_tooltip)

Shows the tooltip for the signature field.

Param out_tooltip

The tooltip text for the signature field.

Return

true if a tooltip was specified, false otherwise.

bool ShowVisibility (out bool out_state)

Shows the visibility for the signature field.

Param out_state

The visibility for the signature field.

Return

true if a visibility was specified, false otherwise.

SignatureFieldKit ()

The default constructor creates an empty SignatureFieldKit object.

SignatureFieldKit (HPS.Publish.SignatureFieldKit in_kit)

The copy constructor creates a new SignatureFieldKit object that contains the same settings as the source SignatureFieldKit.

Param in_kit

The source SignatureFieldKit to copy.

HPS.Publish.SignatureFieldKit UnsetBorder ()

Removes the border setting.

Return

A reference to this SignatureFieldKit.

HPS.Publish.SignatureFieldKit UnsetBorderColor ()

Removes the border color setting.

Return

A reference to this SignatureFieldKit.

HPS.Publish.SignatureFieldKit UnsetBorderStyle ()

Removes the border style setting.

Return

A reference to this SignatureFieldKit.

HPS.Publish.SignatureFieldKit UnsetBorderThickness ()

Removes the border thickness setting.

Return

A reference to this SignatureFieldKit.

HPS.Publish.SignatureFieldKit UnsetEverything ()

Removes all data from the signature field.

Return

A reference to this SignatureFieldKit.

HPS.Publish.SignatureFieldKit UnsetFillColor ()

Removes the fill color setting.

Return

A reference to this SignatureFieldKit.

HPS.Publish.SignatureFieldKit UnsetFont ()

Removes the font setting.

Return

A reference to this SignatureFieldKit.

HPS.Publish.SignatureFieldKit UnsetFontSize ()

Removes the font size setting.

Return

A reference to this SignatureFieldKit.

HPS.Publish.SignatureFieldKit UnsetLock ()

Removes the lock setting.

Return

A reference to this SignatureFieldKit.

HPS.Publish.SignatureFieldKit UnsetName ()

Removes the name setting.

Return

A reference to this SignatureFieldKit.

HPS.Publish.SignatureFieldKit UnsetPrintability ()

Removes the printability setting.

Return

A reference to this SignatureFieldKit.

HPS.Publish.SignatureFieldKit UnsetTextColor ()

Removes the text color setting.

Return

A reference to this SignatureFieldKit.

HPS.Publish.SignatureFieldKit UnsetTextRotation ()

Removes the text rotation setting.

Return

A reference to this SignatureFieldKit.

HPS.Publish.SignatureFieldKit UnsetTooltip ()

Removes the tooltip setting.

Return

A reference to this SignatureFieldKit.

HPS.Publish.SignatureFieldKit UnsetVisibility ()

Removes the visibility setting.

Return

A reference to this SignatureFieldKit.

Public Static Functions

HPS.Publish.SignatureFieldKit GetDefault ()

Creates a SignatureFieldKit 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 SignatureFieldKit passed to a function.

Return

A SignatureFieldKit with the default settings.

bool operator!= (HPS.Publish.SignatureFieldKit a, HPS.Publish.SignatureFieldKit b)
bool operator== (HPS.Publish.SignatureFieldKit a, HPS.Publish.SignatureFieldKit b)