CFx SDK Documentation 2024 SP0
Loading...
Searching...
No Matches
Public Member Functions | Protected Member Functions | List of all members
OdPdfPublish::OdRadioButton Class Reference

#include <PdfPublishRadioButton.h>

Inheritance diagram for OdPdfPublish::OdRadioButton:
OdPdfPublish::OdObject OdRxObject

Public Member Functions

 ODRX_DECLARE_MEMBERS (OdRadioButton)
 
 ODRX_HEAP_OPERATORS ()
 
virtual ~OdRadioButton ()
 
void setName (const OdString &name)
 
void setFont (Text::StandardFontsType fontType)
 
void setFont (const OdString &fontName, Text::FontStyle fontStyle=Text::kRegular)
 
void setFontSize (OdUInt16 size)
 
void setTextColor (ODCOLORREF color)
 
void setTooltip (const OdString &tooltip)
 
void setVisibility (bool state)
 
void setPrintability (bool state)
 
void setTextRotation (Text::Rotation rotation)
 
void setLock (bool state)
 
void setBorder (bool state)
 
void setBorderColor (ODCOLORREF color)
 
void setBorderThickness (Border::Thickness thickness)
 
void setBorderStyle (Border::Style style)
 
void setFillColor (ODCOLORREF color)
 
void setExportValue (const OdString &export_value)
 
void setDefaultState (bool state)
 
void setGrouping (bool state)
 
void getName (OdString &name) const
 
void getFont (Text::StorageType &storageType, Text::StandardFontsType &fontType, OdString &fontName, Text::FontStyle &fontStyle) const
 
void getFontSize (OdUInt16 &size) const
 
void getTextColor (ODCOLORREF &color) const
 
void getTooltip (OdString &tooltip) const
 
void getVisibility (bool &state) const
 
void getPrintability (bool &state) const
 
void getTextRotation (Text::Rotation &rotation) const
 
void getLock (bool &state) const
 
void getBorder (bool &state) const
 
void getBorderColor (ODCOLORREF &color) const
 
void getBorderThickness (Border::Thickness &thickness) const
 
void getBorderStyle (Border::Style &style) const
 
void getFillColor (ODCOLORREF &color) const
 
void getExportValue (OdString &export_value) const
 
void getDefaultState (bool &default_state) const
 
void getGrouping (bool &grouping) const
 
- Public Member Functions inherited from OdPdfPublish::OdObject
 ODRX_DECLARE_MEMBERS (OdObject)
 
 ODRX_HEAP_OPERATORS ()
 
virtual ~OdObject ()
 
virtual bool isEmpty () const
 
virtual bool isValid () const
 
virtual void clear ()
 
- Public Member Functions inherited from OdRxObject
 ODRX_HEAP_OPERATORS ()
 
 OdRxObject ()
 
virtual ~OdRxObject ()
 
virtual OdRxObjectqueryX (const OdRxClass *pClass) const
 
virtual OdRxObjectx (const OdRxClass *pClass) const
 
virtual OdRxClassisA () const
 
virtual void addRef ()=0
 
virtual void release ()=0
 
virtual long numRefs () const
 
bool isKindOf (const OdRxClass *pClass) const
 
virtual OdRxObjectPtr clone () const
 
virtual void copyFrom (const OdRxObject *pSource)
 
virtual OdRx::Ordering comparedTo (const OdRxObject *pOther) const
 
virtual bool isEqualTo (const OdRxObject *pOther) const
 

Protected Member Functions

 OdRadioButton ()
 
- Protected Member Functions inherited from OdPdfPublish::OdObject
 OdObject (OdPublishObjectImpl *pImpl)
 

Additional Inherited Members

- Static Public Member Functions inherited from OdRxObject
static OdRxObjectPtr cast (const OdRxObject *pointer)
 
static OdRxClassdesc ()
 

Detailed Description

This class implements a radio button control contained in a .pdf document created with Publish SDK. A radio button represent a dependent option to be selected. An option is called dependent when several options are joined into a group and only one option from the group can be selected. Then the other options become unselected.

Definition at line 48 of file PdfPublishRadioButton.h.

Constructor & Destructor Documentation

◆ OdRadioButton()

OdPdfPublish::OdRadioButton::OdRadioButton ( )
protected

◆ ~OdRadioButton()

virtual OdPdfPublish::OdRadioButton::~OdRadioButton ( )
virtual

Destroys the radio button.

Member Function Documentation

◆ getBorder()

void OdPdfPublish::OdRadioButton::getBorder ( bool &  state) const

Returns the current value of the flag that determines whether the radio button has a border. If the flag value is equal to true, the radio button has a border, otherwise it does not. The method fills a passed boolean value with the radio button border flag value and returns it to a calling subroutine.

Parameters
state[out] A placeholder for the flag value.

◆ getBorderColor()

void OdPdfPublish::OdRadioButton::getBorderColor ( ODCOLORREF color) const

Returns the current radio button border color. The method fills a passed ODCOLORREF value with the radio button border color value and returns it to a calling subroutine.

Parameters
color[out] A placeholder for the color value.

◆ getBorderStyle()

void OdPdfPublish::OdRadioButton::getBorderStyle ( Border::Style style) const

Returns the current radio button border style. The method fills a passed value with the current radio button border style and returns it to a calling subroutine.

Parameters
style[out] A placeholder for the border style.
See also
<link OdPdfPublish::Border::Style, Border::Style enumeration>.

◆ getBorderThickness()

void OdPdfPublish::OdRadioButton::getBorderThickness ( Border::Thickness thickness) const

Returns the current radio button border thickness. The method fills a passed value with the current radio button border thickness and returns it to a calling subroutine.

Parameters
thickness[out] A placeholder for the border thickness.
See also
<link OdPdfPublish::Border::Thickness, Border::Thickness enumeration>.

◆ getDefaultState()

void OdPdfPublish::OdRadioButton::getDefaultState ( bool &  default_state) const

Returns the current radio button default state. If the default state is equal to true, the radio button is switched on when it is displayed in a document, otherwise the radio button is switched off. The method fills a boolean object with the radio button default state value and returns it to a calling subroutine.

Parameters
default_state[out] A placeholder for the default state value.

◆ getExportValue()

void OdPdfPublish::OdRadioButton::getExportValue ( OdString export_value) const

Returns the current export value for the radio button. The method fills a passed string object with the radio button export value and returns it to a calling subroutine.

Parameters
export_value[out] A placeholder for the export value.

◆ getFillColor()

void OdPdfPublish::OdRadioButton::getFillColor ( ODCOLORREF color) const

Returns the current radio button fill color. The method fills a passed ODCOLORREF value with the radio button fill color value and returns it to a calling subroutine.

Parameters
color[out] A placeholder for the color value.

◆ getFont()

void OdPdfPublish::OdRadioButton::getFont ( Text::StorageType storageType,
Text::StandardFontsType fontType,
OdString fontName,
Text::FontStyle fontStyle 
) const

Returns current font parameters used for displaying the radio button caption. The method fills passed values and returns them to a calling subroutine.

Parameters
storageType[out] A placeholder for the storage type value.
fontType[out] A placeholder for the font type that should be used for displaying the radio button caption.
fontName[out] A placeholder for the font name that should be used for displaying the radio button caption.
fontStyle[out] A placeholder for the font style that should be used for displaying the radio button caption.
See also
<link OdPdfPublish::Text::StorageType, Text::StorageType enumeration> <link OdPdfPublish::Text::StandardFontsType, Text::StandardFontsType enumeration> <link OdPdfPublish::Text::FontStyle, Text::FontStyle enumeration>

◆ getFontSize()

void OdPdfPublish::OdRadioButton::getFontSize ( OdUInt16 size) const

Returns the current font size used for displaying the radio button caption. The method fills a passed integer value with the radio button caption font size and returns it to a calling subroutine.

Parameters
size[out] A placeholder for the font size that should be used for the radio button caption.

◆ getGrouping()

void OdPdfPublish::OdRadioButton::getGrouping ( bool &  grouping) const

Returns the current value of the group flag that determines whether the radio button is included in a group of radio buttons. If the flag value is equal to true, the radio button is in a group, otherwise it is a standalone radio button. The method fills a passed boolean value with the current flag value and returns it to a calling subroutine.

Parameters
grouping[out] A new flag value.

◆ getLock()

void OdPdfPublish::OdRadioButton::getLock ( bool &  state) const

Returns the current value of the flag that determines whether the radio button is locked. If the flag value is equal to true, the radio button is locked and becomes disabled, otherwise it is enabled and unlocked. The method fills a passed boolean value with the radio button lock flag value and returns it to a calling subroutine.

Parameters
state[out] A placeholder for the flag value.

◆ getName()

void OdPdfPublish::OdRadioButton::getName ( OdString name) const

Returns the current name of the radio button. The method fills a passed string object with the radio button name and returns it to a calling subroutine.

Parameters
name[out] A placeholder for the radio button name.

◆ getPrintability()

void OdPdfPublish::OdRadioButton::getPrintability ( bool &  state) const

Returns the current value of the flag that determines whether the radio button should be printed. If the radio button should be printed, the flag value is equal to true, otherwise it is equal to false. The method fills a passed boolean value with the radio button printability flag value and returns it to a calling subroutine.

Parameters
state[out] A placeholder for the flag value.

◆ getTextColor()

void OdPdfPublish::OdRadioButton::getTextColor ( ODCOLORREF color) const

Returns the current text color used for displaying the radio button caption. The method fills a passed ODCOLORREF value with the radio button caption color and returns it to a calling subroutine.

Parameters
color[out] A placeholder for the text color that should be used for the radio button caption.

◆ getTextRotation()

void OdPdfPublish::OdRadioButton::getTextRotation ( Text::Rotation rotation) const

Returns the current value of the radio text rotation. The method fills a passed value with the current text rotation value and returns it to a calling subroutine.

Parameters
rotation[out] A placeholder for the text rotation value.
See also
<link OdPdfPublish::Text::Rotation, Text::Rotation enumeration>.

◆ getTooltip()

void OdPdfPublish::OdRadioButton::getTooltip ( OdString tooltip) const

Returns the current tooltip text for the radio button. Tooltip text is text that appears when a user hovers the mouse pointer over the radio button.

The method fills a passed string object with the radio button tooltip text and returns it to a calling subroutine.

Parameters
tooltip[out] A placeholder for the tooltip text.

◆ getVisibility()

void OdPdfPublish::OdRadioButton::getVisibility ( bool &  state) const

Returns the current value of the visibility flag for the radio button. The visibility flag determines whether the radio button is visible in a document (if true) or is hidden (if false). The method fills a passed boolean value with the radio button visibility flag value and returns it to a calling subroutine.

Parameters
state[out] A placeholder for the flag value.

◆ ODRX_DECLARE_MEMBERS()

OdPdfPublish::OdRadioButton::ODRX_DECLARE_MEMBERS ( OdRadioButton  )

◆ ODRX_HEAP_OPERATORS()

OdPdfPublish::OdRadioButton::ODRX_HEAP_OPERATORS ( )

◆ setBorder()

void OdPdfPublish::OdRadioButton::setBorder ( bool  state)

Sets a new value for the flag that determines whether the radio button has a border. If the flag value is equal to true, the radio button has a border, otherwise it does not.

Parameters
state[in] A new flag value.

◆ setBorderColor()

void OdPdfPublish::OdRadioButton::setBorderColor ( ODCOLORREF  color)

Sets the radio button border color.

Parameters
color[in] A new color value.

◆ setBorderStyle()

void OdPdfPublish::OdRadioButton::setBorderStyle ( Border::Style  style)

Sets the radio button border style.

Parameters
style[in] A new border style.
See also
<link OdPdfPublish::Border::Style, Border::Style enumeration>.

◆ setBorderThickness()

void OdPdfPublish::OdRadioButton::setBorderThickness ( Border::Thickness  thickness)

Sets the radio button border thickness.

Parameters
thickness[in] A new border thickness value.
See also
<link OdPdfPublish::Border::Thickness, Border::Thickness enumeration>.

◆ setDefaultState()

void OdPdfPublish::OdRadioButton::setDefaultState ( bool  state)

Sets the radio button default state. If the default state is equal to true, the radio button is switched on when it is displayed in a document, otherwise the radio button is switched off.

Parameters
state[in] A new default state.

◆ setExportValue()

void OdPdfPublish::OdRadioButton::setExportValue ( const OdString export_value)

Sets an export value for the radio button.

Parameters
export_value[in] A new export value.

◆ setFillColor()

void OdPdfPublish::OdRadioButton::setFillColor ( ODCOLORREF  color)

Sets the radio button fill color.

Parameters
color[in] A new color value.

◆ setFont() [1/2]

void OdPdfPublish::OdRadioButton::setFont ( const OdString fontName,
Text::FontStyle  fontStyle = Text::kRegular 
)

Sets the radio button font name and style.

Parameters
fontName[in] A new font name.
fontStyle[in] A new font style.
Remarks
This method can set a font that is not in the list of <link OdPdfPublish::Text::StandardFontsType, standard fonts>. By default the <link OdPdfPublish::Text::StandardFontsType::kTimesRoman, normal Times New Roman font> is used.
See also
<link OdPdfPublish::Text::FontStyle, Text::FontStyle enumeration> <link OdPdfPublish::Text::StandardFontsType, StandardFontsType enumeration>

◆ setFont() [2/2]

void OdPdfPublish::OdRadioButton::setFont ( Text::StandardFontsType  fontType)

Sets the radio button font type from the list of <link OdPdfPublish::Text::StandardFontsType, predefined fonts>.

Parameters
fontType[in] A new font type value.
See also
<link OdPdfPublish::Text::StandardFontsType, Text::StandardFontsType enumeration>.

◆ setFontSize()

void OdPdfPublish::OdRadioButton::setFontSize ( OdUInt16  size)

Sets a font size for the radio button.

Parameters
size[in] A new font size value of the radio button.

◆ setGrouping()

void OdPdfPublish::OdRadioButton::setGrouping ( bool  state)

Sets a new value for the flag that determines whether the radio button is included in a group of radio buttons. If the flag value is equal to true, the radio button is in a group, otherwise it is a standalone radio button.

Parameters
state[in] A new flag value.

◆ setLock()

void OdPdfPublish::OdRadioButton::setLock ( bool  state)

Sets a new value for the flag that determines whether the radio button is locked. If the flag value is equal to true, the radio button is locked and becomes disabled, otherwise it is enabled and unlocked.

Parameters
state[in] A new flag value.

◆ setName()

void OdPdfPublish::OdRadioButton::setName ( const OdString name)

Sets the radio button name.

Parameters
name[in] A new radio button name.
Remarks
The name is mandatory and must be unique among the document object names.

◆ setPrintability()

void OdPdfPublish::OdRadioButton::setPrintability ( bool  state)

Sets a new value for the flag that determines whether the radio button should be printed. If the radio button should be printed, the flag value is equal to true, otherwise it is equal to false.

Parameters
state[in] A new flag value.

◆ setTextColor()

void OdPdfPublish::OdRadioButton::setTextColor ( ODCOLORREF  color)

Sets a text color for the radio button.

Parameters
color[in] A new color value.

◆ setTextRotation()

void OdPdfPublish::OdRadioButton::setTextRotation ( Text::Rotation  rotation)

Sets a new value for the radio button text rotation.

Parameters
rotation[in] A new text rotation value.
See also
<link OdPdfPublish::Text::Rotation, Text::Rotation enumeration>.

◆ setTooltip()

void OdPdfPublish::OdRadioButton::setTooltip ( const OdString tooltip)

Sets tooltip text for the radio button. Tooltip text is text that appears when a user hovers the mouse pointer over the radio button.

Parameters
tooltip[in] A new value of the tooltip text.

◆ setVisibility()

void OdPdfPublish::OdRadioButton::setVisibility ( bool  state)

Sets a new value for the visibility flag for the radio button. The visibility flag determines whether the radio button is visible in a document (if true) or is hidden (if false).

Parameters
state[in] A new flag value.

The documentation for this class was generated from the following file: