HPS.TextAttributeControl Class Reference

The HPS::TextAttributeControl class is a smart pointer that is tied to a database object. This object gives you access to all the attributes associated with text, such as font, size, and rotation. Text characteristics such as bold, italic, and underline are also accessed through the HPS::TextAttributeControl. Default values for the various fields of HPS::TextAttributeControl can be found here. More...

Inheritance diagram for HPS.TextAttributeControl:
HPS.Control HPS.Object

Public Member Functions

override void Dispose ()
 
override HPS.Type ObjectType ()
 This function returns the type the object, as declared. This does not necessarily give the true type of the underlying object. More...
 
HPS.TextAttributeControl SetAlignment (HPS.Text.Alignment in_align, HPS.Text.ReferenceFrame in_ref, HPS.Text.Justification in_justify)
 Sets the alignment for text. More...
 
HPS.TextAttributeControl SetAlignment (HPS.Text.Alignment in_align, HPS.Text.ReferenceFrame in_ref)
 Sets the alignment for text. More...
 
HPS.TextAttributeControl SetAlignment (HPS.Text.Alignment in_align)
 Sets the alignment for text. More...
 
HPS.TextAttributeControl SetBackground (bool in_state, string in_name)
 Sets the background to be used with text. More...
 
HPS.TextAttributeControl SetBackground (string in_name)
 Sets the background to be used with text. The state is implicitly on. More...
 
HPS.TextAttributeControl SetBackground (bool in_state)
 Sets the background to be used with text. More...
 
HPS.TextAttributeControl SetBackgroundMargins (float in_size, HPS.Text.MarginUnits in_units)
 Sets the amount of additional padding around text strings when backgrounds are used. More...
 
HPS.TextAttributeControl SetBackgroundMargins (float in_size)
 Sets the amount of additional padding around text strings when backgrounds are used. More...
 
HPS.TextAttributeControl SetBackgroundMargins (float[] in_sizes, HPS.Text.MarginUnits[] in_units)
 
HPS.TextAttributeControl SetBackgroundStyle (string in_name)
 Allows specifying a named style to be used in the drawing of text backgrounds. If no style is specified, backgrounds inherit the face and edge attributes from the containing segment. More...
 
HPS.TextAttributeControl SetBold (bool in_state)
 Sets whether text should be bold. For fonts which do not have a bold variant, this setting will be ignored. More...
 
HPS.TextAttributeControl SetExtraSpace (bool in_state, float in_size, HPS.Text.SizeUnits in_units)
 Sets the amount of additional space to add between characters in a text string. More...
 
HPS.TextAttributeControl SetExtraSpace (bool in_state, float in_size)
 Sets the amount of additional space to add between characters in a text string. More...
 
HPS.TextAttributeControl SetExtraSpace (bool in_state)
 Sets the amount of additional space to add between characters in a text string. More...
 
HPS.TextAttributeControl SetExtraSpace (float in_size, HPS.Text.SizeUnits in_units)
 Sets the amount of additional space to add between characters in a text string. This function implicitly enables the addition of extra space. More...
 
HPS.TextAttributeControl SetFont (string in_name)
 Sets the font to use for text. This must either be a builtin font or a font Visualize can locate in the directories specified by World::SetFontDirectories. If the requested font cannot be found, the stroked font will be used. More...
 
HPS.TextAttributeControl SetGreeking (bool in_state, float in_size, HPS.Text.GreekingUnits in_units, HPS.Text.GreekingMode in_mode)
 Sets the greeking settings to use for text. More...
 
HPS.TextAttributeControl SetGreeking (bool in_state, float in_size, HPS.Text.GreekingUnits in_units)
 Sets the greeking settings to use for text. More...
 
HPS.TextAttributeControl SetGreeking (bool in_state, float in_size)
 Sets the greeking settings to use for text. More...
 
HPS.TextAttributeControl SetGreeking (bool in_state)
 Sets the greeking settings to use for text. More...
 
HPS.TextAttributeControl SetGreeking (float in_size, HPS.Text.GreekingUnits in_units, HPS.Text.GreekingMode in_mode)
 Sets the greeking settings to use for text. This function implicitly enables text greeking. More...
 
HPS.TextAttributeControl SetGreeking (float in_size, HPS.Text.GreekingUnits in_units)
 Sets the greeking settings to use for text. This function implicitly enables text greeking. More...
 
HPS.TextAttributeControl SetGreeking (float in_size)
 Sets the greeking settings to use for text. This function implicitly enables text greeking. More...
 
HPS.TextAttributeControl SetItalic (bool in_state)
 Sets whether text should be italic. For fonts which do not have an italic variant, this setting will be ignored. More...
 
HPS.TextAttributeControl SetLineSpacing (float in_multiplier)
 Sets the line spacing multiplier for text. This is a multiple of the font size that will be used to determine spacing between lines in multi-line text string. More...
 
HPS.TextAttributeControl SetOverline (bool in_state)
 Sets whether an overline should be drawn over text. More...
 
HPS.TextAttributeControl SetPath (HPS.Vector in_path)
 Sets the path for text. This setting controls the vector along which text strings will be displayed. More...
 
HPS.TextAttributeControl SetPreference (HPS.Text.Preference in_pref)
 Sets the font type preference for text. This function implicitly sets the same font type for all text sizes. More...
 
HPS.TextAttributeControl SetPreference (float in_cutoff, HPS.Text.SizeUnits in_units, HPS.Text.Preference in_smaller, HPS.Text.Preference in_larger)
 Sets the preference for text. This setting controls which font type is used for text for "large" and "small" sizes and the cutoff at which this distinction is made. More...
 
HPS.TextAttributeControl SetRenderer (HPS.Text.Renderer in_rend)
 Sets the renderer for text. More...
 
HPS.TextAttributeControl SetRotation (HPS.Text.Rotation in_state, float in_angle)
 Sets the angle characters should be rotated within text strings. More...
 
HPS.TextAttributeControl SetRotation (HPS.Text.Rotation in_state)
 Sets the angle characters should be rotated within text strings. More...
 
HPS.TextAttributeControl SetRotation (float in_angle)
 Sets the angle characters should be rotated within text strings. This function implicitly sets a rotation state of Text::Rotation::Rotate. More...
 
HPS.TextAttributeControl SetSize (float in_size, HPS.Text.SizeUnits in_units)
 Sets the font size to use for text. More...
 
HPS.TextAttributeControl SetSizeTolerance (bool in_state, float in_size, HPS.Text.SizeToleranceUnits in_units)
 Sets the size tolerance settings to use for text. These settings control how to render text strings which request a size not available for a bitmap font. If a size tolerance is specified and enabled, Visualize will use the nearest smaller size for the bitmap font within the tolerance in place of the requested size. If a size tolerance is not enabled, Visualize will attempt to scale up the nearest bitmap font size to the requested size. This setting has no effect for True Type or Open Type fonts. More...
 
HPS.TextAttributeControl SetSizeTolerance (bool in_state, float in_size)
 Sets the size tolerance settings to use for text. These settings control how to render text strings which request a size not available for a bitmap font. If a size tolerance is specified and enabled, Visualize will use the nearest smaller size for the bitmap font within the tolerance in place of the requested size. If a size tolerance is not enabled, Visualize will attempt to scale up the nearest bitmap font size to the requested size. This setting has no effect for True Type or Open Type fonts. More...
 
HPS.TextAttributeControl SetSizeTolerance (bool in_state)
 Sets the size tolerance settings to use for text. These settings control how to render text strings which request a size not available for a bitmap font. If a size tolerance is specified and enabled, Visualize will use the nearest smaller size for the bitmap font within the tolerance in place of the requested size. If a size tolerance is not enabled, Visualize will attempt to scale up the nearest bitmap font size to the requested size. This setting has no effect for True Type or Open Type fonts. More...
 
HPS.TextAttributeControl SetSizeTolerance (float in_size, HPS.Text.SizeToleranceUnits in_units)
 Sets the size tolerance settings to use for text. These settings control how to render text strings which request a size not available for a bitmap font. If a size tolerance is specified and enabled, Visualize will use the nearest smaller size for the bitmap font within the tolerance in place of the requested size. If a size tolerance is not enabled, Visualize will attempt to scale up the nearest bitmap font size to the requested size. This setting has no effect for True Type or Open Type fonts. This function implicitly enables a size tolerance. More...
 
HPS.TextAttributeControl SetSlant (float in_angle)
 Sets the slant angle for text. This determines how far the characters in the string are sheared to the left (negative angle) or right (positive angle) relative to the perpendicular. More...
 
HPS.TextAttributeControl SetSpacing (float in_multiplier)
 Sets the spacing multiplier for text. This setting controls the spacing between adjacent characters within a string. A value of 0.0f would result in all characters being drawn on top of each other, a value of 1.0f would be the standard spacing between characters, a value of 2.0f would insert twice as much space as would normally be between two characters, and so on. More...
 
HPS.TextAttributeControl SetStrikethrough (bool in_state)
 Sets whether a strikethrough should be drawn through text. More...
 
HPS.TextAttributeControl SetTransform (HPS.Text.Transform in_trans)
 Sets the transform behavior for text. More...
 
HPS.TextAttributeControl SetUnderline (bool in_state)
 Sets whether an underline should be drawn under text. More...
 
bool ShowAlignment (out HPS.Text.Alignment out_align, out HPS.Text.ReferenceFrame out_ref, out HPS.Text.Justification out_justify)
 Shows the alignment for text. More...
 
bool ShowBackground (out bool out_state, out string out_name)
 Shows the background to be used with text. More...
 
bool ShowBackgroundMargins (out float[] out_size, out HPS.Text.MarginUnits[] out_units)
 Shows the amount of additional padding around text strings when backgrounds are used. More...
 
bool ShowBackgroundStyle (out string out_name)
 Shows the named style to be used in the drawing of text backgrounds. More...
 
bool ShowBold (out bool out_state)
 Shows whether text should be bold. More...
 
bool ShowExtraSpace (out bool out_state, out float out_size, out HPS.Text.SizeUnits out_units)
 Shows the amount of additional space to add between characters in a text string. More...
 
bool ShowFont (out string out_name)
 Shows the font to use for text. More...
 
bool ShowGreeking (out bool out_state, out float out_size, out HPS.Text.GreekingUnits out_units, out HPS.Text.GreekingMode out_mode)
 Shows the greeking settings to use for text. More...
 
bool ShowItalic (out bool out_state)
 Shows whether text should be italic. More...
 
bool ShowLineSpacing (out float out_multiplier)
 Shows the line spacing multiplier for text. More...
 
bool ShowOverline (out bool out_state)
 Shows whether an overline should be drawn over text. More...
 
bool ShowPath (out HPS.Vector out_path)
 Shows the path for text. More...
 
bool ShowPreference (out float out_cutoff, out HPS.Text.SizeUnits out_units, out HPS.Text.Preference out_smaller, out HPS.Text.Preference out_larger)
 Shows the preference for text. More...
 
bool ShowRenderer (out HPS.Text.Renderer out_rend)
 Shows the renderer for text. More...
 
bool ShowRotation (out HPS.Text.Rotation out_rot, out float out_angle)
 Shows the angle characters should be rotated within text strings. More...
 
bool ShowSize (out float out_size, out HPS.Text.SizeUnits out_units)
 Shows the font size to use for text. More...
 
bool ShowSizeTolerance (out bool out_state, out float out_size, out HPS.Text.SizeToleranceUnits out_units)
 Shows the size tolerance settings to use for text. More...
 
bool ShowSlant (out float out_angle)
 Shows the slant angle for text. More...
 
bool ShowSpacing (out float out_multiplier)
 Shows the spacing multiplier for text. More...
 
bool ShowStrikethrough (out bool out_state)
 Shows whether a strikethrough should be drawn through text. More...
 
bool ShowTransform (out HPS.Text.Transform out_trans)
 Shows the transform state for text. More...
 
bool ShowUnderline (out bool out_state)
 Shows whether an underline should be drawn under text. More...
 
 TextAttributeControl (HPS.SegmentKey in_seg)
 Initializes a control tied to the segment in_seg. More...
 
 TextAttributeControl (HPS.TextAttributeControl in_that)
 Initializes a control tied to the same object as in_that. More...
 
HPS.TextAttributeControl UnsetAlignment ()
 Removes the alignment setting. More...
 
HPS.TextAttributeControl UnsetBackground ()
 Removes the background setting. More...
 
HPS.TextAttributeControl UnsetBackgroundMargins ()
 Removes the background margin setting. More...
 
HPS.TextAttributeControl UnsetBackgroundStyle ()
 Removes the background style setting. More...
 
HPS.TextAttributeControl UnsetBold ()
 Removes the bold setting. More...
 
HPS.TextAttributeControl UnsetEverything ()
 Removes all settings from this object. More...
 
HPS.TextAttributeControl UnsetExtraSpace ()
 Removes the extra space setting. More...
 
HPS.TextAttributeControl UnsetFont ()
 Removes the font setting. More...
 
HPS.TextAttributeControl UnsetGreeking ()
 Removes the greeking setting. More...
 
HPS.TextAttributeControl UnsetItalic ()
 Removes the italic setting. More...
 
HPS.TextAttributeControl UnsetLineSpacing ()
 Removes the line spacing setting. More...
 
HPS.TextAttributeControl UnsetOverline ()
 Removes the overline setting. More...
 
HPS.TextAttributeControl UnsetPath ()
 Removes the path setting. More...
 
HPS.TextAttributeControl UnsetPreference ()
 Removes the preference setting. More...
 
HPS.TextAttributeControl UnsetRenderer ()
 Removes the renderer setting. More...
 
HPS.TextAttributeControl UnsetRotation ()
 Removes the rotation setting. More...
 
HPS.TextAttributeControl UnsetSize ()
 Removes the size setting. More...
 
HPS.TextAttributeControl UnsetSizeTolerance ()
 Removes the size tolerance setting. More...
 
HPS.TextAttributeControl UnsetSlant ()
 Removes the slant setting. More...
 
HPS.TextAttributeControl UnsetSpacing ()
 Removes the spacing setting. More...
 
HPS.TextAttributeControl UnsetStrikethrough ()
 Removes the strikethrough setting. More...
 
HPS.TextAttributeControl UnsetTransform ()
 Removes the transform setting. More...
 
HPS.TextAttributeControl UnsetUnderline ()
 Removes the underline setting. More...
 
- Public Member Functions inherited from HPS.Control
 Control (HPS.Control in_that)
 
- Public Member Functions inherited from HPS.Object
virtual bool Empty ()
 Indicates whether this object has any values set on it. More...
 
IntPtr GetClassID ()
 
IntPtr GetInstanceID ()
 Returns an identifier that can be used to identify which instance of a class an object is. Different keys and controls will return the same value if they are backed by the same database resource. More...
 
bool HasType (HPS.Type in_mask)
 This function indicates whether this Object has the given Type mask. More...
 
 Object (HPS.Object that)
 
virtual void Reset ()
 Resets this object to its initial, uninitialized state. More...
 
HPS.Type Type ()
 This function returns the true type of the underlying object. This function is useful for finding the type of smart pointer objects that have been cast to more generic types. More...
 

Protected Member Functions

override void deleteCptr ()
 
- Protected Member Functions inherited from HPS.Object
virtual IntPtr GetNonDirectorClassID ()
 

Additional Inherited Members

- Static Public Member Functions inherited from HPS.Object
static IntPtr ClassID< T > ()
 
- Protected Attributes inherited from HPS.Object
bool cMemOwn
 
HandleRef cptr
 
HandleRef scptr
 

Detailed Description

The HPS::TextAttributeControl class is a smart pointer that is tied to a database object. This object gives you access to all the attributes associated with text, such as font, size, and rotation. Text characteristics such as bold, italic, and underline are also accessed through the HPS::TextAttributeControl. Default values for the various fields of HPS::TextAttributeControl can be found here.

Constructor & Destructor Documentation

HPS.TextAttributeControl.TextAttributeControl ( HPS.SegmentKey  in_seg)
inline

Initializes a control tied to the segment in_seg.

HPS.TextAttributeControl.TextAttributeControl ( HPS.TextAttributeControl  in_that)
inline

Initializes a control tied to the same object as in_that.

Member Function Documentation

override HPS.Type HPS.TextAttributeControl.ObjectType ( )
inlinevirtual

This function returns the type the object, as declared. This does not necessarily give the true type of the underlying object.

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

Reimplemented from HPS.Object.

HPS.TextAttributeControl HPS.TextAttributeControl.SetAlignment ( HPS.Text.Alignment  in_align,
HPS.Text.ReferenceFrame  in_ref,
HPS.Text.Justification  in_justify 
)
inline

Sets the alignment for text.

Returns
A reference to this object.
HPS.TextAttributeControl HPS.TextAttributeControl.SetAlignment ( HPS.Text.Alignment  in_align,
HPS.Text.ReferenceFrame  in_ref 
)
inline

Sets the alignment for text.

Returns
A reference to this object.
HPS.TextAttributeControl HPS.TextAttributeControl.SetAlignment ( HPS.Text.Alignment  in_align)
inline

Sets the alignment for text.

Returns
A reference to this object.
HPS.TextAttributeControl HPS.TextAttributeControl.SetBackground ( bool  in_state,
string  in_name 
)
inline

Sets the background to be used with text.

Parameters
in_stateWhether a background is drawn for text.
in_nameThe name of a shape definition.
Returns
A reference to this object.
HPS.TextAttributeControl HPS.TextAttributeControl.SetBackground ( string  in_name)
inline

Sets the background to be used with text. The state is implicitly on.

Parameters
in_nameThe name of a shape definition.
Returns
A reference to this object.
HPS.TextAttributeControl HPS.TextAttributeControl.SetBackground ( bool  in_state)
inline

Sets the background to be used with text.

Parameters
in_stateWhether a background is drawn for text.
Returns
A reference to this object.
HPS.TextAttributeControl HPS.TextAttributeControl.SetBackgroundMargins ( float  in_size,
HPS.Text.MarginUnits  in_units 
)
inline

Sets the amount of additional padding around text strings when backgrounds are used.

Parameters
in_sizeThe size of the margins.
in_unitsThe units of the size.
Returns
A reference to this object.
HPS.TextAttributeControl HPS.TextAttributeControl.SetBackgroundMargins ( float  in_size)
inline

Sets the amount of additional padding around text strings when backgrounds are used.

Parameters
in_sizeThe size of the margins.
Returns
A reference to this object.
HPS.TextAttributeControl HPS.TextAttributeControl.SetBackgroundStyle ( string  in_name)
inline

Allows specifying a named style to be used in the drawing of text backgrounds. If no style is specified, backgrounds inherit the face and edge attributes from the containing segment.

Parameters
in_nameThe name of a style, defined in a portfolio that is accessible.
Returns
A reference to this object.
HPS.TextAttributeControl HPS.TextAttributeControl.SetBold ( bool  in_state)
inline

Sets whether text should be bold. For fonts which do not have a bold variant, this setting will be ignored.

Parameters
in_stateWhether text should be bold.
Returns
A reference to this object.
HPS.TextAttributeControl HPS.TextAttributeControl.SetExtraSpace ( bool  in_state,
float  in_size,
HPS.Text.SizeUnits  in_units 
)
inline

Sets the amount of additional space to add between characters in a text string.

Parameters
in_stateWhether to add additional space between characters in a text string.
in_sizeThe size of the additional space to add between characters.
in_unitsThe units of the size of the additional space to add between characters.
Returns
A reference to this object.
HPS.TextAttributeControl HPS.TextAttributeControl.SetExtraSpace ( bool  in_state,
float  in_size 
)
inline

Sets the amount of additional space to add between characters in a text string.

Parameters
in_stateWhether to add additional space between characters in a text string.
in_sizeThe size of the additional space to add between characters.
Returns
A reference to this object.
HPS.TextAttributeControl HPS.TextAttributeControl.SetExtraSpace ( bool  in_state)
inline

Sets the amount of additional space to add between characters in a text string.

Parameters
in_stateWhether to add additional space between characters in a text string.
Returns
A reference to this object.
HPS.TextAttributeControl HPS.TextAttributeControl.SetExtraSpace ( float  in_size,
HPS.Text.SizeUnits  in_units 
)
inline

Sets the amount of additional space to add between characters in a text string. This function implicitly enables the addition of extra space.

Parameters
in_sizeThe size of the additional space to add between characters.
in_unitsThe units of the size of the additional space to add between characters.
Returns
A reference to this object.
HPS.TextAttributeControl HPS.TextAttributeControl.SetFont ( string  in_name)
inline

Sets the font to use for text. This must either be a builtin font or a font Visualize can locate in the directories specified by World::SetFontDirectories. If the requested font cannot be found, the stroked font will be used.

Parameters
in_nameUTF8-encoded font name to use for text.
Returns
A reference to this TextKey.

World::SetFontDirectories

HPS.TextAttributeControl HPS.TextAttributeControl.SetGreeking ( bool  in_state,
float  in_size,
HPS.Text.GreekingUnits  in_units,
HPS.Text.GreekingMode  in_mode 
)
inline

Sets the greeking settings to use for text.

Parameters
in_stateWhether greeking is enabled for text.
in_sizeThe size below which to draw a simple symbol in place of a character.
in_unitsThe units of the size below which to draw a simple glyph in place of a character.
in_modeThe type of symbol to draw for characters which are smaller than the greeking size.
Returns
A reference to this object.
HPS.TextAttributeControl HPS.TextAttributeControl.SetGreeking ( bool  in_state,
float  in_size,
HPS.Text.GreekingUnits  in_units 
)
inline

Sets the greeking settings to use for text.

Parameters
in_stateWhether greeking is enabled for text.
in_sizeThe size below which to draw a simple symbol in place of a character.
in_unitsThe units of the size below which to draw a simple glyph in place of a character.
Returns
A reference to this object.
HPS.TextAttributeControl HPS.TextAttributeControl.SetGreeking ( bool  in_state,
float  in_size 
)
inline

Sets the greeking settings to use for text.

Parameters
in_stateWhether greeking is enabled for text.
in_sizeThe size below which to draw a simple symbol in place of a character.
Returns
A reference to this object.
HPS.TextAttributeControl HPS.TextAttributeControl.SetGreeking ( bool  in_state)
inline

Sets the greeking settings to use for text.

Parameters
in_stateWhether greeking is enabled for text.
Returns
A reference to this object.
HPS.TextAttributeControl HPS.TextAttributeControl.SetGreeking ( float  in_size,
HPS.Text.GreekingUnits  in_units,
HPS.Text.GreekingMode  in_mode 
)
inline

Sets the greeking settings to use for text. This function implicitly enables text greeking.

Parameters
in_sizeThe size below which to draw a simple symbol in place of a character.
in_unitsThe units of the size below which to draw a simple glyph in place of a character.
in_modeThe type of symbol to draw for characters which are smaller than the greeking size.
Returns
A reference to this object.
HPS.TextAttributeControl HPS.TextAttributeControl.SetGreeking ( float  in_size,
HPS.Text.GreekingUnits  in_units 
)
inline

Sets the greeking settings to use for text. This function implicitly enables text greeking.

Parameters
in_sizeThe size below which to draw a simple symbol in place of a character.
in_unitsThe units of the size below which to draw a simple glyph in place of a character.
Returns
A reference to this object.
HPS.TextAttributeControl HPS.TextAttributeControl.SetGreeking ( float  in_size)
inline

Sets the greeking settings to use for text. This function implicitly enables text greeking.

Parameters
in_sizeThe size below which to draw a simple symbol in place of a character.
Returns
A reference to this object.
HPS.TextAttributeControl HPS.TextAttributeControl.SetItalic ( bool  in_state)
inline

Sets whether text should be italic. For fonts which do not have an italic variant, this setting will be ignored.

Parameters
in_stateWhether text should be italic.
Returns
A reference to this object.
HPS.TextAttributeControl HPS.TextAttributeControl.SetLineSpacing ( float  in_multiplier)
inline

Sets the line spacing multiplier for text. This is a multiple of the font size that will be used to determine spacing between lines in multi-line text string.

Parameters
in_multiplierThe line spacing multiplier for text.
Returns
A reference to this object.
HPS.TextAttributeControl HPS.TextAttributeControl.SetOverline ( bool  in_state)
inline

Sets whether an overline should be drawn over text.

Parameters
in_stateWhether an overline should be drawn over text.
Returns
A reference to this object.
HPS.TextAttributeControl HPS.TextAttributeControl.SetPath ( HPS.Vector  in_path)
inline

Sets the path for text. This setting controls the vector along which text strings will be displayed.

Parameters
in_pathThe path for text.
Returns
A reference to this object.
HPS.TextAttributeControl HPS.TextAttributeControl.SetPreference ( HPS.Text.Preference  in_pref)
inline

Sets the font type preference for text. This function implicitly sets the same font type for all text sizes.

Returns
A reference to this object.
HPS.TextAttributeControl HPS.TextAttributeControl.SetPreference ( float  in_cutoff,
HPS.Text.SizeUnits  in_units,
HPS.Text.Preference  in_smaller,
HPS.Text.Preference  in_larger 
)
inline

Sets the preference for text. This setting controls which font type is used for text for "large" and "small" sizes and the cutoff at which this distinction is made.

Parameters
in_cutoffThe font size below which the smaller preference is used and above which the larger preference is used.
in_unitsThe units for the font size below which the smaller preference is used and above which the larger preference is used.
in_smallerThe font type preference for strings below the cutoff size.
in_largerThe font type preference for strings above the cutoff size.
Returns
A reference to this object.
HPS.TextAttributeControl HPS.TextAttributeControl.SetRenderer ( HPS.Text.Renderer  in_rend)
inline

Sets the renderer for text.

Returns
A reference to this object.
HPS.TextAttributeControl HPS.TextAttributeControl.SetRotation ( HPS.Text.Rotation  in_state,
float  in_angle 
)
inline

Sets the angle characters should be rotated within text strings.

Parameters
in_stateWhether and how to rotate the characters within text string.
in_angleThe angle in degrees to rotate each character within text strings. This is only relevant if in_state is Text::Rotation::Rotate.
Returns
A reference to this object.
HPS.TextAttributeControl HPS.TextAttributeControl.SetRotation ( HPS.Text.Rotation  in_state)
inline

Sets the angle characters should be rotated within text strings.

Parameters
in_stateWhether and how to rotate the characters within text string.
Returns
A reference to this object.
HPS.TextAttributeControl HPS.TextAttributeControl.SetRotation ( float  in_angle)
inline

Sets the angle characters should be rotated within text strings. This function implicitly sets a rotation state of Text::Rotation::Rotate.

Parameters
in_angleThe angle in degrees to rotate each character within text strings.
Returns
A reference to this object.
HPS.TextAttributeControl HPS.TextAttributeControl.SetSize ( float  in_size,
HPS.Text.SizeUnits  in_units 
)
inline

Sets the font size to use for text.

Parameters
in_sizeThe size for text.
in_unitsThe units of the size for text.
Returns
A reference to this object.
HPS.TextAttributeControl HPS.TextAttributeControl.SetSizeTolerance ( bool  in_state,
float  in_size,
HPS.Text.SizeToleranceUnits  in_units 
)
inline

Sets the size tolerance settings to use for text. These settings control how to render text strings which request a size not available for a bitmap font. If a size tolerance is specified and enabled, Visualize will use the nearest smaller size for the bitmap font within the tolerance in place of the requested size. If a size tolerance is not enabled, Visualize will attempt to scale up the nearest bitmap font size to the requested size. This setting has no effect for True Type or Open Type fonts.

Parameters
in_stateWhether a size tolerance is enabled for text.
in_sizeThe size for the tolerance.
in_unitsThe units of the size for the tolerance.
Returns
A reference to this object.
HPS.TextAttributeControl HPS.TextAttributeControl.SetSizeTolerance ( bool  in_state,
float  in_size 
)
inline

Sets the size tolerance settings to use for text. These settings control how to render text strings which request a size not available for a bitmap font. If a size tolerance is specified and enabled, Visualize will use the nearest smaller size for the bitmap font within the tolerance in place of the requested size. If a size tolerance is not enabled, Visualize will attempt to scale up the nearest bitmap font size to the requested size. This setting has no effect for True Type or Open Type fonts.

Parameters
in_stateWhether a size tolerance is enabled for text.
in_sizeThe size for the tolerance.
Returns
A reference to this object.
HPS.TextAttributeControl HPS.TextAttributeControl.SetSizeTolerance ( bool  in_state)
inline

Sets the size tolerance settings to use for text. These settings control how to render text strings which request a size not available for a bitmap font. If a size tolerance is specified and enabled, Visualize will use the nearest smaller size for the bitmap font within the tolerance in place of the requested size. If a size tolerance is not enabled, Visualize will attempt to scale up the nearest bitmap font size to the requested size. This setting has no effect for True Type or Open Type fonts.

Parameters
in_stateWhether a size tolerance is enabled for text.
Returns
A reference to this object.
HPS.TextAttributeControl HPS.TextAttributeControl.SetSizeTolerance ( float  in_size,
HPS.Text.SizeToleranceUnits  in_units 
)
inline

Sets the size tolerance settings to use for text. These settings control how to render text strings which request a size not available for a bitmap font. If a size tolerance is specified and enabled, Visualize will use the nearest smaller size for the bitmap font within the tolerance in place of the requested size. If a size tolerance is not enabled, Visualize will attempt to scale up the nearest bitmap font size to the requested size. This setting has no effect for True Type or Open Type fonts. This function implicitly enables a size tolerance.

Parameters
in_sizeThe size for the tolerance.
in_unitsThe units of the size for the tolerance.
Returns
A reference to this object.
HPS.TextAttributeControl HPS.TextAttributeControl.SetSlant ( float  in_angle)
inline

Sets the slant angle for text. This determines how far the characters in the string are sheared to the left (negative angle) or right (positive angle) relative to the perpendicular.

Parameters
in_angleThe angle in degrees to slant text. This value must be in the range [-75.0f,+75.0f].
Returns
A reference to this object.
HPS.TextAttributeControl HPS.TextAttributeControl.SetSpacing ( float  in_multiplier)
inline

Sets the spacing multiplier for text. This setting controls the spacing between adjacent characters within a string. A value of 0.0f would result in all characters being drawn on top of each other, a value of 1.0f would be the standard spacing between characters, a value of 2.0f would insert twice as much space as would normally be between two characters, and so on.

Parameters
in_multiplierThe spacing multiplier for text.
Returns
A reference to this object.
HPS.TextAttributeControl HPS.TextAttributeControl.SetStrikethrough ( bool  in_state)
inline

Sets whether a strikethrough should be drawn through text.

Parameters
in_stateWhether a strikethrough should be drawn through text.
Returns
A reference to this object.
HPS.TextAttributeControl HPS.TextAttributeControl.SetTransform ( HPS.Text.Transform  in_trans)
inline

Sets the transform behavior for text.

Returns
A reference to this object.
HPS.TextAttributeControl HPS.TextAttributeControl.SetUnderline ( bool  in_state)
inline

Sets whether an underline should be drawn under text.

Parameters
in_stateWhether an underline should be drawn under text.
Returns
A reference to this object.
bool HPS.TextAttributeControl.ShowAlignment ( out HPS.Text.Alignment  out_align,
out HPS.Text.ReferenceFrame  out_ref,
out HPS.Text.Justification  out_justify 
)
inline

Shows the alignment for text.

Returns
true if an alignment was set, false otherwise.
bool HPS.TextAttributeControl.ShowBackground ( out bool  out_state,
out string  out_name 
)
inline

Shows the background to be used with text.

Parameters
out_stateWhether a background is drawn for text.
out_nameThe name of a shape definition.
Returns
true if a spacing multiplier was set, false otherwise.
bool HPS.TextAttributeControl.ShowBackgroundMargins ( out float[]  out_size,
out HPS.Text.MarginUnits[]  out_units 
)
inline

Shows the amount of additional padding around text strings when backgrounds are used.

Parameters
out_sizeThe size of the margins.
out_unitsThe units of the sizes.
Returns
true if a spacing multiplier was set, false otherwise.
bool HPS.TextAttributeControl.ShowBackgroundStyle ( out string  out_name)
inline

Shows the named style to be used in the drawing of text backgrounds.

Parameters
out_nameThe name of a style, defined in a portfolio that is accessible.
Returns
true if a spacing multiplier was set, false otherwise.
bool HPS.TextAttributeControl.ShowBold ( out bool  out_state)
inline

Shows whether text should be bold.

Parameters
out_stateWhether text should be bold.
Returns
true if a bold setting was set, false otherwise.
bool HPS.TextAttributeControl.ShowExtraSpace ( out bool  out_state,
out float  out_size,
out HPS.Text.SizeUnits  out_units 
)
inline

Shows the amount of additional space to add between characters in a text string.

Parameters
out_stateWhether to add additional space between characters in a text string.
out_sizeThe size of the additional space to add between characters.
out_unitsThe units of the size of the additional space to add between characters.
Returns
true if an extra space setting was set, false otherwise.
bool HPS.TextAttributeControl.ShowFont ( out string  out_name)
inline

Shows the font to use for text.

Parameters
out_nameUTF8-encoded font name to use for text.
Returns
true if a font was set, false otherwise.
bool HPS.TextAttributeControl.ShowGreeking ( out bool  out_state,
out float  out_size,
out HPS.Text.GreekingUnits  out_units,
out HPS.Text.GreekingMode  out_mode 
)
inline

Shows the greeking settings to use for text.

Parameters
out_stateWhether greeking is enabled for text.
out_sizeThe size below which to draw a simple symbol in place of a character.
out_unitsThe units of the size below which to draw a simple glyph in place of a character.
out_modeThe type of symbol to draw for characters which are smaller than the greeking size.
Returns
true if greeking settings were set, false otherwise.
bool HPS.TextAttributeControl.ShowItalic ( out bool  out_state)
inline

Shows whether text should be italic.

Parameters
out_stateWhether text should be italic.
Returns
true if an italic setting was set, false otherwise.
bool HPS.TextAttributeControl.ShowLineSpacing ( out float  out_multiplier)
inline

Shows the line spacing multiplier for text.

Parameters
out_multiplierThe line spacing multiplier for text.
Returns
true if a line space multiplier was set, false otherwise.
bool HPS.TextAttributeControl.ShowOverline ( out bool  out_state)
inline

Shows whether an overline should be drawn over text.

Parameters
out_stateWhether an overline should be drawn over text.
Returns
true if an overline setting was set, false otherwise.
bool HPS.TextAttributeControl.ShowPath ( out HPS.Vector  out_path)
inline

Shows the path for text.

Parameters
out_pathThe path for text.
Returns
true if a path was set, false otherwise.
bool HPS.TextAttributeControl.ShowPreference ( out float  out_cutoff,
out HPS.Text.SizeUnits  out_units,
out HPS.Text.Preference  out_smaller,
out HPS.Text.Preference  out_larger 
)
inline

Shows the preference for text.

Parameters
out_cutoffThe font size below which the smaller preference is used and above which the larger preference is used.
out_unitsThe units for the font size below which the smaller preference is used and above which the larger preference is used.
out_smallerThe font type preference for strings below the cutoff size.
out_largerThe font type preference for strings above the cutoff size.
Returns
true if a preference was set, false otherwise.
bool HPS.TextAttributeControl.ShowRenderer ( out HPS.Text.Renderer  out_rend)
inline

Shows the renderer for text.

Returns
true if a renderer was set, false otherwise.
bool HPS.TextAttributeControl.ShowRotation ( out HPS.Text.Rotation  out_rot,
out float  out_angle 
)
inline

Shows the angle characters should be rotated within text strings.

Parameters
out_rotWhether to rotate the characters within text strings, and if so, what the angle should be measured with repect to.
out_angleThe angle in degrees to rotate each character within text strings.
Returns
true if a rotation setting was set, false otherwise.
bool HPS.TextAttributeControl.ShowSize ( out float  out_size,
out HPS.Text.SizeUnits  out_units 
)
inline

Shows the font size to use for text.

Parameters
out_sizeThe size for text.
out_unitsThe units of the size for text.
Returns
true if a size was set, false otherwise.
bool HPS.TextAttributeControl.ShowSizeTolerance ( out bool  out_state,
out float  out_size,
out HPS.Text.SizeToleranceUnits  out_units 
)
inline

Shows the size tolerance settings to use for text.

Parameters
out_stateWhether a size tolerance is enabled for text.
out_sizeThe size for the tolerance.
out_unitsThe units of the size for the tolerance.
Returns
true if a size tolerance was set, false otherwise.
bool HPS.TextAttributeControl.ShowSlant ( out float  out_angle)
inline

Shows the slant angle for text.

Parameters
out_angleThe angle in degrees to slant text.
Returns
true if a slang angle was set, false otherwise.
bool HPS.TextAttributeControl.ShowSpacing ( out float  out_multiplier)
inline

Shows the spacing multiplier for text.

Parameters
out_multiplierThe spacing multiplier for text.
Returns
true if a spacing multiplier was set, false otherwise.
bool HPS.TextAttributeControl.ShowStrikethrough ( out bool  out_state)
inline

Shows whether a strikethrough should be drawn through text.

Parameters
out_stateWhether a strikethrough should be drawn through text.
Returns
true if a strikethrough setting was set, false otherwise.
bool HPS.TextAttributeControl.ShowTransform ( out HPS.Text.Transform  out_trans)
inline

Shows the transform state for text.

Returns
true if a transform state was set, false otherwise.
bool HPS.TextAttributeControl.ShowUnderline ( out bool  out_state)
inline

Shows whether an underline should be drawn under text.

Parameters
out_stateWhether an underline should be drawn under text.
Returns
true if an underline setting was set, false otherwise.
HPS.TextAttributeControl HPS.TextAttributeControl.UnsetAlignment ( )
inline

Removes the alignment setting.

Returns
A reference to this object.
HPS.TextAttributeControl HPS.TextAttributeControl.UnsetBackground ( )
inline

Removes the background setting.

Returns
A reference to this object.
HPS.TextAttributeControl HPS.TextAttributeControl.UnsetBackgroundMargins ( )
inline

Removes the background margin setting.

Returns
A reference to this object.
HPS.TextAttributeControl HPS.TextAttributeControl.UnsetBackgroundStyle ( )
inline

Removes the background style setting.

Returns
A reference to this object.
HPS.TextAttributeControl HPS.TextAttributeControl.UnsetBold ( )
inline

Removes the bold setting.

Returns
A reference to this object.
HPS.TextAttributeControl HPS.TextAttributeControl.UnsetEverything ( )
inline

Removes all settings from this object.

Returns
A reference to this object.
HPS.TextAttributeControl HPS.TextAttributeControl.UnsetExtraSpace ( )
inline

Removes the extra space setting.

Returns
A reference to this object.
HPS.TextAttributeControl HPS.TextAttributeControl.UnsetFont ( )
inline

Removes the font setting.

Returns
A reference to this object.
HPS.TextAttributeControl HPS.TextAttributeControl.UnsetGreeking ( )
inline

Removes the greeking setting.

Returns
A reference to this object.
HPS.TextAttributeControl HPS.TextAttributeControl.UnsetItalic ( )
inline

Removes the italic setting.

Returns
A reference to this object.
HPS.TextAttributeControl HPS.TextAttributeControl.UnsetLineSpacing ( )
inline

Removes the line spacing setting.

Returns
A reference to this object.
HPS.TextAttributeControl HPS.TextAttributeControl.UnsetOverline ( )
inline

Removes the overline setting.

Returns
A reference to this object.
HPS.TextAttributeControl HPS.TextAttributeControl.UnsetPath ( )
inline

Removes the path setting.

Returns
A reference to this object.
HPS.TextAttributeControl HPS.TextAttributeControl.UnsetPreference ( )
inline

Removes the preference setting.

Returns
A reference to this object.
HPS.TextAttributeControl HPS.TextAttributeControl.UnsetRenderer ( )
inline

Removes the renderer setting.

Returns
A reference to this object.
HPS.TextAttributeControl HPS.TextAttributeControl.UnsetRotation ( )
inline

Removes the rotation setting.

Returns
A reference to this object.
HPS.TextAttributeControl HPS.TextAttributeControl.UnsetSize ( )
inline

Removes the size setting.

Returns
A reference to this object.
HPS.TextAttributeControl HPS.TextAttributeControl.UnsetSizeTolerance ( )
inline

Removes the size tolerance setting.

Returns
A reference to this object.
HPS.TextAttributeControl HPS.TextAttributeControl.UnsetSlant ( )
inline

Removes the slant setting.

Returns
A reference to this object.
HPS.TextAttributeControl HPS.TextAttributeControl.UnsetSpacing ( )
inline

Removes the spacing setting.

Returns
A reference to this object.
HPS.TextAttributeControl HPS.TextAttributeControl.UnsetStrikethrough ( )
inline

Removes the strikethrough setting.

Returns
A reference to this object.
HPS.TextAttributeControl HPS.TextAttributeControl.UnsetTransform ( )
inline

Removes the transform setting.

Returns
A reference to this object.
HPS.TextAttributeControl HPS.TextAttributeControl.UnsetUnderline ( )
inline

Removes the underline setting.

Returns
A reference to this object.

The documentation for this class was generated from the following file:
  • internals/hps_core/source/cs/HPS.TextAttributeControl.cs