 Oracle Video Control Help Index

The Oracle Video Control plays video in an OCX container. The following discribes the Properties and Methods of the control:

Properties

BorderStyle	SHORT

Returns or sets the border style for an OCX custom control. This is a stock property.

ClipboardFrameFormat	SHORT

Identifies the format in which frame data will be copied to the clipboard when the CopyFrame() method is called. It can be one of DIB, Bitmap, or Both.

HasVideo	BOOL

Indicates whether or not there is a valid video associated with the Video OCX. When the OCX is first created, there is no video associated with it. To associate a video with a Video OCX, one of the import methods must be called.

ImportFileSpec	BSTR

When this property is set to a fully qualified filename, the referenced video will be immediately imported. The format of the video will be automatically identified by the Video OCX.

LengthFrames	LONG  (Read-Only)

This property indicates the total length of the current video in frames.

LengthTime	LONG  (Read-Only)

This property indicates the total length of the current video in milliseconds.

PlayVolume	SHORT

Indicates the volume at which the current video should be played. Must be between 0 and 9.

PositionFrames	LONG

Indicates by frame number where in the current video the next play operation will proceed from. Also, can be used for setting the frame number for frame extraction via CopyFrame(). Note that setting of the PositionFrames property will necessarily affect the value of the PositionTime property.

PositionTime	LONG

Indicates by time (msec) where in the current video the next play operation will proceed from. Also, can be used for setting the frame (via time index) for frame extraction via CopyFrame(). Note that setting of the PositionTime property will necessarily affect the value of the PositionFrames property.

ShowControls

Determines whether or not any of the controls will be shown when the OCX is active. If this value is FALSE, only the video view will be shown. The properties ShowVolume, ShowVideoInfo, ShowPosition will be automatically set to FALSE if this value is FALSE.

ShowPosition	BOOL

Determines whether or not the position control/indicator will appear in the Video OCX view box.

ShowVideoInfo	BOOL

Determines whether or not an information bar will appear in the Video OCX view box, providing information like filetype and length of the current video clip.

ShowVolume	BOOL

Determines whether or not the volume control will appear in the Video OCX view box.

VideoFormat	BSTR  (Read-Only)

This read-only property identifies the video format of the most recently imported video. The 16-bit version of the OCX supports Quicktime and AVI formats whereas the 32-bit version only supports AVI.

Visible	BOOL

Determines whether the Video OCX view box is visible or hidden.

Methods

CopyFrame()

Copies the current frame to the clipboard. The format in which the data is copied is determined by the ClipboardFrameFormat property.

ImportFileAs()

When this method is called, a dialog will be provided which will allow the user to specify the import file specification and format. When the user presses the OK button on the dialog, the video is imported.

Play()

When this method is called, the current video will start playing from the position specified by the Position property.

Stop()

When this method is called, the current play operation will be terminated.

Events

Completed

This event is delivered when a play operation completes by itself, i.e., the video being played has reached its end.

PlayStarted

This event is delivered when a play operation is started, either through calling the Play() method, or by pushing the play button.

RightClick

This event is delivered when the user clicks the right mouse button in the view region while the Video OCX is active. The parameters sent are the x and y coordinates relative to the view when the right mouse button is clicked.

Stopped

This event is delivered when a play operation is stopped, either through calling the Stop() method, or by pushing the stop button. Note that the Stopped event is not delivered when a play operation completes by itself; in this case, only the Completed event will be delivered.


No Help Available

No help is available for this area of the window.


No Help Available

No help is available for this message box.

<< If you wish to author help specific to each message box prompt, then remove the AFX_HIDP_xxx values from the [ALIAS] section of your .HPJ file, and author a topic for each AFX_HIDP_xxx value.  For example, AFX_HIDP_INVALID_FILENAME is the help topic for the Invalid Filename message box. >>


BorderStyle	SHORT

Returns or sets the border style for an OCX custom control. This is a stock property.


ClipboardFrameFormat	SHORT

Identifies the format in which frame data will be copied to the clipboard when the CopyFrame() method is called. It can be one of DIB, Bitmap, or Both.


HasVideo	BOOL

Indicates whether or not there is a valid video associated with the Video OCX. When the OCX is first created, there is no video associated with it. To associate a video with a Video OCX, one of the import methods must be called.


ImportFileSpec	BSTR

When this property is set to a fully qualified filename, the referenced video will be immediately imported. The format of the video will be automatically identified by the Video OCX.


LengthFrames	LONG  (Read-Only)

This property indicates the total length of the current video in frames.


LengthTime	LONG  (Read-Only)

This property indicates the total length of the current video in milliseconds.


PlayVolume	SHORT

Indicates the volume at which the current video should be played. Must be between 0 and 255.


PositionFrames	LONG

Indicates by frame number where in the current video the next play operation will proceed from. Also, can be used for setting the frame number for frame extraction via CopyFrame(). Note that setting of the PositionFrames property will necessarily affect the value of the PositionTime property.


PositionTime	LONG

Indicates by time (msec) where in the current video the next play operation will proceed

from. Also, can be used for setting the frame (via time index) for frame extraction via

 CopyFrame(). Note that setting of the PositionTime property will necessarily affect the

 value of the PositionFrames property.


ShowControls

Determines whether or not any of the controls will be shown when the OCX is active. If this value is FALSE, only the video view will be shown. The properties ShowVolume, ShowVideoInfo, ShowPosition will be automatically set to FALSE if this value is FALSE.


ShowPosition	BOOL

Determines whether or not the position control/indicator will appear in the Video OCX view box.


ShowVideoInfo	BOOL

Determines whether or not an information bar will appear in the Video OCX view box, providing information like filetype and length of the current video clip.


ShowVolume	BOOL

Determines whether or not the volume control will appear in the Video OCX view box.


VideoFormat	BSTR  (Read-Only)

This read-only property identifies the video format of the most recently imported video. The 16-bit version of the OCX supports Quicktime and AVI formats whereas the 32-bit version only supports AVI.


Visible	BOOL

Determines whether the Video OCX view box is visible or hidden.


CopyFrame()

Copies the current frame to the clipboard. The format in which the data is copied is determined by the ClipboardFrameFormat property.


ImportFileAs()

When this method is called, a dialog will be provided which will allow the user to specify the import file specification and format. When the user presses the OK button on the dialog, the video is imported.


Play()

When this method is called, the current video will start playing from the position specified by the Position property.


Stop()

When this method is called, the current play operation will be terminated.]


Completed

This event is delivered when a play operation completes by itself, i.e., the video being played has reached its end.


PlayStarted

This event is delivered when a play operation is started, either through calling the Play() method, or by pushing the play button.


RightClick

This event is delivered when the user clicks the right mouse button in the view region while the Video OCX is active. The parameters sent are the x and y coordinates relative to the view when the right mouse button is clicked..


Stopped

This event is delivered when a play operation is stopped, either through calling the Stop()

 method, or by pushing the stop button. Note that the Stopped event is not delivered when

 a play operation completes by itself; in this case, only the Completed event will delivered.