Member

Represents a cast member within a cast library. Cast members are the media and script assets in a movie. Media cast members may be text, bitmaps, shapes, and so on. Script cast members include behaviors, movie scripts, and so on.

A cast member can be referenced either by number or by name.

• When referring to a cast member by number, Director searches a particular cast library for that cast member, and retrieves the member's data. This method is faster than referring to a cast member by name. However, because Director does not automatically update references to cast member numbers in script, a numbered reference to a cast member that has moved position in its cast library will be broken.
• When referring to a cast member by name, Director searches all cast libraries in a movie from first to last, and retrieves the member's data when it finds the named member. This method is slower than referring to a cast member by number, especially when referring to large movies that contain many cast libraries and cast members. However, a named reference to a cast member allows the reference to remain intact even if the cast member moves position in its cast library.

You can create a reference to a cast member by using either the top level member() function, or by using the member property of the Cast, Movie, or Sprite object.

The following examples illustrate creating a reference to a cast member.

• Use the top level member() function.

  -- Lingo syntax
  objTree = member("bmpTree")
  
  // JavaScript syntax
  var objTree = member("bmpTree");
  

• Use the Sprite object's member property.

  -- Lingo syntax
  objTree = sprite(1).member;
  
  // JavaScript syntax
  var objTree = sprite(1).member;
  

Method summary for the Member object

copyToClipBoard()

duplicate() (Member)

erase()

importFileInto()

move()

pasteClipBoardInto()

preLoad() (Member)

unLoad() (Member)

Property summary for the Member object

castLibNum

modifiedDate

comments

name

creationDate

number (Member)

fileName (Member)

purgePriority

height

rect (Member)

hilite

regPoint

linked

scriptText

loaded

size

media

thumbNail

mediaReady

type (Member)

modified

width

modifiedBy

See also

Media Types, member(), member (Cast), member (Movie), member (Sprite), Movie, Player, Scripting Objects, Sprite, Window

Send me an e-mail when comments are added to this page | Comment Report

Current page: http://livedocs.adobe.com/director/mx2004/release_en/02_dire5.htm

Add Comment