FBLayout Class Reference

Used to build the user interface. More...

#include <pyfbsdk_generated.h>

Inheritance diagram for FBLayout:

Public Member Functions
	FBLayout ()
	Constructor.
bool	AddRegion (str pName, str pTitle, int pX, FBAttachType pXType, str pXRelative, float pMultX, int pY, FBAttachType pYType, str pYRelative, float pMultY, int pW, FBAttachType pWType, str pWRelative, float pMultW, int pH, FBAttachType pHType, str pHRelative, float pMultH)
	Add a region to the layout.
	ClearControl (str pName)
	Remove a control from a region in a visual component.
FBVisualComponent	GetControl (str pName)
	Get control of a region in a visual component.
bool	GetRegion (str pName)
	Verify if a region with pName exists.
bool	GetRegionPositions (str pName, bool pComputed, int pX, int pY, int pW=None, int pH=None)
	Get region pName information (position and size)
FBSplitStyle	GetSplitStyle (str pName)
	Get a region's splitstyle.
bool	MoveRegion (str pName, int pX, int pY)
	Move a region.
bool	RemoveRegion (str pName)
	Remove a region.
bool	RenameRegion (str pOldName, str pNewName)
	Rename a region.
	Restructure (bool pNoMove)
	Force a recomputation of all region placements in the layout.
	SetAutoRestructure (bool pAutoRestructure)
	Suspend all automatic layout recomputation.
bool	SetBorder (str pName, FBBorderStyle pType, bool pShowTitle, bool pInSet, int pWidth, int pSpacing, float pMaxAngle, int pCornerRadius)
	Set border properties for a region.
bool	SetControl (str pName, FBVisualComponent pComponent)
	Set control of a region to a visual component.
bool	SetControl (str pName, FBVisualComponent pComponent)
bool	SetRegionTitle (str pName, str pTitle)
	Set a region's title.
bool	SetSplitStyle (str pName, FBSplitStyle pRegionType)
	Set a region's splitstyle.
bool	SetView (str pName, FBVisualComponent pComponent)
	Set view.
bool	SetView (str pName, FBVisualComponent pComponent)
bool	SizeRegion (str pName, int pW, int pH)
	Change a region's size.
Public Member Functions inherited from FBVisualComponent
	FBVisualComponent ()
	Constructor.
bool	AddChild (FBVisualComponent pChild, int pId=0)
	Add a child component.
FBVisualComponent	GetChild (int pId=0)
	Get a child component.
QWidget	GetQWidgetAddress ()
	Get internal QWidget.
bool	IsView ()
	Is component a view?
	Refresh (bool pNow=False)
	Refresh component.
	ViewExpose ()
	Exposed view callback function.
	ViewInput (int pMouseX, int pMouseY, FBInputType pAction, int pButtonKey, int pModifier)
	Input callback function.
Public Member Functions inherited from FBComponent
	FBComponent ()
	Constructor.
str	ClassName ()
	Get the class name.
	DisableObjectFlags (FBObjectFlag pFlags)
	Disable a specific Object Flags.
	EnableObjectFlags (FBObjectFlag pFlags)
	Enable a specific Object Flags.
bool	FBCreate ()
	Open Reality Creation function.
	FBDelete ()
	Open Reality deletion function.
	FBDestroy ()
	Open Reality destruction function.
FBObjectFlag	GetObjectFlags ()
	Get all Object Flags (concatenated).
bool	GetObjectStatus (FBObjectStatus pStatus)
	Check to see if an object status is enabled.
FBFileReference	GetOwnerFileReference (p0)
	Get the owner FileReference object.
	HardSelect ()
	HardSelect.
bool	HasObjectFlags (FBObjectFlag pFlags)
	Check whether a specific object flag is enabled.
bool	Is (int pTypeId)
	Returns true if object is of type TypeId.
bool	ProcessNamespaceHierarchy (FBNamespaceAction pNamespaceAction, str pNamespaceName, str pReplaceTo=None, bool pAddRight=True)
	ProcessNamespaceHierarchy.
bool	ProcessObjectNamespace (FBNamespaceAction pNamespaceAction, str pNamespaceName, str pReplaceTo=None, bool pAddRight=True)
	ProcessObjectNamespace.
int	PropertyAdd (FBProperty pProperty)
	Add a property to the component's property manager.
bool	PropertyAddReferenceProperty (FBProperty pReferenceProperty)
	Add a reference property to the component's property manager.
FBProperty	PropertyCreate (str pName, FBType pType, str pDataType, bool pAnimatable, bool pIsUser=False, FBProperty pReferenceSource=None)
	Create user or dynamic property.
	PropertyGetModifiedList (FBArrayTemplate< FB > pPropList, FBPlugModificationFlag pModificationFlags)
	Get list of properties which have been modified since last loading.
	PropertyRemove (FBProperty pProperty)
	Remove a Property from the component's Property manager.
	SetObjectFlags (FBObjectFlag pFlags)
	SetObjectFlags.
	SetObjectStatus (FBObjectStatus pStatus, bool pValue)
	Enable/Disable a specific Object Status.

Public Attributes
FBEvent	OnIdle
	Event: Idle.
FBEvent	OnInput
	Event: Input.
FBEvent	OnPaint
	Event: Paint layout.
FBEvent	OnResize
	Event: Resize layout.
FBEvent	OnShow
	Event: Show layout.
Public Attributes inherited from FBVisualComponent
str	Caption
	Property: Widget caption.
bool	Enabled
	Read Write Property: Is visual enabled?
int	Height
	Read Write Property: Height.
str	Hint
	Read Write Property: Hint to show.
int	Left
	Read Write Property: Left coordinate.
bool	ReadOnly
	Read Write Property: Is visual component read only?
int	Top
	Read Write Property: Top coordinate.
bool	Visible
	Read Write Property: Is visual component visible?
int	Width
	Read Write Property: Width.
Public Attributes inherited from FBComponent
FBListComponent	Components
	List: List of components.
str	LongName
	Read Write Property: Name and namespace for object.
str	Name
	Read Write Property: Unique name of object. See sample: RemoveSuffixFromNameOfSceneElements.py.
FBListComponent	Parents
	List: Parents.
FBManager	PropertyList
	Read Only Property: Manages all of the properties for the component.
bool	Selected
	Read Write Property: Selected property.
int	TypeInfo
	Contains the Type information of the object.
Public Attributes inherited from FBPlug
str	ClassGroupName
	ClassGroupName of the object.
int	TypeInfo
	TypeInfo.

Detailed Description

Used to build the user interface.

Layouts manage areas of the screen called regions. Regions contain UI components such as buttons, viewers, and edit boxes. Regions are added to layouts. When a UI component is bound to a region, the region defines how big it is and how it behaves when the layout is resized.Types of Layouts Device Constraint Manipulator Shader A region is first defined using the FBLayout::AddRegion() function. Once a region is defined and the corresponding UI component is created, and the component is bound to its region with FBLayout::SetControl(). You can use the FBSystem::OnUIIdle() in your layout to update real-time UI components such as guages and status indicators. In Python, FBBoxLayout and FBGridLayout take care of most of the region handling. They are used to create basic control layouts for simple tools. If you have a lot of content you can use FBScrollBox to manage it. For an example, see the Python sample Scrollbox.py.* Also see the Python sample Layout.py, and the C++ sample ortooluidemo.

See samples: ShotTrackSetupTool.py, Attach.py, Border.py, Layout.py.

Constructor & Destructor Documentation

FBLayout()

FBLayout

(

)

Constructor.

Member Function Documentation

AddRegion()

bool AddRegion	(	str	pName,
		str	pTitle,
		int	pX,
		FBAttachType	pXType,
		str	pXRelative,
		float	pMultX,
		int	pY,
		FBAttachType	pYType,
		str	pYRelative,
		float	pMultY,
		int	pW,
		FBAttachType	pWType,
		str	pWRelative,
		float	pMultW,
		int	pH,
		FBAttachType	pHType,
		str	pHRelative,
		float	pMultH
	)

Add a region to the layout.

Parameters

pName	Name of region.
pTitle	Title to display.
pX	X: Position.
pXType	X: Type of attachment.
pXRelative	X: Item to attach to.
pMultX	X: Multiplier of relative value.
pY	Y: Position.
pYType	Y: Type of attachment.
pYRelative	Y: Item to attach to.
pMultY	Y: Multiplier of relative value.
pW	W: Width of region.
pWType	W: Type of attachment.
pWRelative	W: Item to attach to.
pMultW	W: Multiplier of relative value.
pH	H: Height of region.
pHType	H: Type of attachment.
pHRelative	H: Item to attach to.
pMultH	H: Multiplier of relative value.

Returns

Operation was successful (true or false).

ClearControl()

ClearControl

(

str

pName

)

Remove a control from a region in a visual component.

Parameters

pName

Name of region to remove control.

GetControl()

FBVisualComponent GetControl

(

str

pName

)

Get control of a region in a visual component.

Parameters

pName

Name of region to find.

Returns

The component if it is found.

GetRegion()

bool GetRegion

(

str

pName

)

Verify if a region with pName exists.

Parameters

pName

Name of region to check.

Returns

Operation was successful (true or false).

GetRegionPositions()

bool GetRegionPositions	(	str	pName,
		bool	pComputed,
		int	pX,
		int	pY,
		int	pW = None,
		int	pH = None
	)

Get region pName information (position and size)

Parameters

pName	Name of region.
pComputed	Is the information retrieved relative or absolute?
pX	Position in X of the region.
pY	Position in Y of the region.
pW	Width of the region.
pH	Height of the region.

Returns

Operation was successful (true or false).

GetSplitStyle()

FBSplitStyle GetSplitStyle

(

str

pName

)

Get a region's splitstyle.

Parameters

pName

Name of Region to get splitstyle from.

Returns

Split style of specified region.

MoveRegion()

bool MoveRegion	(	str	pName,
		int	pX,
		int	pY
	)

Move a region.

Parameters

pName	Name of region to move.
pX	New X position.
pY	New Y position.

Returns

Operation was successful (true or false).

RemoveRegion()

bool RemoveRegion

(

str

pName

)

Remove a region.

Parameters

pName

Name of region to remove.

Returns

Operation was successful (true or false).

RenameRegion()

bool RenameRegion	(	str	pOldName,
		str	pNewName
	)

Rename a region.

Parameters

pOldName	Region's old name.
pNewName	Region's new name.

Returns

Operation was successful (true or false).

Restructure()

Restructure

(

bool

pNoMove

)

Force a recomputation of all region placements in the layout.

SetAutoRestructure()

SetAutoRestructure

(

bool

pAutoRestructure

)

Suspend all automatic layout recomputation.

Parameters

pAutoRestructure

If true, Suspend all automatic layout recomputation, else restore it.

SetBorder()

bool SetBorder	(	str	pName,
		FBBorderStyle	pType,
		bool	pShowTitle,
		bool	pInSet,
		int	pWidth,
		int	pSpacing,
		float	pMaxAngle,
		int	pCornerRadius
	)

Set border properties for a region.

Parameters

pName	Name of Region to change border properties.
pType	Border style to use.
pShowTitle	Show region title?
pInSet	Is region inset?
pWidth	Border width.
pSpacing	Border spacing.
pMaxAngle	Max angle for rounding.
pCornerRadius	Corner radius for rounding.

Returns

Operation was successful (true or false).

SetControl() [1/2]

bool SetControl	(	str	pName,
		FBVisualComponent	pComponent
	)

Set control of a region to a visual component.

Parameters

pName	Name of region to affect.
pComponent	Component to control region.

Returns

Operation was successful (true or false).

SetControl() [2/2]

bool SetControl	(	str	pName,
		FBVisualComponent	pComponent
	)

SetRegionTitle()

bool SetRegionTitle	(	str	pName,
		str	pTitle
	)

Set a region's title.

Parameters

pName	Name of region to change title.
pTitle	New title for region.

Returns

Operation was successful (true or false).

SetSplitStyle()

bool SetSplitStyle	(	str	pName,
		FBSplitStyle	pRegionType
	)

Set a region's splitstyle.

Parameters

pName	Name of Region to set splitstyle.
pRegionType	Split style give to region.

Returns

Operation was successful (true or false).

SetView() [1/2]

bool SetView	(	str	pName,
		FBVisualComponent	pComponent
	)

Set view.

Parameters

pName	Name of Region.
pComponent	Component to set as view.

Returns

Operation was successful (true or false).

SetView() [2/2]

bool SetView	(	str	pName,
		FBVisualComponent	pComponent
	)

SizeRegion()

bool SizeRegion	(	str	pName,
		int	pW,
		int	pH
	)

Change a region's size.

Parameters

pName	Name of region to resize.
pW	New region width.
pH	New region height.

Returns

Operation was successful (true or false).

Member Data Documentation

OnIdle

FBEvent OnIdle

Event: Idle.

OnInput

FBEvent OnInput

Event: Input.

OnPaint

FBEvent OnPaint

Event: Paint layout.

OnResize

FBEvent OnResize

Event: Resize layout.

OnShow

FBEvent OnShow

Event: Show layout.