# cp.apple.finalcutpro.timeline.Role

Extends Row

Represents a Role in the Timeline Index.

# API Overview

Constants - Useful values which cannot be changed

Functions - API calls offered directly by the extension

Constructors - API calls which return an object, typically one that offers API methods

Fields - Variables which can only be accessed from an object returned by a constructor

Methods - API calls which can only be made on an object returned by a constructor


Signature	`cp.apple.finalcutpro.timeline.Role.TITLE_KEY <table>`
Type	Constant
Description	Contains the list of strings used for default roles.
Notes	CAPTIONS - "Captions" VIDEO - "Video" TITLES - "Titles" DIALOGUE - "Dialogue" MUSIC - "Music" EFFECTS - "Effects"
Source	src/extensions/cp/apple/finalcutpro/timeline/Role.lua line 25


Signature	`cp.apple.finalcutpro.timeline.Role.TYPE <table>`
Type	Constant
Description	Contains the set of role types.
Notes	VIDEO - A Video Role AUDIO - An Audio Role CAPTION - A Caption Role
Source	src/extensions/cp/apple/finalcutpro/timeline/Role.lua line 45


Signature	`cp.apple.finalcutpro.timeline.Role.findTitle(title) -> string`
Type	Function
Description	Checks if FCPX is not currently running in English, it will check if the title is one of the default English Role titles, and return the current language instead. If it's not found, unmodified `title` is returned.
Parameters	title - A string to find.
Returns	A string
Notes	None
Examples	None
Source	src/extensions/cp/apple/finalcutpro/timeline/Role.lua line 87


Signature	`cp.apple.finalcutpro.timeline.Role.is(thing) -> boolean`
Type	Function
Description	Checks if the `thing` is a `Role`.
Parameters	`thing` - The thing to check
Returns	`true` if the thing is a `Table` instance.
Notes	None
Examples	None
Source	src/extensions/cp/apple/finalcutpro/timeline/Role.lua line 74


Signature	`cp.apple.finalcutpro.timeline.Role.matches(element) -> boolean`
Type	Function
Description	Checks if the `element` is a `Role`.
Parameters	element - the `axuielement` to check.
Returns	`true` if it matches, otherwise `false`.
Notes	None
Examples	None
Source	src/extensions/cp/apple/finalcutpro/timeline/Role.lua line 59


Signature	`cp.apple.finalcutpro.timeline.Role(parent, uiFinder, type)`
Type	Constructor
Description	Creates the new Role. Typically this is not called directly, but rather by one of the subclass roles, such as AudioRole or VideoRole.
Parameters	parent - The parent Element uiFinder - The `function` or `cp.prop` that provides the `axuielement`. type - The [#TYPE] of Role.
Returns	The new `Role` instance.
Notes	None
Examples	None
Source	src/extensions/cp/apple/finalcutpro/timeline/Role.lua line 109


Signature	`cp.apple.finalcutpro.timeline.Role.active <cp.ui.CheckBox>`
Type	Field
Description	The CheckBox that determines if the `Role` is active in the timeline.
Notes	None
Source	src/extensions/cp/apple/finalcutpro/timeline/Role.lua line 159


Signature	`cp.apple.finalcutpro.timeline.Role.cellUI <cp.prop: axuielement; read-only>`
Type	Field
Description	The AXCell `axuielement` containing the Role details.
Notes	None
Source	src/extensions/cp/apple/finalcutpro/timeline/Role.lua line 141


Signature	`cp.apple.finalcutpro.timeline.Role.subroleRow <cp.prop: boolean; read-only>`
Type	Field
Description	This is `true` if the `Role` is an Subrole Row.
Notes	None
Source	src/extensions/cp/apple/finalcutpro/timeline/Role.lua line 150


Signature	`cp.apple.finalcutpro.timeline.Role.title <cp.ui.StaticText>`
Type	Field
Description	The StaticText containing the title.
Notes	None
Source	src/extensions/cp/apple/finalcutpro/timeline/Role.lua line 168


Signature	`cp.apple.finalcutpro.timeline.Role:doActivate() -> cp.rx.go.Statement.md`
Type	Method
Description	A Statement that will activate the current role, if possible.
Parameters	None
Returns	Statement
Notes	None
Examples	None
Source	src/extensions/cp/apple/finalcutpro/timeline/Role.lua line 177


Signature	`cp.apple.finalcutpro.timeline.Role:doDeactivate() -> cp.rx.go.Statement.md`
Type	Method
Description	A Statement that will deactivate the current role, if possible.
Parameters	None
Returns	Statement
Notes	None
Examples	None
Source	src/extensions/cp/apple/finalcutpro/timeline/Role.lua line 190


Signature	`cp.apple.finalcutpro.timeline.Role:type() -> cp.apple.finalcut.timeline.Role.TYPE`
Type	Method
Description	Returns the type of Role this is.
Parameters	None
Returns	Role Type
Notes	None
Examples	None
Source	src/extensions/cp/apple/finalcutpro/timeline/Role.lua line 128