Open Reality Reference Guide
FBToolLayoutManager Class Reference

Tool Layout Manager class. More...

#include <fbtoollayoutmanager.h>

Inheritance diagram for FBToolLayoutManager:

Public Member Functions

int GetFactoryLayoutCount ()
 Get the number of factory layouts. More...
 
int GetCustomLayoutCount ()
 Get the number of custom layouts. More...
 
const char * GetLayoutName (int pLayoutIdx)
 Get the layout name associated with the given layout index. More...
 
int GetCurrentLayoutIdx ()
 Get the layout index of the current layout. More...
 
const char * GetCurrentLayoutName ()
 Get the name of the current layout. More...
 
bool SetCurrentLayout (int pLayoutIdx)
 Set the current layout from the given layout index. More...
 
bool SetCurrentLayout (const char *pLayoutName)
 Set the current layout from the given layout name. More...
 
const char * CreateLayout (const char *pLayoutName)
 Create a new layout from the current layout state. More...
 
bool DeleteLayout (int pLayoutIdx)
 Delete the layout associated with the given layout index. More...
 
bool DeleteLayout (const char *pLayoutName)
 Delete the layout with the given layout name. More...
 
bool UpdateCurrentLayout ()
 Update the current layout from the current layout state. More...
 
const char * RenameLayout (const char *pOldLayoutName, const char *pNewLayoutName)
 Rename a layout. More...
 
bool GetAutoUpdateLayout ()
 Get the 'Auto-update Layout' state value. More...
 
bool SetAutoUpdateLayout (bool pAutoUpdate)
 Set the 'Auto-update Layout' state value. More...
 
bool GetPreventDocking ()
 Get the 'Prevent Docking' state value. More...
 
bool SetPreventDocking (bool pPreventDocking)
 Set the 'Prevent Docking' state value. More...
 
- Public Member Functions inherited from FBComponent
 FBComponent (HIObject pObject)
 Constructor. More...
 
virtual ~FBComponent ()
 Destructor. More...
 
virtual bool FBCreate ()
 Open Reality Creation function. More...
 
virtual void FBDestroy ()
 Open Reality destruction function. More...
 
virtual void FBDelete () override
 Open Reality deletion function. More...
 
virtual bool SetHIObject (HIObject pObject, bool pSDKComponent) override
 Assign component to an internal pointer. More...
 
virtual int PropertyAdd (FBProperty *pProperty)
 Add a property to the component's property manager. More...
 
bool PropertyAddReferenceProperty (FBProperty *pReferenceProperty)
 Add a reference property to the component's property manager. More...
 
void PropertyRemove (FBProperty *pProperty)
 Remove a Property from the component's Property manager. More...
 
void PropertyGetModifiedList (FBArrayTemplate< FBProperty * > &pPropList, FBPlugModificationFlag pModificationFlags)
 Get list of properties which have been modified since last loading. More...
 
FBPropertyPropertyCreate (const char *pName, FBPropertyType pType, const char *pDataType, bool pAnimatable, bool pIsUser=false, FBProperty *pReferenceSource=NULL)
 Create user or dynamic property. More...
 
FBObjectFlag GetObjectFlags ()
 Get all Object Flags (concatenated). More...
 
void SetObjectFlags (FBObjectFlag pFlags)
 SetObjectFlags. More...
 
bool HasObjectFlags (FBObjectFlag pFlags)
 Check whether a specific object flag is enabled. More...
 
void EnableObjectFlags (FBObjectFlag pFlags)
 Enable a specific Object Flags. More...
 
void DisableObjectFlags (FBObjectFlag pFlags)
 Disable a specific Object Flags. More...
 
void SetObjectStatus (FBObjectStatus pStatus, bool pValue)
 Enable/Disable a specific Object Status. More...
 
bool GetObjectStatus (FBObjectStatus pStatus)
 Check to see if an object status is enabled. More...
 
bool ProcessNamespaceHierarchy (FBNamespaceAction pNamespaceAction, const char *pNamespaceName, const char *pReplaceTo=NULL, bool pAddRight=true)
 ProcessNamespaceHierarchy. More...
 
bool ProcessObjectNamespace (FBNamespaceAction pNamespaceAction, const char *pNamespaceName, const char *pReplaceTo=NULL, bool pAddRight=true)
 ProcessObjectNamespace. More...
 
virtual const char * ClassName () override
 Get the class name. More...
 
virtual bool UseCustomPropertyViewSet () const
 Use the custom property viewSet or not. More...
 
const char * GetFullName (void)
 Get the full name. More...
 
void SetOwnerNamespace (FBNamespace *pOwnerNSObj)
 Set the owner Namespace object. More...
 
FBNamespaceGetOwnerNamespace (void)
 Get the owner Namespace object. More...
 
FBFileReferenceGetOwnerFileReference (void)
 Get the owner FileReference object. More...
 
void HardSelect ()
 HardSelect. More...
 
virtual bool Is (int pTypeId) override
 Returns true if object is of type TypeId. More...
 
virtual int GetTypeId () override
 GetTypeId( int pTypeId ) More...
 
- Public Member Functions inherited from FBWrapperHolder
FBScriptWrapperGetWrapper ()
 Return the wrapper interface of this FBObject. More...
 
void AddWrapper (FBScriptWrapper *)
 
void RemoveWrapper (FBScriptWrapper *)
 

Static Public Member Functions

static FBToolLayoutManagerTheOne ()
 Returns the only instance of FBToolLayoutManager. More...
 
- Static Public Member Functions inherited from FBComponent
static int GetInternalClassId ()
 
static void FBComponentSetName (FBComponent *pObject, const char *pName)
 
static const char * FBComponentGetName (FBComponent *pObject)
 
static void FBComponentSetLongName (FBComponent *pObject, const char *pName)
 
static const char * FBComponentGetLongName (FBComponent *pObject)
 

Protected Member Functions

 FBToolLayoutManager ()
 Constructor. More...
 
- Protected Member Functions inherited from FBPlug
bool IsSDKComponent ()
 Return whether or not item is an SDK component. More...
 
bool ConnectSrc (FBPlug *pSrc, FBConnectionType pConnectionType=kFBConnectionTypeNone)
 Add a source connection. More...
 
bool ConnectDst (FBPlug *pDst, FBConnectionType pConnectionType=kFBConnectionTypeNone)
 Add a destination connection. More...
 
bool ConnectSrcAt (int pDst_SrcIndex, FBPlug *pSrc, FBConnectionType pConnectionType=kFBConnectionTypeNone)
 Add a source connection. More...
 
bool ConnectDstAt (int pSrc_DstIndex, FBPlug *pDst, FBConnectionType pConnectionType=kFBConnectionTypeNone)
 Add a destination connection. More...
 
bool DisconnectDst (FBPlug *pDst)
 Remove a destination connection. More...
 
bool DisconnectSrc (FBPlug *pSrc)
 Remove a source connection. More...
 
void DisconnectAllSrc ()
 Remove all source connections. More...
 
void DisconnectAllDst ()
 Remove all destination connections. More...
 
bool DisconnectDstAt (int pIndex)
 Remove a destination connection at a specified index. More...
 
bool DisconnectSrcAt (int pIndex)
 Remove a source connection at a specified index. More...
 
bool ReplaceDstAt (int pIndex, FBPlug *pDst)
 Replace a destination connection at a specified index. More...
 
bool ReplaceSrcAt (int pIndex, FBPlug *pSrc)
 Replace a source connection at a specified index. More...
 
bool SwapSrc (int pIndexA, int pIndexB)
 Swap source connection at index A with source connection at index B. More...
 
bool MoveSrcAt (int pIndex, int pAtIndex)
 Move source connection at pIndex to pAtIndex. More...
 
bool MoveSrcAt (FBPlug *pSrc, FBPlug *pAtSrc)
 Move source connection pSrc to the position of pAtSrc. More...
 
int GetSrcCount ()
 Get source connection count. More...
 
FBPlugGetSrc (int pIndex)
 Get a source connection's plug at specified index. More...
 
FBConnectionType GetSrcType (int pIndex)
 Get a source connection's type at specified index. More...
 
int GetDstCount ()
 Get destination connection count. More...
 
FBPlugGetDst (int pIndex)
 Get a destination connection's plug at specified index. More...
 
FBConnectionType GetDstType (int pIndex)
 Get a destination connection's type at specified index. More...
 
bool BeginChange ()
 Begins a change on multiple plugs. More...
 
void EndChange ()
 Ends a change on multiple plugs. More...
 
void SetSelfModified (FBPlugModificationFlag pFlag, bool pBool)
 Set the plug's self modification flag. More...
 
bool GetSelfModified (FBPlugModificationFlag pFlag)
 Tell if the plug's self has changed. More...
 
void SetContentModified (FBPlugModificationFlag pFlag, bool pBool)
 Set the plug's owned property/object's modification flag. More...
 
bool GetContentModified (FBPlugModificationFlag pFlag)
 Tell if the plug's content has changed. More...
 
int GetPlugConnectionModifiedList (FBPlugList &pPlugList, FBPlugModificationFlag pConnectionModificatonFlag, bool pAddRemove)
 Get plug's modified src/dst property/object connection added/removed List. More...
 
bool RevertModification (FBPlugModificationFlag pFlag=kFBAllModifiedMask)
 Revert the plug's modification to original status. More...
 
void SetStatusFlag (FBPlugStatusFlag pStatus, bool pValue)
 Set the plug's status flag. More...
 
bool GetStatusFlag (FBPlugStatusFlag pStatus) const
 Tell if the plug's status has changed. More...
 
FBPlugGetOwner ()
 Get the owner of this plug. More...
 
FBPlugGetOwned (int pIndex)
 Get the owned plug at specified index. More...
 
int GetOwnedCount ()
 Get the owned plug count. More...
 
virtual bool PlugDataNotify (FBConnectionAction pAction, FBPlug *pThis, void *pData=NULL, void *pDataOld=NULL, int pDataSize=0)
 PlugDataNotify when overloaded is equivalent of FBSystem.OnConnectionDataNotify but in the context of the derived object only. More...
 
virtual bool PlugStateNotify (FBConnectionAction pAction, FBPlug *pThis, void *pData=NULL, void *pDataOld=NULL, int pDataSize=0)
 PlugStateNotify when overloaded is equivalent of FBSystem.OnConnectionStateNotify but in the context of the derived object only. More...
 
virtual bool PlugNotify (FBConnectionAction pAction, FBPlug *pThis, int pIndex, FBPlug *pPlug=NULL, FBConnectionType pConnectionType=kFBConnectionTypeNone, FBPlug *pNewPlug=NULL)
 PlugNotify when overloaded is equivalent of FBSystem.OnConnectionNotify but in the context of the derived object only. More...
 

Additional Inherited Members

- Public Attributes inherited from FBComponent
FBPropertyManager PropertyList
 Read Only Property: Manages all of the properties for the component. More...
 
FBPropertyListComponent Components
 List: List of components. More...
 
FBPropertyListComponent Parents
 List: Parents. More...
 
FBPropertyBool Selected
 Read Write Property: Selected property. More...
 
FBPropertyString Name
 Read Write Property: Unique name of object. More...
 
FBPropertyString LongName
 Read Write Property: Name and namespace for object.
More...
 
FBPropertyFolder Folder
 Read Write Property: The folder that contain this component. More...
 
- Static Public Attributes inherited from FBComponent
static int TypeInfo
 Contains the Type information of the object. More...
 
- Static Protected Member Functions inherited from FBPlug
static int GetInternalClassId ()
 Internal class Id. More...
 
- Protected Attributes inherited from FBPlug
bool mAllocated
 Contain the Allocation State of the Component. More...
 
HIObject mObject
 Handle on the Plug. More...
 
bool mSDKComponent
 bool Plug is an SDK component.
More...
 
- Static Protected Attributes inherited from FBPlug
static const char * ClassGroupName
 ClassGroupName of the object. More...
 
static int TypeInfo
 TypeInfo. More...
 
static int mGlobalTypeInfo
 Represente the Type Index. More...
 

Detailed Description

Tool Layout Manager class.

This class allows users to interact with Layouts.

Sample Python code:

from pyfbsdk import *
lToolLayoutMan = FBToolLayoutManager()
# Delete all existing custom layout
for i in range( lToolLayoutMan.GetCustomLayoutCount() ):
lToolLayoutMan.DeleteLayout( lToolLayoutMan.GetCustomLayoutCount() - 1 )
# Create a new layout
lToolLayoutMan.CreateLayout( "MyLayout" )
# Print the names of all the factory layouts
print "Factory layouts:"
print "----------------"
for aLayoutIdx in range(lToolLayoutMan.GetFactoryLayoutCount()):
print lToolLayoutMan.GetLayoutName(-aLayoutIdx-1)
# Print the names of all the custom layouts
print ""
print "Custom layouts:"
print "----------------"
for aLayoutIdx in range(lToolLayoutMan.GetCustomLayoutCount()):
print lToolLayoutMan.GetLayoutName(aLayoutIdx)
# Set the Scripting Layout
lToolLayoutMan.SetCurrentLayout( -2 )
# Delete the custom layout
lToolLayoutMan.DeleteLayout( "MyLayout" )
int GetFactoryLayoutCount()
Get the number of factory layouts.
int GetCustomLayoutCount()
Get the number of custom layouts.
bool DeleteLayout(int pLayoutIdx)
Delete the layout associated with the given layout index.
bool SetCurrentLayout(int pLayoutIdx)
Set the current layout from the given layout index.
FBToolLayoutManager()
Constructor.
const char * CreateLayout(const char *pLayoutName)
Create a new layout from the current layout state.
const char * GetLayoutName(int pLayoutIdx)
Get the layout name associated with the given layout index.

Definition at line 103 of file fbtoollayoutmanager.h.

Constructor & Destructor Documentation

◆ FBToolLayoutManager()

FBToolLayoutManager ( )
protected

Constructor.

Protected constructor, use TheOne() access instead.

Member Function Documentation

◆ CreateLayout()

const char* CreateLayout ( const char *  pLayoutName)

Create a new layout from the current layout state.

Parameters
pLayoutNameThe new layout name to create.
Returns
The new layout's name (could be different that the one supplied) if the operation is successful, nullptr (C++) or None (Python) otherwise.

◆ DeleteLayout() [1/2]

bool DeleteLayout ( const char *  pLayoutName)

Delete the layout with the given layout name.

Deleting a factory layout is not permitted.

Parameters
pLayoutNameThe layout name to delete.
Returns
True if the operation is successful, false otherwise.

◆ DeleteLayout() [2/2]

bool DeleteLayout ( int  pLayoutIdx)

Delete the layout associated with the given layout index.

Deleting a factory layout is not permitted.

Parameters
pLayoutIdxThe layout index to delete.
Returns
True if the operation is successful, false otherwise.

◆ GetAutoUpdateLayout()

bool GetAutoUpdateLayout ( )

Get the 'Auto-update Layout' state value.

Returns
The 'Auto-update Layout' state value.

◆ GetCurrentLayoutIdx()

int GetCurrentLayoutIdx ( )

Get the layout index of the current layout.

Returns
The layout index of the current layout.

◆ GetCurrentLayoutName()

const char* GetCurrentLayoutName ( )

Get the name of the current layout.

Returns
The name of the current layout.

◆ GetCustomLayoutCount()

int GetCustomLayoutCount ( )

Get the number of custom layouts.

Returns
The number of custom layouts.

◆ GetFactoryLayoutCount()

int GetFactoryLayoutCount ( )

Get the number of factory layouts.

Returns
The number of factory layouts.

◆ GetLayoutName()

const char* GetLayoutName ( int  pLayoutIdx)

Get the layout name associated with the given layout index.

Parameters
pLayoutIdxThe layout index to query. The factory layouts are using negative indices.
Returns
The layout name if the operation is successful, nullptr (C++) or None (Python) otherwise.

◆ GetPreventDocking()

bool GetPreventDocking ( )

Get the 'Prevent Docking' state value.

Note: When 'Prevent Docking' state is true, it is possible to temporary allow docking a window by holding the SHIFT key before moving it. When 'Prevent Docking' state is false, it is possible to temporary prevent docking a window by holding the CTRL key before moving it.

Returns
The 'Prevent Docking' state value.

◆ RenameLayout()

const char* RenameLayout ( const char *  pOldLayoutName,
const char *  pNewLayoutName 
)

Rename a layout.

Renaming a factory layout is not permitted.

Parameters
pOldLayoutNameThe layout's name to rename.
pNewLayoutNameThe new layout name.
Returns
The new layout's name (could be different that the one supplied) if the operation is successful, nullptr (C++) or None (Python) otherwise.

◆ SetAutoUpdateLayout()

bool SetAutoUpdateLayout ( bool  pAutoUpdate)

Set the 'Auto-update Layout' state value.

Parameters
pAutoUpdateThe 'Auto-update Layout' state value.
Returns
True if the operation is successful, false otherwise.

◆ SetCurrentLayout() [1/2]

bool SetCurrentLayout ( const char *  pLayoutName)

Set the current layout from the given layout name.

Parameters
pLayoutNameThe layout's name to set as the current layout.
Returns
True if the operation is successful, false otherwise.

◆ SetCurrentLayout() [2/2]

bool SetCurrentLayout ( int  pLayoutIdx)

Set the current layout from the given layout index.

Parameters
pLayoutIdxThe layout index to set as the current layout. The factory layouts are using negative indices.
Returns
True if the operation is successful, false otherwise.

◆ SetPreventDocking()

bool SetPreventDocking ( bool  pPreventDocking)

Set the 'Prevent Docking' state value.

Note: When 'Prevent Docking' state is true, it is possible to temporary allow docking a window by holding the SHIFT key before moving it. When 'Prevent Docking' state is false, it is possible to temporary prevent docking a window by holding the CTRL key before moving it.

Parameters
pPreventDockingThe 'Prevent Docking' state value.
Returns
True if the operation is successful, false otherwise.

◆ TheOne()

static FBToolLayoutManager& TheOne ( )
static

Returns the only instance of FBToolLayoutManager.

Returns
The only instance of FBToolLayoutManager.

◆ UpdateCurrentLayout()

bool UpdateCurrentLayout ( )

Update the current layout from the current layout state.

Updating a factory layout is not permitted.

Returns
True if the operation is successful, false otherwise.

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