Class: TPlayerViewFor

Declaration: PlayerViews.h

Taxonomy Categories:

Member Functions:

Interface Category:

API.

Inherits From:

TPlayerView

Inherited By:

None.

Purpose:

TPlayerViewFor is a convenience class for creating a PlayerView that handles any one of the different media types--movie, audio, and MIDI. This class provides a simple means for lightweight (view-only) presentation embedding into a view, such as embedding a movie clip into a help dialogue. Normally, to embed a media presentation into a view, the developer works with two classes; the TMedia Presenter class, which controls the presentation; and either the movie, audio, or MIDI convenience player. TPlayerViewFor provides a simple way for a developer to embed the presentation into a view without directly using TMediaPresenter and the media player classes. Note: This class is good for prototype or demo code.

Instantiation:

Allocate on the heap or the stack.

Deriving Classes:

Not intended to be derived.

Concurrency:

Multithread safe.

Resource Use:

No special requirements.

Other Considerations:

None.

Member Function: TPlayerViewFor::TPlayerViewFor

  1. TPlayerViewFor (const TText & directoryName, const TText & fileName, MOpenFile :: EPermissionsForMe forMe =MOpenFile :: kRead, MOpenFile :: EPermissionsForOthers forOthers =MOpenFile :: kAllowRead)
  2. TPlayerViewFor (TDirectory & directory, const TFileSystemEntityName & fileName, MOpenFile :: EPermissionsForMe forMe =MOpenFile :: kRead, MOpenFile :: EPermissionsForOthers forOthers =MOpenFile :: kAllowRead)
  3. TPlayerViewFor (const TFileSystemEntity & file, MOpenFile :: EPermissionsForMe forMe =MOpenFile :: kRead, MOpenFile :: EPermissionsForOthers forOthers =MOpenFile :: kAllowRead)
  4. TPlayerViewFor (APlayer * playerToAdopt)
  5. TPlayerViewFor ()

Interface Category:

API.

Purpose:

  1. Constructor for the player view class template that lets you specify the directory pathname and the data filename, and optionally, permissions for the thread creating the class, and permissions for those accessing the class.
  2. Constructor for the player view class template that takes the directory and file system entity name, and optionally, permissions for the thread creating the class, and permissions for those accessing the class.
  3. Constructor for the player view class template that takes the file system entity, and optionally, permissions for the thread creating the class, and permissions for those accessing the class.
  4. Constructor that takes a pointer to the media player.
  5. Default constructor.

Calling Context:

  1. Called when you have the directory pathname and data filename.
  2. Called when you have the directory and file system entity name.
  3. Called when you have the file system entity for the data file.
  4. Called to use a pointer to the media player.
  5. Called by the stream-in operators or derived classes.

Parameters:

Return Value:

None.

Exceptions:

Throws no exceptions, passes all exceptions through.

Concurrency:

Multithread safe.

Other Considerations:

None.

Member Function: TPlayerViewFor::~TPlayerViewFor

virtual ~ TPlayerViewFor ()

Interface Category:

API.

Purpose:

Destructor. Deletes the TPlayerViewFor object, and any of its children and all related storage.

Calling Context:

Called to destroy an object.

Parameters:

Return Value:

None.

Exceptions:

Throws no exceptions, passes all exceptions through.

Concurrency:

Multithread safe.

Other Considerations:

None.
Click the icon to mail questions or corrections about this material to Taligent personnel.
Copyright©1995 Taligent,Inc. All rights reserved.