#include <rhinoSdkLinetype.h>

Inheritance diagram for CRhinoLinetypeTable:

Public Member Functions
int	AddLinetype (const ON_Linetype &linetype, bool bReference=false)

int	AddLinetype (const wchar_t *linetype_name, ON_SimpleArray< double > &segments)

int	CreateLinetype (const ON_Linetype &linetype, unsigned int worksession_ref_model_sn, unsigned int linked_idef_sn)

const CRhinoLinetype &	CurrentLinetype () const

ON_UUID	CurrentLinetypeId () const

int	CurrentLinetypeIndex () const

ON::object_linetype_source	CurrentLinetypeSource () const

bool	DeleteLinetype (int linetype_index, bool bQuiet)

bool	DeleteLinetypes (int linetype_index_count, const int *linetype_index, bool bQuiet)

CRhinoDoc &	Document () const

int	FindLinePatternFromId (ON_UUID line_pattern_id, bool bSearchSystemLinePatterns, bool bSearchDeletedLinePatterns, int not_found_return_value) const

int	FindLinePatternFromName (const wchar_t *line_pattern_name, bool bSearchSystemLinePatterns, int not_found_return_value) const

int	FindLinetype (const wchar_t *line_pattern_name) const

void	GetSortedList (ON_SimpleArray< const CRhinoLinetype * > &sorted_list, bool bIgnoreDeleted, bool bIgnoreReferenced) const

void	GetSortedList (ON_SimpleArray< const CRhinoLinetype * > &sorted_list, bool bIgnoreDeleted=false) const

void	GetUnusedLinetypeName (const wchar_t *root_name, ON_wString &unused_line_pattern_name) const

void	GetUnusedLinetypeName (ON_wString &unused_line_pattern_name) const

void	InitDefaultLinetypes ()

void	InitDefaultLinetypes (bool bIgnoreDeleted)

bool	InUse (int linetype_index) const

int	LinetypeCount () const

double	LinetypeScale () const

void	ListTable (ON_TextLog &text_log, unsigned int level_of_detail) const

bool	ModifyLinetype (const ON_Linetype &linetype, int linetype_index, bool bQuiet=false)

const CRhinoLinetype &	operator[] (int) const

bool	SetCurrentLinetypeIndex (int linetype_index, bool bQuiet=false)

void	SetCurrentLinetypeSource (ON::object_linetype_source source)

void	SetLinetypeScale (double scale)

void	SetRemapIndex (int, int)

void	Sort (int(compare)(const CRhinoLinetype , const CRhinoLinetype , void ), int(cull)(const CRhinoLinetype , void ), void p=0)

int	SystemLinetypeCount () const

const class CRhinoDocTableReference &	TableReference () const

bool	UndeleteLinetype (int linetype_index)

bool	UndoModifyLinetype (int linetype_index, unsigned int ur_sn=0)

Public Attributes
const CRhinoLinetype &	ByLayerLinePattern
	index = -2; More...

const CRhinoLinetype &	ByParentLinePattern
	index = -3; More...

const CRhinoLinetype &	ContinuousLinePattern
	index = -1; More...

Friends
class	CRhinoDetailViewObject

class	CRhinoDoc

Member Function Documentation

◆ AddLinetype() [1/2]

int CRhinoLinetypeTable::AddLinetype	(	const ON_Linetype &	linetype,
		bool	bReference = `false`
	)

Description: Adds a new linetype with specified definition to the linetype table.

Parameters: linetype - [in] definition of new linetype. The information in linetype is copied. If linetype.LinetypeName() is empty the a unique name of the form "Linetype 01" will be automatically created.

bReference - [in] true if this linetype is a reference linetype. Reference linetypes are not saved in files.

Returns: @untitled table >=0 index of new linetype -1 linetype not added because a linetype with that name already exists.

Remarks: In some cases, calling AddLinetype() can cause the memory references previously returned by operator[] and CurrentLinetype() to become invalid.

◆ AddLinetype() [2/2]

int CRhinoLinetypeTable::AddLinetype	(	const wchar_t *	linetype_name,
		ON_SimpleArray< double > &	segments
	)

Description: Adds a new linetype to the linetype table. Parameters: linetype_name - [in] name for the new linetype segments - [in] array of segment lengths. Positive values are dashes, negative values are gaps Returns: @untitled table >=0 index of new linetype -1 linetype not added because a linetype with that name already exists or input is not valid.

◆ CreateLinetype()

int CRhinoLinetypeTable::CreateLinetype	(	const ON_Linetype &	linetype,
		unsigned int	worksession_ref_model_sn,
		unsigned int	linked_idef_sn
	)

Description: Basic tool used to create a new linetype with specified definition to the linetype table. The AddLinetype() functions all use CreateLinetype() when a new linetype needs to be added to the linetype table.

Parameters: linetype - [in] definition of new linetype. The information in linetype is copied. If linetype.LinetypeName() is empty the a unique name of the form "Linetype 01" will be automatically created.

worksession_ref_model_sn - [in] 0: linetype is not a reference layer 1: linetype is a reference linetype but not part of a worksession reference file 2-1000: reserved for future use >1000: worksession reference file serial number

linked_idef_sn - [in] 0: linetype is not from a liked instance definition 1-1000: reserved for future use >1000: linetype instance definition serial number

Returns: @untitled table >=0 index of new linetype -1 linetype not added because a linetype with that name already exists.

◆ CurrentLinetype()

const CRhinoLinetype& CRhinoLinetypeTable::CurrentLinetype ( ) const

Description: At all times, there is a "current" linetype. Unless otherwise specified, new objects are assigned to the current linetype. If the current linetype source is ON::linetype_from_layer, the object's layer's linetype is used instead

Returns: Reference to the current linetype. Note that this reference may become invalid after a call to AddLinetype().

◆ CurrentLinetypeId()

ON_UUID CRhinoLinetypeTable::CurrentLinetypeId ( ) const

◆ CurrentLinetypeIndex()

int CRhinoLinetypeTable::CurrentLinetypeIndex ( ) const

Description: At all times, there is a "current" linetype. Unless otherwise specified, new objects are assigned to the current linetype. If the current linetype source is ON::linetype_from_layer, the object's layer's linetype is used instead

Returns: Zero based linetype table index of the current linetype.

◆ CurrentLinetypeSource()

ON::object_linetype_source CRhinoLinetypeTable::CurrentLinetypeSource ( ) const

Description: Returns the source used by an object to determine its current linetype to be used by new objects. Default is ON::linetype_from_layer. Returns: The linetype source for new objects.

◆ DeleteLinetype()

bool CRhinoLinetypeTable::DeleteLinetype	(	int	linetype_index,
		bool	bQuiet
	)

Description: Deletes linetype

Parameters: linetype_index - [in] zero based index of linetype to delete. This must be in the range 0 <= linetype_index < LinetypeCount(). bQuiet - [in] If true, no warning message box appears if a linetype the linetype cannot be deleted because it is the current linetype or it contains active geometry.

Returns: true if successful. false if linetype_index is out of range or the the linetype cannot be deleted because it is the current linetype or because it linetype is referenced by active geometry.

◆ DeleteLinetypes()

bool CRhinoLinetypeTable::DeleteLinetypes	(	int	linetype_index_count,
		const int *	linetype_index,
		bool	bQuiet
	)

Description: Deletes multiple linetypes

Parameters: linetype_index_count - [in] length of linetype_index[] array. linetype_index - [in] array zero based indices of linetypes to delete. The indices must be in the range 0 <= linetype_index < LinetypeCount(). bQuiet - [in] If true, no warning message box appears if a linetype the linetype cannot be deleted because it is the current linetype or it contains active geometry.

Returns: true if successful. false if linetype_index is out of range or the the linetype cannot be deleted because it is the current linetype or because it linetype contains active geometry.

◆ Document()

CRhinoDoc& CRhinoLinetypeTable::Document ( ) const

Description: Linetype tables store the list of linetypes in a Rhino document.

Returns: CRhinoDocument that owns this linetype table.

◆ FindLinePatternFromId()

int CRhinoLinetypeTable::FindLinePatternFromId	(	ON_UUID	line_pattern_id,
		bool	bSearchSystemLinePatterns,
		bool	bSearchDeletedLinePatterns,
		int	not_found_return_value
	)		const

Description: Search for line patterns with a matching id. Parameters: line_pattern_id - [in] bSearchSystemLinePatterns - [in] If true, the system Continuous, By Layer, and By Parent line patterns are included in the search. bSearchDeletedLinePatterns - [in] If true, deleted line patterns are included in the search. not_found_return_value - [in] Value to return if no line pattern has a matching id. Depending on what should happen if the id is not found, CurrentLinetypeIndex(), ContinyousLinePattern.Index() and ON_UNSET_INT_INDEX are common choices for this value. Returns: The index of the matching line pattern is returned. If no match is found, then not_found_return_value is returned.

◆ FindLinePatternFromName()

int CRhinoLinetypeTable::FindLinePatternFromName	(	const wchar_t *	line_pattern_name,
		bool	bSearchSystemLinePatterns,
		int	not_found_return_value
	)		const

Description: Search for line patterns with a matching name. Parameters: line_pattern_name - [in] bSearchSystemLinePatterns - [in] If true, the system Continuous, By Layer, and By Parent line patterns are included in the search. not_found_return_value - [in] Value to return if no line pattern has a matching name. Depending on what should happen if the name is not found, CurrentLinetypeIndex(), ContinyousLinePattern.Index() and ON_UNSET_INT_INDEX are common choices for this value. Returns: The index of the matching line pattern is returned. If no match is found, then not_found_return_value is returned.

◆ FindLinetype()

int CRhinoLinetypeTable::FindLinetype ( const wchar_t * line_pattern_name ) const

Use FindLinePatternFromName() ON_DEPRECATED too many warnings - deal with this later

◆ GetSortedList() [1/2]

void CRhinoLinetypeTable::GetSortedList	(	ON_SimpleArray< const CRhinoLinetype * > &	sorted_list,
		bool	bIgnoreDeleted,
		bool	bIgnoreReferenced
	)		const

Description: Gets an array of pointers to linetypes whose value of CRhinoLinetype.m_sort_index != -1. The returned list is sorted by the value of CRhinoLinetype.m_sort_index.

Parameters: sorted_list - [out] this array is returned with length <= LinetypeCount() and is sorted by the values of CRhinoLinetype::m_sort_index.

bIgnoreDeleted - [in] true means don't include deleted linetypes.

bIgnoreDeleted - [in] true means don't include referenced linetypes. A "referenced" linetype is one from a worksession reference model or a linked instance definition model.

Remarks: Use Sort() to set the values of m_sort_index.

◆ GetSortedList() [2/2]

void CRhinoLinetypeTable::GetSortedList	(	ON_SimpleArray< const CRhinoLinetype * > &	sorted_list,
		bool	bIgnoreDeleted = `false`
	)		const

◆ GetUnusedLinetypeName() [1/2]

void CRhinoLinetypeTable::GetUnusedLinetypeName	(	const wchar_t *	root_name,
		ON_wString &	unused_line_pattern_name
	)		const

◆ GetUnusedLinetypeName() [2/2]

void CRhinoLinetypeTable::GetUnusedLinetypeName ( ON_wString & unused_line_pattern_name ) const

Description: Gets unused linetype name used as default when creating new linetypes. Parameters: unused_line_pattern_name - [out] new linetype name

◆ InitDefaultLinetypes() [1/2]

void CRhinoLinetypeTable::InitDefaultLinetypes ( )

Description: Fills in the linetype table with any default linetypes not already included

◆ InitDefaultLinetypes() [2/2]

void CRhinoLinetypeTable::InitDefaultLinetypes ( bool bIgnoreDeleted )

◆ InUse()

bool CRhinoLinetypeTable::InUse ( int linetype_index ) const

Description: Returns true if a linetype is use by an object, layer, or instance definition. Parameters: linetype_index - [in] zero based index of linetype to query. Returns: true if successful.

◆ LinetypeCount()

int CRhinoLinetypeTable::LinetypeCount ( ) const

Returns: Number of linetypes in the linetype table, including deleted linetypes.

◆ LinetypeScale()

double CRhinoLinetypeTable::LinetypeScale ( ) const

Description: For display in Rhino viewports, the linetypes are scaled by a single scale factor for all viewports. This is not used for printing, where all linetype patterns are scaled to print in their defined size 1:1 on the paper. Returns: The scale factor for linetype display

◆ ListTable()

void CRhinoLinetypeTable::ListTable	(	ON_TextLog &	text_log,
		unsigned int	level_of_detail
	)		const

◆ ModifyLinetype()

bool CRhinoLinetypeTable::ModifyLinetype	(	const ON_Linetype &	linetype,
		int	linetype_index,
		bool	bQuiet = `false`
	)

Description: Modify linetype settings

Parameters: linetype - [in] new settings. This information is copied. linetype_index - [in] zero based index of linetype to set. This must be in the range 0 <= linetype_index < LinetypeCount(). bQuiet - [in] if true, information message boxes pop up when illegal changes are attempted.

Returns: true if successful. false if linetype_index is out of range or the settings attempt to lock or hide the current linetype.

◆ operator[]()

const CRhinoLinetype& CRhinoLinetypeTable::operator[] ( int ) const

Description: Conceptually, the linetype table is an array of LinetypeCount() linetypes. The operator[] can be used to get individual linetypes. A linetype is either active or deleted and this state is reported by CRhinoLinetype::IsDeleted().

Parameters: linetype_index - zero based array index

Returns: Reference to the linetype. If linetype_index is out of range, the current linetype is returned. Note that this reference may become invalid after AddLinetype() is called.

◆ SetCurrentLinetypeIndex()

bool CRhinoLinetypeTable::SetCurrentLinetypeIndex	(	int	linetype_index,
		bool	bQuiet = `false`
	)

Description: At all times, there is a "current" linetype. Unless otherwise specified, new objects are assigned to the current linetype. If the current linetype source is ON::linetype_from_layer, the object's layer's linetype is used instead The current linetype is never deleted.

Parameters: linetype_index - [in] value for new current linetype. 0 <= linetype_index < LinetypeCount(). bQuiet - [in] if true, then no warning message box pops up if the current linetype request can't be satisfied. Returns: true if current linetype index successfully set.

◆ SetCurrentLinetypeSource()

void CRhinoLinetypeTable::SetCurrentLinetypeSource ( ON::object_linetype_source source )

Description: Set the source to be used by new objects to determine their current linetype Parameter: source - the new current linetype source

◆ SetLinetypeScale()

void CRhinoLinetypeTable::SetLinetypeScale ( double scale )

Parameter: New scale factor for linetype display

◆ SetRemapIndex()

void CRhinoLinetypeTable::SetRemapIndex	(	int	,
		int
	)

◆ Sort()

void CRhinoLinetypeTable::Sort	(	int()(const CRhinoLinetype , const CRhinoLinetype , void )	compare,
		int()(const CRhinoLinetype , void *)	cull,
		void *	p = `0`
	)

Description: Use this to set CRhinoLinetype::m_sort_index so that the values of m_sort_index run from 0 to LinetypeCount()-1 and compare(linetype_table[i],linetype_table[j]) < 0 ) implies linetype_table[i].m_sort_index < linetype_table[j].m_sort_index.

Parameters: compare - [in] compare function with prototype int compare(const CRhinoLinetype* arg1,const CRhinoLinetype* arg2,void* p). that returns <0 if arg1<arg2, 0 if arg1=arg2, and >0 if arg1>arg2. cull - [in] optional filter function with prototype bool cull(const CRhinoLinetype* arg,void* p). that returns true if the linetype should be ignored when sorting. Linetypes that are ignored are not included in the list returned by GetSortedList(). Pass 0 if you do not need to cull linetypes p - [in] pointer passed as last argument to compare() and cull().

Remarks: After calling Sort(), you can repeatedly call GetSortedList() to get a sorted list of CRhinoLinetype pointers. Sort() and GetSortedList() do not modify the order or persistent information in the linetype table. They are intended to be used to get sorted lists of linetypes for dialogs, etc.

◆ SystemLinetypeCount()

int CRhinoLinetypeTable::SystemLinetypeCount ( ) const

Description: Returns the number of system linetypes, or those that are implied members of the linetype table.

◆ TableReference()

const class CRhinoDocTableReference& CRhinoLinetypeTable::TableReference ( ) const

◆ UndeleteLinetype()

bool CRhinoLinetypeTable::UndeleteLinetype ( int linetype_index )

Description: Undeletes a linetype that has been deleted by DeleteLinetype().

Parameters: linetype_index - [in] zero based index of linetype to undelete. This must be in the range 0 <= linetype_index < LinetypeCount().

Returns: true if successful.

◆ UndoModifyLinetype()

bool CRhinoLinetypeTable::UndoModifyLinetype	(	int	linetype_index,
		unsigned int	ur_sn = `0`
	)

Description: If the linetype has been modified and the modification can be undone, then UndoModify() will restore the linetype to its previous state.

Returns: true if this linetype had been modified and the modifications were undone.

Friends And Related Function Documentation

◆ CRhinoDetailViewObject

friend class CRhinoDetailViewObject

friend

◆ CRhinoDoc

friend class CRhinoDoc