c4d.gui.TreeViewFunctions ¶

Inherit this class to supply a data and view model for c4d.gui.TreeViewCustomGui . Create an instance of the implementated class and pass it to TreeViewCustomGui.SetRoot() .

Definition ¶

class c4d.gui. TreeViewFunctions ¶

• TreeViewFunctions.GetFirst()
• TreeViewFunctions.GetDown()
• TreeViewFunctions.GetNext()
• TreeViewFunctions.GetPred()

• TreeViewFunctions.GetColumnWidth()
• TreeViewFunctions.GetHeaderColumnWidth()
• TreeViewFunctions.GetMinHeaderHeight()
• TreeViewFunctions.GetLineHeight()

• TreeViewFunctions.GetColors()
• TreeViewFunctions.GetBackgroundColor()

• TreeViewFunctions.DrawCell()
• TreeViewFunctions.DrawHeaderCell()

• TreeViewFunctions.IsSelected()
• TreeViewFunctions.Select()

• TreeViewFunctions.IsOpened()
• TreeViewFunctions.Open()

• TreeViewFunctions.GetName()
• TreeViewFunctions.SetName()

• TreeViewFunctions.GetID()

• TreeViewFunctions.IsChecked()
• TreeViewFunctions.SetCheck()

• TreeViewFunctions.IsTristate()

• TreeViewFunctions.GetDragType()
• TreeViewFunctions.AcceptDragObject()
• TreeViewFunctions.GenerateDragArray()
• TreeViewFunctions.DragStart() NEW
• TreeViewFunctions.SetDragObject() NEW

• TreeViewFunctions.InsertObject()

• TreeViewFunctions.CreateContextMenu()
• TreeViewFunctions.ContextMenuCall()

• TreeViewFunctions.GetHeaderSortArrow()
• TreeViewFunctions.IsResizeColAllowed()
• TreeViewFunctions.IsMoveColAllowed()

• TreeViewFunctions.InputEvent()
• TreeViewFunctions.MouseDown()
• TreeViewFunctions.DoubleClick()
• TreeViewFunctions.DeletePressed()
• TreeViewFunctions.HeaderClick()

• TreeViewFunctions.Scrolled()
• TreeViewFunctions.PaintFinished()
• TreeViewFunctions.SelectionChanged()

Members ¶

TreeViewFunctions. GetFirst ( self , root , userdata ) ¶

Called to retrieve the first object of the tree.

Parameters:	root ( any ) – The tree root passed to TreeViewCustomGui.SetRoot() . userdata ( any ) – The user data passed to TreeViewCustomGui.SetRoot() .
Return type:	any
Returns:	The first object.

TreeViewFunctions. GetDown ( self , root , userdata , obj ) ¶

Called to retrieve the first child of obj .

Parameters:	root ( any ) – The tree root passed to TreeViewCustomGui.SetRoot() . userdata ( any ) – The user data passed to TreeViewCustomGui.SetRoot() . obj ( any ) – An object in the tree.
Return type:	any
Returns:	The first child of obj .

TreeViewFunctions. GetNext ( self , root , userdata , obj ) ¶

Called to retrieve the object after obj .

Parameters:	root ( any ) – The tree root passed to TreeViewCustomGui.SetRoot() . userdata ( any ) – The user data passed to TreeViewCustomGui.SetRoot() . obj ( any ) – An object in the tree.
Return type:	any
Returns:	The object after obj .

TreeViewFunctions. GetPred ( self , root , userdata , obj ) ¶

Called to retrieve the object before obj .

Note

This is only used for drag and drop checks.

Parameters:	root ( any ) – The tree root passed to TreeViewCustomGui.SetRoot() . userdata ( any ) – The user data passed to TreeViewCustomGui.SetRoot() . obj ( any ) – An object in the tree.
Return type:	any
Returns:	The object before obj .

TreeViewFunctions. GetColumnWidth ( self , root , userdata , obj , col , area ) ¶

Called to retrieve the column width of object obj in column col .

Parameters:	root ( any ) – The tree root passed to TreeViewCustomGui.SetRoot() . userdata ( any ) – The user data passed to TreeViewCustomGui.SetRoot() . obj ( any ) – An object in the tree. col ( int ) – The column index. area ( c4d.gui.GeUserArea ) – The user area used to determine the text width with GeUserArea.DrawGetTextWidth() .
Return type:	int
Returns:	The column width.

TreeViewFunctions. GetHeaderColumnWidth ( self , root , userdata , col , area ) ¶

Called to retrieve the width of the header for column col .

Parameters:	root ( any ) – The tree root passed to TreeViewCustomGui.SetRoot() . userdata ( any ) – The user data passed to TreeViewCustomGui.SetRoot() . col ( int ) – The column index. area ( c4d.gui.GeUserArea ) – The user area used to determine the text width with GeUserArea.DrawGetTextWidth() .
Return type:	int
Returns:	The header column width, or a negative number for auto header width.

TreeViewFunctions. GetMinHeaderHeight ( self , root , userdata , area ) ¶

Called to retrieve the minimum header height.

Parameters:	root ( any ) – The tree root passed to TreeViewCustomGui.SetRoot() . userdata ( any ) – The user data passed to TreeViewCustomGui.SetRoot() . area ( c4d.gui.GeUserArea ) – The user area used to determine the text height with GeUserArea.DrawGetFontHeight() .
Return type:	int
Returns:	The minimum header height, or a negative value for auto header height.

TreeViewFunctions. GetLineHeight ( self , root , userdata , obj , col , area ) ¶

Called to retrieve the line height of object obj in column col . Always return a positive value.

Parameters:	root ( any ) – The tree root passed to TreeViewCustomGui.SetRoot() . userdata ( any ) – The user data passed to TreeViewCustomGui.SetRoot() . obj ( any ) – An object in the tree. col ( int ) – The column index. area ( c4d.gui.GeUserArea ) – The user area used to determine the text height with GeUserArea.DrawGetFontHeight() .
Return type:	int
Returns:	The line height.

TreeViewFunctions. GetColors ( self , root , userdata , obj ) ¶

Called to specify the text colors of object obj .

Parameters:	root ( any ) – The tree root passed to TreeViewCustomGui.SetRoot() . userdata ( any ) – The user data passed to TreeViewCustomGui.SetRoot() . obj ( any ) – An object in the tree.
Return type:	tuple(int or c4d.Vector , int or c4d.Vector ) or list(int or c4d.Vector , int or c4d.Vector )
Returns:	The normal and selected text color as color ID or vector.

TreeViewFunctions. GetBackgroundColor ( self , root , userdata , obj , line ) ¶

Called to specify the background color of line .

Parameters:	root ( any ) – The tree root passed to TreeViewCustomGui.SetRoot() . userdata ( any ) – The user data passed to TreeViewCustomGui.SetRoot() . obj ( any ) – An object in the tree. line ( int ) – The line index.
Return type:	int or c4d.Vector
Returns:	The background color for line as color ID or vector.

TreeViewFunctions. DrawCell ( self , root , userdata , obj , col , drawinfo ) ¶

Called to draw the cell for object obj in column col into the user area in drawinfo[‘frame’] .

Parameters:	root ( any ) – The tree root passed to TreeViewCustomGui.SetRoot() . userdata ( any ) – The user data passed to TreeViewCustomGui.SetRoot() . obj ( any ) – An object in the tree. col ( int ) – The column index. drawinfo ( dict ) – The draw information. See DrawInfo Dict .
Return type:	int or c4d.Vector
Returns:	The background color as color ID or vector.

TreeViewFunctions. DrawHeaderCell ( self , root , userdata , col , drawinfo ) ¶

Called to draw the header for column col into the user area in drawinfo[‘frame’] .

Parameters:	root ( any ) – The tree root passed to TreeViewCustomGui.SetRoot() . userdata ( any ) – The user data passed to TreeViewCustomGui.SetRoot() . col ( int ) – The column index. drawinfo ( dict ) – The draw information. See DrawInfo Dict .
Return type:	bool
Returns:	True if the header has been drawn or False if the header should be drawn by the tree view.

TreeViewFunctions. IsSelected ( self , root , userdata , obj ) ¶

Called to retrieve the selection status of object obj .

Parameters:	root ( any ) – The tree root passed to TreeViewCustomGui.SetRoot() . userdata ( any ) – The user data passed to TreeViewCustomGui.SetRoot() . obj ( any ) – An object in the tree.
Return type:	bool
Returns:	True if the object is selected, otherwise False .

TreeViewFunctions. Select ( self , root , userdata , obj , mode ) ¶

Called to select object obj .

Parameters:	root ( any ) – The tree root passed to TreeViewCustomGui.SetRoot() . userdata ( any ) – The user data passed to TreeViewCustomGui.SetRoot() . obj ( any ) – An object in the tree. mode ( int ) – The selection mode: SELECTION_NEW Starts a new selection. SELECTION_ADD Adds to the current selection SELECTION_SUB Subtracts from the current selection.

TreeViewFunctions. IsOpened ( self , root , userdata , obj ) ¶

Called to retrieve the folding status of object obj .

Parameters:	root ( any ) – The tree root passed to TreeViewCustomGui.SetRoot() . userdata ( any ) – The user data passed to TreeViewCustomGui.SetRoot() . obj ( any ) – An object in the tree.
Return type:	bool
Returns:	True if the object is opened, otherwise False .

TreeViewFunctions. Open ( self , root , userdata , obj , onoff ) ¶

Called to open or close object obj .

Parameters:	root ( any ) – The tree root passed to TreeViewCustomGui.SetRoot() . userdata ( any ) – The user data passed to TreeViewCustomGui.SetRoot() . obj ( any ) – An object in the tree. onoff ( bool ) – True if obj should be opened, otherwise False .

TreeViewFunctions. GetName ( self , root , userdata , obj ) ¶

Called to retrieve the name of object obj .

Parameters:	root ( any ) – The tree root passed to TreeViewCustomGui.SetRoot() . userdata ( any ) – The user data passed to TreeViewCustomGui.SetRoot() . obj ( any ) – An object in the tree.
Return type:	str
Returns:	The object name.

TreeViewFunctions. SetName ( self , root , userdata , obj , str ) ¶

Called to set the name of object obj .

Parameters:	root ( any ) – The tree root passed to TreeViewCustomGui.SetRoot() . userdata ( any ) – The user data passed to TreeViewCustomGui.SetRoot() . obj ( any ) – An object in the tree. str ( str ) – The new object name.

TreeViewFunctions. GetID ( self , root , userdata , obj ) ¶

Called to retrieve the ID of object obj .

Parameters:	root ( any ) – The tree root passed to TreeViewCustomGui.SetRoot() . userdata ( any ) – The user data passed to TreeViewCustomGui.SetRoot() . obj ( any ) – An object in the tree.
Return type:	int
Returns:	The object ID.

TreeViewFunctions. IsChecked ( self , root , userdata , obj , lColumn ) ¶

Called to retrieve the checkbox status of object obj for column lColumn .

Parameters:	root ( any ) – The tree root passed to TreeViewCustomGui.SetRoot() . userdata ( any ) – The user data passed to TreeViewCustomGui.SetRoot() . obj ( any ) – An object in the tree. lColumn ( int ) – The column index.
Return type:	int
Returns:	A combination of the following flags or c4d.NOTOK to show no checkbox: LV_CHECKBOX_ENABLED Checkbox is enabled. LV_CHECKBOX_CHECKED Checkbox is checked. LV_CHECKBOX_TRISTATE Checkbox tristate. LV_CHECKBOX_HIDE Checkbox is hidden.

TreeViewFunctions. SetCheck ( self , root , userdata , obj , lColumn , bCheck , bcMsg ) ¶

Called to set the checkbox status of object obj .

Parameters:

root ( any ) – The tree root passed to TreeViewCustomGui.SetRoot() . userdata ( any ) – The user data passed to TreeViewCustomGui.SetRoot() . obj ( any ) – An object in the tree. lColumn ( int ) – The column index. bCheck ( bool ) – True if the checkbox should be checked, otherwise False . bcMsg ( c4d.BaseContainer ) – The container originally sent to the GeUserArea.InputEvent() of the tree view’s user area.

TreeViewFunctions. IsTristate ( self , root , userdata ) ¶

Called to retrieve the tristate flag of the tree.

Parameters:	root ( any ) – The tree root passed to TreeViewCustomGui.SetRoot() . userdata ( any ) – The user data passed to TreeViewCustomGui.SetRoot() .
Return type:	bool
Returns:	True if the tristate flag is set, otherwise False .

TreeViewFunctions. GetDragType ( self , root , userdata , obj ) ¶

Called to retrieve the drag type of object obj , i.e. the type that the user would get if he started a drag in that cell.

Parameters:	root ( any ) – The tree root passed to TreeViewCustomGui.SetRoot() . userdata ( any ) – The user data passed to TreeViewCustomGui.SetRoot() . obj ( any ) – An object in the tree.
Return type:	int
Returns:	The object drag type, or c4d.NOTOK to disable drag-and-drop: DRAGTYPE_ATOMARRAY Atom array. The data is a list of c4d.C4DAtom . DRAGTYPE_CMDPALETTE Not supported. DRAGTYPE_COMMAND Not supported. DRAGTYPE_DESCID Description ID. The data is a dict(‘did’: c4d.DescID , ‘arr’: list of c4d.C4DAtom ). DRAGTYPE_ICON Not supported. DRAGTYPE_FILES Files. The data is a string with the filename. DRAGTYPE_FILENAME_IMAGE Image. The data is a string with the filename. DRAGTYPE_FILENAME_OTHER Other filename. The data is a string with the filename. DRAGTYPE_FILENAME_SCENE Scene filename. The data is a string with the filename. DRAGTYPE_MANAGER Not supported. DRAGTYPE_RGB RGB color. The data is a c4d.Vector . DRAGTYPE_RGB_ARRAY RGB color array. The data is a list of c4d.Vector .

TreeViewFunctions. AcceptDragObject ( self , root , userdata , obj , dragtype , dragobject ) ¶

Called to check if object obj can accept the specified drag-and-drop action, and in that case what the result would be.

Note

If obj is None then dragobject should be inserted as a child of the root.

Parameters:	root ( any ) – The tree root passed to TreeViewCustomGui.SetRoot() . userdata ( any ) – The user data passed to TreeViewCustomGui.SetRoot() . obj ( any ) – An object in the tree. dragtype ( int ) – The drag type: DRAGTYPE_ATOMARRAY Atom array. The data is a list of c4d.C4DAtom . DRAGTYPE_CMDPALETTE Not supported. DRAGTYPE_COMMAND Not supported. DRAGTYPE_DESCID Description ID. The data is a dict(‘did’: c4d.DescID , ‘arr’: list of c4d.C4DAtom ). DRAGTYPE_ICON Not supported. DRAGTYPE_FILES Files. The data is a string with the filename. DRAGTYPE_FILENAME_IMAGE Image. The data is a string with the filename. DRAGTYPE_FILENAME_OTHER Other filename. The data is a string with the filename. DRAGTYPE_FILENAME_SCENE Scene filename. The data is a string with the filename. DRAGTYPE_MANAGER Not supported. DRAGTYPE_RGB RGB color. The data is a c4d.Vector . DRAGTYPE_RGB_ARRAY RGB color array. The data is a list of c4d.Vector . dragobject ( any ) – The drag object.
Return type:	tuple(int, bool)
Returns:	A tuple with the following information: int: The insert mode: INSERT_BEFORE Insert before. INSERT_AFTER Insert after. INSERT_UNDER Insert under. Note The ACCEPT_DRAG_OBJECT_FORCE_COPY bit flag can be used together with the INSERT constants. bool: True if copying is allowed to this position, otherwise False .

TreeViewFunctions. GenerateDragArray ( self , root , userdata , obj ) ¶

Called to generate a drag array for object obj .

Parameters:	root ( any ) – The tree root passed to TreeViewCustomGui.SetRoot() . userdata ( any ) – The user data passed to TreeViewCustomGui.SetRoot() . obj ( any ) – An object in the tree.
Return type:	list of c4d.C4DAtom
Returns:	The drag objects for obj .

TreeViewFunctions. DragStart ( self , root , userdata , obj ) ¶

New in version R19.024.

Called to determine if object obj can be dragged or not and if dragged objects will be selected or not.

Parameters:	root ( any ) – The tree root passed to TreeViewCustomGui.SetRoot() . userdata ( any ) – The user data passed to TreeViewCustomGui.SetRoot() . obj ( any ) – An object in the tree.
Return type:	int
Returns:	A combination of the following flags: TREEVIEW_DRAGSTART_ALLOW Allow dragging. TREEVIEW_DRAGSTART_SELECT Select the picked object.

TreeViewFunctions. SetDragObject ( self , root , userdata , obj ) ¶

New in version R19.024.

Called to set the drag object to obj .

Note

Helps to determine if dragging happens internally (rearranged items) or externally (dragged items from another treeview for instance).

Parameters:	root ( any ) – The tree root passed to TreeViewCustomGui.SetRoot() . userdata ( any ) – The user data passed to TreeViewCustomGui.SetRoot() . obj ( any ) – An object in the tree.

TreeViewFunctions. InsertObject ( self , root , userdata , obj , dragtype , dragobject , insertmode , bCopy ) ¶

Called to insert dragobject as specified.

Parameters:

root ( any ) – The tree root passed to TreeViewCustomGui.SetRoot() . userdata ( any ) – The user data passed to TreeViewCustomGui.SetRoot() . obj ( any ) – An object in the tree. dragtype ( int ) – The drag type: DRAGTYPE_ATOMARRAY Atom array. The data is a list of c4d.C4DAtom . DRAGTYPE_CMDPALETTE Not supported. DRAGTYPE_COMMAND Not supported. DRAGTYPE_DESCID Description ID. The data is a dict(‘did’: c4d.DescID , ‘arr’: list of c4d.C4DAtom ). DRAGTYPE_ICON Not supported. DRAGTYPE_FILES Files. The data is a string with the filename. DRAGTYPE_FILENAME_IMAGE Image. The data is a string with the filename. DRAGTYPE_FILENAME_OTHER Other filename. The data is a string with the filename. DRAGTYPE_FILENAME_SCENE Scene filename. The data is a string with the filename. DRAGTYPE_MANAGER Not supported. DRAGTYPE_RGB RGB color. The data is a c4d.Vector . DRAGTYPE_RGB_ARRAY RGB color array. The data is a list of c4d.Vector . dragobject ( any ) – The drag object. insertmode ( int ) – The insert mode: INSERT_BEFORE Insert before. INSERT_AFTER Insert after. INSERT_UNDER Insert under. bCopy ( bool ) – True if the object should be copied, otherwise False .

TreeViewFunctions. CreateContextMenu ( self , root , userdata , obj , lColumn , bc ) ¶

Called to build a context menu for object obj and column lColumn . See c4d.gui.ShowPopupMenu() for the format.

Note

bc container already contains 2 default items: c4d.ID_TREEVIEW_CONTEXT_REMOVE and c4d.ID_TREEVIEW_CONTEXT_RESET . These may be removed. The added menu entry IDs must be larger than c4d.ID_TREEVIEW_FIRST_NEW_ID .

Parameters:	root ( any ) – The tree root passed to TreeViewCustomGui.SetRoot() . userdata ( any ) – The user data passed to TreeViewCustomGui.SetRoot() . obj ( any ) – An object in the tree. lColumn ( int ) – The column index. bc ( c4d.BaseContainer ) – Add context menu entries to this container.

TreeViewFunctions. ContextMenuCall ( self , root , userdata , obj , lColumn , lCommand ) ¶

Called by a command in the context menu setup in CreateContextMenu() .

Parameters:	root ( any ) – The tree root passed to TreeViewCustomGui.SetRoot() . userdata ( any ) – The user data passed to TreeViewCustomGui.SetRoot() . obj ( any ) – An object in the tree. lColumn ( int ) – The column index. lCommand ( int ) – The menu command ID.
Return type:	bool
Returns:	True if the command has been processed and the data needs to be updated, otherwise False .

TreeViewFunctions. GetHeaderSortArrow ( self , root , userdata , lColID ) ¶

Called to retrieve the sort mode of column lColID .

Parameters:	root ( any ) – The tree root passed to TreeViewCustomGui.SetRoot() . userdata ( any ) – The user data passed to TreeViewCustomGui.SetRoot() . lColID ( int ) – The column index.
Return type:	int
Returns:	The sort direction.

TreeViewFunctions. IsResizeColAllowed ( self , root , userdata , lColID ) ¶

Called to check if column lColID can be resized or not.

Parameters:	root ( any ) – The tree root passed to TreeViewCustomGui.SetRoot() . userdata ( any ) – The user data passed to TreeViewCustomGui.SetRoot() . lColID ( int ) – The column index.
Return type:	bool
Returns:	True if the column can be resized, otherwise False .

TreeViewFunctions. IsMoveColAllowed ( self , root , userdata , lColID ) ¶

Called to check if column lColID can be moved or not.

Parameters:	root ( any ) – The tree root passed to TreeViewCustomGui.SetRoot() . userdata ( any ) – The user data passed to TreeViewCustomGui.SetRoot() . lColID ( int ) – The column index.
Return type:	bool
Returns:	True if the column can be moved, otherwise False .

TreeViewFunctions. InputEvent ( self , root , userdata , pArea , msg ) ¶

Called when an input event is received. All information about the input event is stored in the msg container.

Parameters:	root ( any ) – The tree root passed to TreeViewCustomGui.SetRoot() . userdata ( any ) – The user data passed to TreeViewCustomGui.SetRoot() . pArea ( c4d.gui.GeUserArea ) – The user area of the tree view. msg ( c4d.BaseContainer ) – The event container.
Return type:	bool
Returns:	True if the event was handled, otherwise False .

TreeViewFunctions. MouseDown ( self , root , userdata , obj , col , mouseinfo , rightButton ) ¶

Called when a mouse down event is received.

Parameters:	root ( any ) – The tree root passed to TreeViewCustomGui.SetRoot() . userdata ( any ) – The user data passed to TreeViewCustomGui.SetRoot() . obj ( any ) – An object in the tree. col ( int ) – The column index. mouseinfo ( dict ) – The mouse information. See MouseInfo Dict . rightButton ( bool ) – True if the right mouse button was used, otherwise False .
Return type:	bool
Returns:	True if the event was handled, otherwise False .

TreeViewFunctions. DoubleClick ( self , root , userdata , obj , col , mouseinfo ) ¶

Called when a mouse double click event is received.

Parameters:	root ( any ) – The tree root passed to TreeViewCustomGui.SetRoot() . userdata ( any ) – The user data passed to TreeViewCustomGui.SetRoot() . obj ( any ) – An object in the tree. col ( int ) – The column index. mouseinfo ( dict ) – The mouse information. See MouseInfo Dict .
Return type:	bool
Returns:	True if the event was handled, otherwise False .

TreeViewFunctions. DeletePressed ( self , root , userdata ) ¶

Called when a delete event is received.

Parameters:	root ( any ) – The tree root passed to TreeViewCustomGui.SetRoot() . userdata ( any ) – The user data passed to TreeViewCustomGui.SetRoot() .

TreeViewFunctions. HeaderClick ( self , root , userdata , lColID , lChannel , bDblClk ) ¶

Called when a header has been clicked.

Parameters:	root ( any ) – The tree root passed to TreeViewCustomGui.SetRoot() . userdata ( any ) – The user data passed to TreeViewCustomGui.SetRoot() . lColID ( int ) – The column index. lChannel ( int ) – The mouse channel: BFM_INPUT_MOUSELEFT Left mouse button. BFM_INPUT_MOUSERIGHT Right mouse button. BFM_INPUT_MOUSEMIDDLE Middle mouse button. BFM_INPUT_MOUSEX1 Fourth mouse button. BFM_INPUT_MOUSEX2 Five mouse button. BFM_INPUT_MOUSEWHEEL Mouse wheel message. BFM_INPUT_MOUSEMOVE Mouse move message. bDblClk ( int ) – True for double-click event, otherwise False .
Return type:	bool
Returns:	True if the tree view needs to be updated, otherwise False .

TreeViewFunctions. Scrolled ( self , root , userdata , h , v , x , y ) ¶

Called when the tree view has been scrolled.

Parameters:	root ( any ) – The tree root passed to TreeViewCustomGui.SetRoot() . userdata ( any ) – The user data passed to TreeViewCustomGui.SetRoot() . h ( int ) – The horizontal scroll steps. v ( int ) – The vertical scroll steps. x ( int ) – The X offset. y ( int ) – The Y offset.

TreeViewFunctions. PaintFinished ( self , root , userdata ) ¶

Called when a paint selection has been performed in the tree view.

Parameters:	root ( any ) – The tree root passed to TreeViewCustomGui.SetRoot() . userdata ( any ) – The user data passed to TreeViewCustomGui.SetRoot() .

TreeViewFunctions. SelectionChanged ( self , root , userdata ) ¶

Called when selection has changed.

Parameters:	root ( any ) – The tree root passed to TreeViewCustomGui.SetRoot() . userdata ( any ) – The user data passed to TreeViewCustomGui.SetRoot() .

DrawInfo Dict ¶

bgCol	int or c4d.Vector	The background color ID or vector.
frame	c4d.gui.GeUserArea	The user area to draw in.
xpos	int	The position X coordinate.
ypos	int	The position Y coordinate.
width	int	The width.
height	int	The height.
line	int	The line.
col	int	The column.

MouseInfo Dict ¶

mx	float	The mouse X coordinate.
my	float	The mouse Y coordinate.
button	int	The mouse button:

MOUSEINFO_BUTTON_LEFT	Left button.
MOUSEINFO_BUTTON_RIGHT	Right button.
MOUSEINFO_BUTTON_MIDDLE	Middle button.

mxRelative

float

The mouse position relative to the end of the horizontal tree lines. Usually mouse coordinates are in list view space. This can become difficult when the user clicks into the LV_USERTREE column, hence this member.

startDrag	bool	Not used.
startpaint	bool

This is needed in the Layer Manager. The user can change the state of the column by clicking somewhere and dragging the mouse. To start this drag, set startpaint to True in TreeViewFunctions.MouseDown() .

inpaint

bool

This is needed in the Layer Manager. The user can change the state of the column by clicking somewhere and dragging the mouse. TreeViewFunctions.MouseDown() will be called for each line with inpaint set to True .

inputmsg	c4d.BaseContainer	The container originally sent to the GeUserArea.InputEvent() of the tree view’s user area. Never None .
frame	c4d.gui.GeUserArea	The user area to draw in.
xpos	int	The position X coordinate.
ypos	int	The position Y coordinate.
width	int	The width.
height	int	The height.
line	int	The line.
col	int	The column.

Table Of Contents

• c4d.gui.TreeViewFunctions
  • Definition
  • Members
  • DrawInfo Dict
  • MouseInfo Dict