Deprecated NSMovieView Methods

A method identified as deprecated has been superseded and may become unsupported in the future.

Deprecated in Mac OS X v10.3

clear:

This action method deletes the current movie selection from the movie. (Deprecated in Mac OS X v10.3. Use delete: instead.)

- (void)clear:(id)sender

Discussion

If there is no selection, the current frame is deleted. This action is undoable. If the movie is not editable, this method does nothing.

Deprecated in Mac OS X v10.5

copy:

This action method copies the current movie selection onto the clipboard. (Deprecated in Mac OS X v10.5.)

- (void)copy:(id)sender

Discussion

If there is no selection, the current frame is copied. The movie does not need to be editable.

See Also

• – paste:

cut:

This action method deletes the current movie selection from the movie, placing it on the clipboard. (Deprecated in Mac OS X v10.5.)

- (void)cut:(id)sender

Discussion

If there is no selection, the current frame is deleted. This action is undoable. If the movie is not editable, this method does nothing.

See Also

• – paste:

delete:

This action method deletes the current movie selection from the movie, placing it on the clipboard. (Deprecated in Mac OS X v10.5.)

- (void)delete:(id)sender

Discussion

If there is no selection, the current frame is deleted. This action is undoable. If the movie is not editable, this method does nothing.

gotoBeginning:

This action method repositions the play position to the beginning of the movie. (Deprecated in Mac OS X v10.5.)

- (void)gotoBeginning:(id)sender

Discussion

If the movie is playing, the movie continues playing from the new position.

See Also

• – gotoEnd:
• – gotoPosterFrame:

gotoEnd:

This action method repositions the play position to the end of the movie. (Deprecated in Mac OS X v10.5.)

- (void)gotoEnd:(id)sender

Discussion

If the movie is playing in one of the looping modes, the movie continues playing accordingly; otherwise, play stops.

See Also

• – gotoBeginning:
• – gotoPosterFrame:

gotoPosterFrame:

This action method repositions the play position to the movie’s poster frame. (Deprecated in Mac OS X v10.5.)

- (void)gotoPosterFrame:(id)sender

Discussion

If no poster frame is defined, the movie jumps to the beginning. If the movie is playing, the movie continues playing from the new position.

See Also

• – gotoBeginning:
• – gotoEnd:

isControllerVisible

Returns YES if the movie controller is visible. (Deprecated in Mac OS X v10.5.)

- (BOOL)isControllerVisible

Discussion

The default is YES.

See Also

• – showController:adjustingSize:

isEditable

Returns YES if the movie is editable. (Deprecated in Mac OS X v10.5.)

- (BOOL)isEditable

Discussion

When editable, a movie can be modified using the clear:, cut:, and paste: methods and associated key commands. You can also drag movie files into the view, replacing the movie. The default is YES.

See Also

• – setEditable:

isMuted

Returns YES if the movie’s sound is currently muted. (Deprecated in Mac OS X v10.5.)

- (BOOL)isMuted

See Also

• – setMuted:

isPlaying

Returns YES if the movie is currently playing. (Deprecated in Mac OS X v10.5.)

- (BOOL)isPlaying

See Also

• – start:
• – stop:

Related Sample Code

• SimpleCocoaJavaMovie
• SimpleCocoaJavaMovieCocoa

loopMode

Returns the playback behavior for when the end of the movie is reached. (Deprecated in Mac OS X v10.5.)

- (NSQTMovieLoopMode)loopMode

Discussion

Return value is one of the constants defined in “Constants.” Default is NSQTMovieNormalPlayback.

See Also

• – setLoopMode:

movie

Returns the NSMovie object displayed in the view. (Deprecated in Mac OS X v10.5.)

- (NSMovie *)movie

See Also

• – setMovie:

movieController

Returns a pointer to a QuickTime MovieController for the Movie displayed in the view. (Deprecated in Mac OS X v10.5.)

- (void *)movieController

Discussion

Use this method with the QuickTime APIs to enable features not implemented in NSMovieView. A movie controller is available whenever a movie is displayed in a window, even if the controller is itself hidden. If no movie is displayed, movieController returns NULL.

See Also

• – isControllerVisible
• – showController:adjustingSize:

movieRect

Returns the rectangle into which the movie is to be placed. (Deprecated in Mac OS X v10.5.)

- (NSRect)movieRect

Discussion

By default, this method returns the view’s bounding rectangle. Override this method if you want the movie to be positioned or sized differently within the view.

paste:

This action method inserts the contents of the clipboard (if it contains a movie clip) into the movie at the current play position. (Deprecated in Mac OS X v10.5.)

- (void)paste:(id)sender

Discussion

This action is undoable. If the movie is not editable, this method does nothing.

See Also

• – copy:
• – cut:

playsEveryFrame

Returns YES if the movie is configured to display every frame when playing. (Deprecated in Mac OS X v10.5.)

- (BOOL)playsEveryFrame

Discussion

Default is NO.

See Also

• – setPlaysEveryFrame:

playsSelectionOnly

Returns YES if the movie is configured to play only the selected portion. (Deprecated in Mac OS X v10.5.)

- (BOOL)playsSelectionOnly

Discussion

Default is NO.

See Also

• – setPlaysSelectionOnly:

rate

Returns the relative frame rate at which the movie is to be played. (Deprecated in Mac OS X v10.5.)

- (float)rate

Discussion

The default value of 1.0 indicates the normal frame rate defined by the movie.

See Also

• – setRate:

Related Sample Code

• SimpleCocoaJavaMovie
• SimpleCocoaJavaMovieCocoa

resizeWithMagnification:

Resizes the view’s frame to the size required to display the movie with a magnification of magnification and with a movie controller below it. (Deprecated in Mac OS X v10.5.)

- (void)resizeWithMagnification:(float)magnification

See Also

• – sizeForMagnification:

selectAll:

This action method selects the entire movie. (Deprecated in Mac OS X v10.5.)

- (void)selectAll:(id)sender

setEditable:

Sets whether the movie can be edited. (Deprecated in Mac OS X v10.5.)

- (void)setEditable:(BOOL)flag

Discussion

If flag is YES, you can use the clear:, cut:, and paste: methods and associated key commands to modify the movie. You can also drag a new movie file into the view, replacing the current movie. If flag is NO, these features are disabled.

See Also

• – isEditable

setLoopMode:

Sets the playback behavior for when the end of the movie is reached. (Deprecated in Mac OS X v10.5.)

- (void)setLoopMode:(NSQTMovieLoopMode)flag

Discussion

flag is one of the constants defined in “Constants.” If flag is NSQTMovieNormalPlayback, the movie stops playing when it reaches the end. If flag is NSQTMovieLoopingPlayback, the movie will continue playing at the beginning. If flag is NSQTMovieLoopingBackAndForthPlayback, the movie will play in reverse, then forward again, as it reaches each end of the movie. If playsSelectionOnly is YES, these behaviors apply to the endpoints of the selection, not the movie.

See Also

• – loopMode

setMovie:

Sets the NSMovie displayed in the view to movie. (Deprecated in Mac OS X v10.5.)

- (void)setMovie:(NSMovie *)movie

See Also

• – movie

setMuted:

Sets whether the movie’s sound is muted. (Deprecated in Mac OS X v10.5.)

- (void)setMuted:(BOOL)flag

Discussion

When flag is YES, muting is turned on. When muting is turned off again by sending NO for flag, the previous sound volume is restored.

See Also

• – isMuted
• – setVolume:

setPlaysEveryFrame:

Sets whether the movie plays every frame of the movie. (Deprecated in Mac OS X v10.5.)

- (void)setPlaysEveryFrame:(BOOL)flag

Discussion

If flag is YES, every frame of the movie is displayed, even if this requires playing the movie slower than its preferred rate. If flag is NO, the movie may skip some frames if needed to maintain its time sequence.

If flag is YES, audio is not played.

See Also

• – playsEveryFrame

setPlaysSelectionOnly:

Sets whether only the selected portion of the movie is played to flag. (Deprecated in Mac OS X v10.5.)

- (void)setPlaysSelectionOnly:(BOOL)flag

Discussion

If there is no selection, the entire movie is played.

See Also

• – playsSelectionOnly

setRate:

Sets the frame rate, relative to the movie’s internal frame rate, at which to play the movie. (Deprecated in Mac OS X v10.5.)

- (void)setRate:(float)rate

Discussion

The default rate of 1.0 indicates the movie is played at its normal rate. Larger values indicate faster rates, and fractional values indicate slower rates. Negative values are allowed, causing the movie to play in reverse. Invoking this method does not automatically start the movie playing.

This value is ignored if the movie is started using the movie controller, which always plays the movie at the normal rate.

See Also

• – rate

setVolume:

Sets the relative sound volume of the movie. (Deprecated in Mac OS X v10.5.)

- (void)setVolume:(float)volume

Discussion

The default volume of 1.0 indicates the current system volume.

See Also

• – setMuted:
• – volume

showController:adjustingSize:

Sets whether a standard QuickTime movie controller is displayed beneath the movie to show. (Deprecated in Mac OS X v10.5.)

- (void)showController:(BOOL)show adjustingSize:(BOOL)adjustSize

Discussion

If adjustSize is YES, the view’s height is modified so that the size and position of the movie are unchanged. If adjustSize is NO, the view’s size is unchanged, and the movie is resized to fit into the frame. The adjustment is made only if the visibility of the controller is indeed changed.

See Also

• – isControllerVisible

sizeForMagnification:

Returns the required size of the movie view if the movie were magnified to magnification. (Deprecated in Mac OS X v10.5.)

- (NSSize)sizeForMagnification:(float)magnification

Discussion

An extra 16 pixels are added to the vertical dimension to allow room for the movie controller, even if it is currently hidden.

See Also

• – resizeWithMagnification:

start:

This action method starts the movie playing at its current location. (Deprecated in Mac OS X v10.5.)

- (void)start:(id)sender

Discussion

This method does nothing if the movie is already playing.

See Also

• – isPlaying
• – stop:

stepBack:

This action method repositions the movie’s play position to one frame before the current frame. (Deprecated in Mac OS X v10.5.)

- (void)stepBack:(id)sender

Discussion

If the movie is playing, the movie will stop at the new frame.

See Also

• – stepForward:

stepForward:

This action method repositions the movie’s play position to one frame after the current frame. (Deprecated in Mac OS X v10.5.)

- (void)stepForward:(id)sender

Discussion

If the movie is playing, the movie will stop at the new frame.

See Also

• – stepBack:

stop:

This action method stops the movie. (Deprecated in Mac OS X v10.5.)

- (void)stop:(id)sender

See Also

• – isPlaying
• – start:

volume

Returns the relative volume at which the movie is to be played. Default is 1.0. (Deprecated in Mac OS X v10.5.)

- (float)volume

See Also

• – setVolume:

---