|
Oracle UIX API Reference Release 2.1.22.0.0 B12196-01 |
||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
SUMMARY: INNER | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
java.lang.Object | +--oracle.cabo.ui.DeprecatedUINode | +--oracle.cabo.ui.BaseUINode | +--oracle.cabo.ui.BaseMutableUINode | +--oracle.cabo.ui.beans.BaseWebBean | +--oracle.cabo.ui.beans.MarlinBean | +--oracle.cabo.ui.beans.MediaBean
The media control displays the media specified by the "source" attribute in the appropriate media player. If a particular media player is desired, it can be specified using the "player" attribute. The media control attempts to intelligently handle two tricky aspects of cross-platform media display--determining the best player to display the media, and sizing the media player.
The media control attempts to pick the appropriate media player using the following steps:
The media control supports two approaches to sizing the media control setting the "width" and "height" attributes, which specify the amount of space reserved on the user agent for the media control, and setting the "innerWidth" and "innerHeight" attributes, which specify the size of the media resource content. Since it is almost impossible to determine the correct width and height to use across different players and different player control configurations, specifying the "innerWidth" and "innerHeight" is the recommended strategy.
If the size of the media control isn't specified by one of the above approaches, a default inner size, determined by the content type of the media resource, will be used. This works well for audio content, but can cause content to be clipped or occupy too much space for video content.
This sample builds a media control, for playing a house music Windows Media file. The typical set of controls is displayed, and the control is sized just large enough to display the controls, since the default inner size of audio files is 0 by 0 pixels.
<media source="house.wma" />
This sample builds on the above example but adds a short description and stand by text. Only the minimal media player controls are dsiplayed.
<media source="house.wma" controls="minimal" shortDesc="Bad House Music" standyText="I wish I wasn't loading this..."/>
This sample displays a Windows Media video file, specifying the inner size of the media control to be the size of the video clip. The video will start immediately and a full set of controls are available to the user.
<media source="seattle.wmv" innerWidth="160" innerHeight="112" autostart="true" controls="all" />
Constructor Summary | |
|
MediaBean()
Construct an instance of the MediaBean. |
protected |
MediaBean(boolean ignored,
java.lang.String localName)
Construct an instance of the MediaBean. |
|
MediaBean(java.lang.String source)
Construct an instance of the MediaBean. |
|
MediaBean(java.lang.String source,
java.lang.String shortDesc)
Construct an instance of the MediaBean. |
Method Summary | |
java.lang.String |
getContentType()
Gets the MIME type of the media content returned by the "source" URI. |
static java.lang.String |
getContentType(MutableUINode bean)
Gets the MIME type of the media content returned by the "source" URI. |
java.lang.String |
getControls()
Gets the set of controls to made available to the user for controlling the media playback. |
static java.lang.String |
getControls(MutableUINode bean)
Gets the set of controls to made available to the user for controlling the media playback. |
java.lang.String |
getHeight()
Gets height in pixels to reserve for the media player plus its content. |
static java.lang.String |
getHeight(MutableUINode bean)
Gets height in pixels to reserve for the media player plus its content. |
int |
getInnerHeight()
Gets height in pixels to reserve for the media player content. |
static int |
getInnerHeight(MutableUINode bean)
Gets height in pixels to reserve for the media player content. |
int |
getInnerWidth()
Gets width in pixels to reserve for the media player content. |
static int |
getInnerWidth(MutableUINode bean)
Gets width in pixels to reserve for the media player content. |
int |
getPlayCount()
Gets the number of times the media resource will play. |
static int |
getPlayCount(MutableUINode bean)
Gets the number of times the media resource will play. |
java.lang.String |
getPlayer()
Gets which media player to use to play the media resource. |
static java.lang.String |
getPlayer(MutableUINode bean)
Gets which media player to use to play the media resource. |
java.lang.String |
getSource()
Gets the URI specifying the location of the media resource. |
static java.lang.String |
getSource(MutableUINode bean)
Gets the URI specifying the location of the media resource. |
java.lang.String |
getStandbyText()
Gets Message to display in the media player while the media resource is loading. |
static java.lang.String |
getStandbyText(MutableUINode bean)
Gets Message to display in the media player while the media resource is loading. |
java.lang.String |
getWidth()
Gets width in pixels to reserve for the media player plus its content. |
static java.lang.String |
getWidth(MutableUINode bean)
Gets width in pixels to reserve for the media player plus its content. |
boolean |
isAutostart()
Gets a boolean value that controls whether the media resource loads and plays automatically without user initiation. |
static boolean |
isAutostart(MutableUINode bean)
Gets a boolean value that controls whether the media resource loads and plays automatically without user initiation. |
void |
setAutostart(boolean autostart)
Sets a boolean value that controls whether the media resource loads and plays automatically without user initiation. |
static void |
setAutostart(MutableUINode bean,
boolean autostart)
Sets a boolean value that controls whether the media resource loads and plays automatically without user initiation. |
static void |
setContentType(MutableUINode bean,
java.lang.String contentType)
Sets the MIME type of the media content returned by the "source" URI. |
void |
setContentType(java.lang.String contentType)
Sets the MIME type of the media content returned by the "source" URI. |
static void |
setControls(MutableUINode bean,
java.lang.String controls)
Sets the set of controls to made available to the user for controlling the media playback. |
void |
setControls(java.lang.String controls)
Sets the set of controls to made available to the user for controlling the media playback. |
void |
setHeight(int height)
Sets height in pixels to reserve for the media player plus its content. |
static void |
setHeight(MutableUINode bean,
int height)
Sets height in pixels to reserve for the media player plus its content. |
static void |
setHeight(MutableUINode bean,
java.lang.String height)
Sets height in pixels to reserve for the media player plus its content. |
void |
setHeight(java.lang.String height)
Sets height in pixels to reserve for the media player plus its content. |
void |
setInnerHeight(int innerHeight)
Sets height in pixels to reserve for the media player content. |
static void |
setInnerHeight(MutableUINode bean,
int innerHeight)
Sets height in pixels to reserve for the media player content. |
void |
setInnerWidth(int innerWidth)
Sets width in pixels to reserve for the media player content. |
static void |
setInnerWidth(MutableUINode bean,
int innerWidth)
Sets width in pixels to reserve for the media player content. |
void |
setPlayCount(int playCount)
Sets the number of times the media resource will play. |
static void |
setPlayCount(MutableUINode bean,
int playCount)
Sets the number of times the media resource will play. |
static void |
setPlayer(MutableUINode bean,
java.lang.String player)
Sets which media player to use to play the media resource. |
void |
setPlayer(java.lang.String player)
Sets which media player to use to play the media resource. |
static void |
setSource(MutableUINode bean,
java.lang.String source)
Sets the URI specifying the location of the media resource. |
void |
setSource(java.lang.String source)
Sets the URI specifying the location of the media resource. |
void |
setSourceBinding(BoundValue boundValue)
Binds the the URI specifying the location of the media resource. |
static void |
setSourceBinding(MutableUINode bean,
BoundValue boundValue)
Binds the the URI specifying the location of the media resource. |
static void |
setSourceBinding(MutableUINode bean,
java.lang.Object selectKey)
Binds the the URI specifying the location of the media resource. |
static void |
setSourceBinding(MutableUINode bean,
java.lang.String dataNamespace,
java.lang.String dataName,
java.lang.Object selectKey)
Binds the the URI specifying the location of the media resource. |
void |
setSourceBinding(java.lang.Object selectKey)
Binds the the URI specifying the location of the media resource. |
void |
setSourceBinding(java.lang.String dataNamespace,
java.lang.String dataName,
java.lang.Object selectKey)
Binds the the URI specifying the location of the media resource. |
static void |
setStandbyText(MutableUINode bean,
java.lang.String standbyText)
Sets Message to display in the media player while the media resource is loading. |
void |
setStandbyText(java.lang.String standbyText)
Sets Message to display in the media player while the media resource is loading. |
void |
setWidth(int width)
Sets width in pixels to reserve for the media player plus its content. |
static void |
setWidth(MutableUINode bean,
int width)
Sets width in pixels to reserve for the media player plus its content. |
static void |
setWidth(MutableUINode bean,
java.lang.String width)
Sets width in pixels to reserve for the media player plus its content. |
void |
setWidth(java.lang.String width)
Sets width in pixels to reserve for the media player plus its content. |
Methods inherited from class oracle.cabo.ui.beans.MarlinBean |
isEqualMarlinName |
Methods inherited from class oracle.cabo.ui.BaseUINode |
getAttributeNames, getAttributeValue, getAttributeValueImpl, getChildArray, getChildNames, getIndexedChild, getIndexedChild, getIndexedChildCount, getLocalName, getNamedChild, getNamespaceURI, getNodeID, getNodeRole, getPreorderDescendentAttributeValue, getRawAttributeValue, getRenderedUINode, getRenderer, getRenderer, render, render, toString |
Methods inherited from class oracle.cabo.ui.DeprecatedUINode |
getAttributeValue, getChildNames, getNamedChild |
Methods inherited from class java.lang.Object |
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait |
Methods inherited from interface oracle.cabo.ui.UINode |
getAttributeNames, getAttributeValue, getAttributeValue, getChildNames, getChildNames, getIndexedChild, getIndexedChild, getIndexedChildCount, getLocalName, getNamedChild, getNamedChild, getNamespaceURI, getNodeID, getNodeRole, getRawAttributeValue, render, render |
Constructor Detail |
public MediaBean()
public MediaBean(java.lang.String source)
source
- the URI specifying the location of the media resource.public MediaBean(java.lang.String source, java.lang.String shortDesc)
source
- the URI specifying the location of the media resource.shortDesc
- the short description of the bean.protected MediaBean(boolean ignored, java.lang.String localName)
Method Detail |
public final java.lang.String getWidth()
If both the "width" and "innerWidth" attributes are specified, the "width" attribute will be used.
If no width is specified, the width of the media control is determined by calculating the "innerWidth" and adding any extra width necessary to display the media player controls.
public final void setWidth(java.lang.String width)
If both the "width" and "innerWidth" attributes are specified, the "width" attribute will be used.
If no width is specified, the width of the media control is determined by calculating the "innerWidth" and adding any extra width necessary to display the media player controls.
public final void setWidth(int width)
If both the "width" and "innerWidth" attributes are specified, the "width" attribute will be used.
If no width is specified, the width of the media control is determined by calculating the "innerWidth" and adding any extra width necessary to display the media player controls.
public final java.lang.String getHeight()
If both the "height" and "innerHeight" attributes are specified, the "height" attribute will be used.
If no height is specified, the height of the media control is determined by calculating the "innerHeight" and adding any extra height necessary to display the media player controls.
public final void setHeight(java.lang.String height)
If both the "height" and "innerHeight" attributes are specified, the "height" attribute will be used.
If no height is specified, the height of the media control is determined by calculating the "innerHeight" and adding any extra height necessary to display the media player controls.
public final void setHeight(int height)
If both the "height" and "innerHeight" attributes are specified, the "height" attribute will be used.
If no height is specified, the height of the media control is determined by calculating the "innerHeight" and adding any extra height necessary to display the media player controls.
public final int getInnerWidth()
If no "innerWidth" is specified, the "innerWidth" will be defaulted based on the content type of the media resource to play.
If both the "width" and "innerWidth" attributes are specified, the "width" attribute will be used.
public final void setInnerWidth(int innerWidth)
If no "innerWidth" is specified, the "innerWidth" will be defaulted based on the content type of the media resource to play.
If both the "width" and "innerWidth" attributes are specified, the "width" attribute will be used.
public final int getInnerHeight()
If no "innerHeight" is specified, the "innerHeight" will be defaulted based on the content type of the media resource to play.
If both the "height" and "innerHeight" attributes are specified, the "height" attribute will be used.
public final void setInnerHeight(int innerHeight)
If no "innerHeight" is specified, the "innerHeight" will be defaulted based on the content type of the media resource to play.
If both the "height" and "innerHeight" attributes are specified, the "height" attribute will be used.
public final java.lang.String getSource()
This is a required property on the bean.
public final void setSource(java.lang.String source)
This is a required property on the bean.
public final void setSourceBinding(BoundValue boundValue)
This is a required property on the bean.
boundValue
- a BoundValue implementation to be used
to retrieve the value.public final void setSourceBinding(java.lang.Object selectKey)
This is a required property on the bean.
selectKey
- the key to be passed to selectValue()
on the
current DataObject
, e.g., the DataObject for the current
table row.public final void setSourceBinding(java.lang.String dataNamespace, java.lang.String dataName, java.lang.Object selectKey)
This is a required property on the bean.
dataNamespace
- the namespace to be passed to
RenderingContext.getDataObject()
dataName
- the name to be passed to
RenderingContext.getDataObject()
selectKey
- the key to be passed to selectValue()
on the
DataObject
.public final boolean isAutostart()
public final void setAutostart(boolean autostart)
public final int getPlayCount()
public final void setPlayCount(int playCount)
public final java.lang.String getContentType()
public final void setContentType(java.lang.String contentType)
public final java.lang.String getStandbyText()
public final void setStandbyText(java.lang.String standbyText)
public final java.lang.String getPlayer()
UIConstants.PLAYER_LINK
use a link in the user agent page to launch the playing of the media resource.
This player setting uses the least amount of space on the page and uses the user agent's built in content type mapping to determine how to display the media resource.
UIConstants.PLAYER_QUICKTIME
use the Apple QuickTime player.
UIConstants.PLAYER_WINDOWS
use the Windows Media Player.
UIConstants.PLAYER_REAL
use the Real Player.
public final void setPlayer(java.lang.String player)
UIConstants.PLAYER_LINK
use a link in the user agent page to launch the playing of the media resource.
This player setting uses the least amount of space on the page and uses the user agent's built in content type mapping to determine how to display the media resource.
UIConstants.PLAYER_QUICKTIME
use the Apple QuickTime player.
UIConstants.PLAYER_WINDOWS
use the Windows Media Player.
UIConstants.PLAYER_REAL
use the Real Player.
public final java.lang.String getControls()
UIConstants.CONTROLS_NONE
don't show any controls for the media player and don't allow control access through alternate means, such as context menus.
This value is typically only used in kiosk-type applications where no user control over the playing of the media is allowed. It is typically used in conjunction with setting the "autostart" attribute to "true", and the "playCount" attribute to "0" to cause the media play immediately and then loop.
UIConstants.CONTROLS_NONE_VISIBLE
don't show any controls for the media player but allow control access through alternate means, such as context menus.
This value is typically only used in applications where user control over the playing of the media is allowed, but not encouraged. It is typically used in conjunction with setting the "autostart" attribute to "true", and the "playCount" attribute to "0" to cause the media to play immediately and then loop.
UIConstants.CONTROLS_MINIMAL
show a minimal set of controls for playing media on the media player.
This value gives users control over the most important media playing controls, while occupying the least amount of additional space on the user agent.
UIConstants.CONTROLS_TYPICAL
show the typical set of controls for playing media on the media player.
This value, the default, gives users control over the most common media playing controls, without occupying an inordinate amount of extra space on the user agent.
UIConstants.CONTROLS_ALL
Show all available controls for playing media on the media player
Using this setting can cause large amount of additional space to be required, depending on the media player used.
The default of this attribute is "typical"
.
public final void setControls(java.lang.String controls)
UIConstants.CONTROLS_NONE
don't show any controls for the media player and don't allow control access through alternate means, such as context menus.
This value is typically only used in kiosk-type applications where no user control over the playing of the media is allowed. It is typically used in conjunction with setting the "autostart" attribute to "true", and the "playCount" attribute to "0" to cause the media play immediately and then loop.
UIConstants.CONTROLS_NONE_VISIBLE
don't show any controls for the media player but allow control access through alternate means, such as context menus.
This value is typically only used in applications where user control over the playing of the media is allowed, but not encouraged. It is typically used in conjunction with setting the "autostart" attribute to "true", and the "playCount" attribute to "0" to cause the media to play immediately and then loop.
UIConstants.CONTROLS_MINIMAL
show a minimal set of controls for playing media on the media player.
This value gives users control over the most important media playing controls, while occupying the least amount of additional space on the user agent.
UIConstants.CONTROLS_TYPICAL
show the typical set of controls for playing media on the media player.
This value, the default, gives users control over the most common media playing controls, without occupying an inordinate amount of extra space on the user agent.
UIConstants.CONTROLS_ALL
Show all available controls for playing media on the media player
Using this setting can cause large amount of additional space to be required, depending on the media player used.
The default of this attribute is "typical"
.
public static java.lang.String getWidth(MutableUINode bean)
If both the "width" and "innerWidth" attributes are specified, the "width" attribute will be used.
If no width is specified, the width of the media control is determined by calculating the "innerWidth" and adding any extra width necessary to display the media player controls.
public static void setWidth(MutableUINode bean, java.lang.String width)
If both the "width" and "innerWidth" attributes are specified, the "width" attribute will be used.
If no width is specified, the width of the media control is determined by calculating the "innerWidth" and adding any extra width necessary to display the media player controls.
public static void setWidth(MutableUINode bean, int width)
If both the "width" and "innerWidth" attributes are specified, the "width" attribute will be used.
If no width is specified, the width of the media control is determined by calculating the "innerWidth" and adding any extra width necessary to display the media player controls.
public static java.lang.String getHeight(MutableUINode bean)
If both the "height" and "innerHeight" attributes are specified, the "height" attribute will be used.
If no height is specified, the height of the media control is determined by calculating the "innerHeight" and adding any extra height necessary to display the media player controls.
public static void setHeight(MutableUINode bean, java.lang.String height)
If both the "height" and "innerHeight" attributes are specified, the "height" attribute will be used.
If no height is specified, the height of the media control is determined by calculating the "innerHeight" and adding any extra height necessary to display the media player controls.
public static void setHeight(MutableUINode bean, int height)
If both the "height" and "innerHeight" attributes are specified, the "height" attribute will be used.
If no height is specified, the height of the media control is determined by calculating the "innerHeight" and adding any extra height necessary to display the media player controls.
public static int getInnerWidth(MutableUINode bean)
If no "innerWidth" is specified, the "innerWidth" will be defaulted based on the content type of the media resource to play.
If both the "width" and "innerWidth" attributes are specified, the "width" attribute will be used.
public static void setInnerWidth(MutableUINode bean, int innerWidth)
If no "innerWidth" is specified, the "innerWidth" will be defaulted based on the content type of the media resource to play.
If both the "width" and "innerWidth" attributes are specified, the "width" attribute will be used.
public static int getInnerHeight(MutableUINode bean)
If no "innerHeight" is specified, the "innerHeight" will be defaulted based on the content type of the media resource to play.
If both the "height" and "innerHeight" attributes are specified, the "height" attribute will be used.
public static void setInnerHeight(MutableUINode bean, int innerHeight)
If no "innerHeight" is specified, the "innerHeight" will be defaulted based on the content type of the media resource to play.
If both the "height" and "innerHeight" attributes are specified, the "height" attribute will be used.
public static java.lang.String getSource(MutableUINode bean)
This is a required property on the bean.
public static void setSource(MutableUINode bean, java.lang.String source)
This is a required property on the bean.
public static void setSourceBinding(MutableUINode bean, BoundValue boundValue)
This is a required property on the bean.
boundValue
- a BoundValue implementation to be used
to retrieve the value.public static void setSourceBinding(MutableUINode bean, java.lang.Object selectKey)
This is a required property on the bean.
selectKey
- the key to be passed to selectValue()
on the
current DataObject
, e.g., the DataObject for the current
table row.public static void setSourceBinding(MutableUINode bean, java.lang.String dataNamespace, java.lang.String dataName, java.lang.Object selectKey)
This is a required property on the bean.
dataNamespace
- the namespace to be passed to
RenderingContext.getDataObject()
dataName
- the name to be passed to
RenderingContext.getDataObject()
selectKey
- the key to be passed to selectValue()
on the
DataObject
.public static boolean isAutostart(MutableUINode bean)
public static void setAutostart(MutableUINode bean, boolean autostart)
public static int getPlayCount(MutableUINode bean)
public static void setPlayCount(MutableUINode bean, int playCount)
public static java.lang.String getContentType(MutableUINode bean)
public static void setContentType(MutableUINode bean, java.lang.String contentType)
public static java.lang.String getStandbyText(MutableUINode bean)
public static void setStandbyText(MutableUINode bean, java.lang.String standbyText)
public static java.lang.String getPlayer(MutableUINode bean)
UIConstants.PLAYER_LINK
use a link in the user agent page to launch the playing of the media resource.
This player setting uses the least amount of space on the page and uses the user agent's built in content type mapping to determine how to display the media resource.
UIConstants.PLAYER_QUICKTIME
use the Apple QuickTime player.
UIConstants.PLAYER_WINDOWS
use the Windows Media Player.
UIConstants.PLAYER_REAL
use the Real Player.
public static void setPlayer(MutableUINode bean, java.lang.String player)
UIConstants.PLAYER_LINK
use a link in the user agent page to launch the playing of the media resource.
This player setting uses the least amount of space on the page and uses the user agent's built in content type mapping to determine how to display the media resource.
UIConstants.PLAYER_QUICKTIME
use the Apple QuickTime player.
UIConstants.PLAYER_WINDOWS
use the Windows Media Player.
UIConstants.PLAYER_REAL
use the Real Player.
public static java.lang.String getControls(MutableUINode bean)
UIConstants.CONTROLS_NONE
don't show any controls for the media player and don't allow control access through alternate means, such as context menus.
This value is typically only used in kiosk-type applications where no user control over the playing of the media is allowed. It is typically used in conjunction with setting the "autostart" attribute to "true", and the "playCount" attribute to "0" to cause the media play immediately and then loop.
UIConstants.CONTROLS_NONE_VISIBLE
don't show any controls for the media player but allow control access through alternate means, such as context menus.
This value is typically only used in applications where user control over the playing of the media is allowed, but not encouraged. It is typically used in conjunction with setting the "autostart" attribute to "true", and the "playCount" attribute to "0" to cause the media to play immediately and then loop.
UIConstants.CONTROLS_MINIMAL
show a minimal set of controls for playing media on the media player.
This value gives users control over the most important media playing controls, while occupying the least amount of additional space on the user agent.
UIConstants.CONTROLS_TYPICAL
show the typical set of controls for playing media on the media player.
This value, the default, gives users control over the most common media playing controls, without occupying an inordinate amount of extra space on the user agent.
UIConstants.CONTROLS_ALL
Show all available controls for playing media on the media player
Using this setting can cause large amount of additional space to be required, depending on the media player used.
The default of this attribute is "typical"
.
public static void setControls(MutableUINode bean, java.lang.String controls)
UIConstants.CONTROLS_NONE
don't show any controls for the media player and don't allow control access through alternate means, such as context menus.
This value is typically only used in kiosk-type applications where no user control over the playing of the media is allowed. It is typically used in conjunction with setting the "autostart" attribute to "true", and the "playCount" attribute to "0" to cause the media play immediately and then loop.
UIConstants.CONTROLS_NONE_VISIBLE
don't show any controls for the media player but allow control access through alternate means, such as context menus.
This value is typically only used in applications where user control over the playing of the media is allowed, but not encouraged. It is typically used in conjunction with setting the "autostart" attribute to "true", and the "playCount" attribute to "0" to cause the media to play immediately and then loop.
UIConstants.CONTROLS_MINIMAL
show a minimal set of controls for playing media on the media player.
This value gives users control over the most important media playing controls, while occupying the least amount of additional space on the user agent.
UIConstants.CONTROLS_TYPICAL
show the typical set of controls for playing media on the media player.
This value, the default, gives users control over the most common media playing controls, without occupying an inordinate amount of extra space on the user agent.
UIConstants.CONTROLS_ALL
Show all available controls for playing media on the media player
Using this setting can cause large amount of additional space to be required, depending on the media player used.
The default of this attribute is "typical"
.
|
Oracle UIX API Reference Release 2.1.22.0.0 B12196-01 |
||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
SUMMARY: INNER | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |