Package com.vaadin.ui
Class Embedded
- java.lang.Object
-
- com.vaadin.server.AbstractClientConnector
-
- com.vaadin.ui.AbstractComponent
-
- com.vaadin.ui.Embedded
-
- All Implemented Interfaces:
ConnectorEventListener
,ContextClickEvent.ContextClickNotifier
,MethodEventSource
,ClientConnector
,Sizeable
,VariableOwner
,Connector
,Component
,LegacyComponent
,Serializable
,EventListener
public class Embedded extends AbstractComponent implements LegacyComponent
A component for embedding external objects.The
Embedded
component is used to display various types of multimedia content using the HTML<object>
element. This includes PDF documents, Java applets, and QuickTime videos. Installing a browser plug-in is usually required to actually view the embedded content.Note that before Vaadin 7,
Embedded
was also used to display images and embedded web pages. This use of the component is deprecated in Vaadin 7; theImage
andBrowserFrame
components should be used instead, respectively.Flash
component was the Vaadin 7 replacement for displaying Adobe Flash objects, but no modern browsers support Flash anymore.- Since:
- 3.0
- Author:
- Vaadin Ltd.
- See Also:
Video
,Audio
, Serialized Form
-
-
Nested Class Summary
-
Nested classes/interfaces inherited from interface com.vaadin.server.ClientConnector
ClientConnector.AttachEvent, ClientConnector.AttachListener, ClientConnector.ConnectorErrorEvent, ClientConnector.DetachEvent, ClientConnector.DetachListener
-
Nested classes/interfaces inherited from interface com.vaadin.ui.Component
Component.ErrorEvent, Component.Event, Component.Focusable, Component.Listener
-
Nested classes/interfaces inherited from interface com.vaadin.server.Sizeable
Sizeable.Unit
-
-
Field Summary
Fields Modifier and Type Field Description static int
TYPE_BROWSER
Deprecated.As of 7.0, use theBrowserFrame
component instead.static int
TYPE_IMAGE
Deprecated.As of 7.0, use theImage
component instead.static int
TYPE_OBJECT
General object type.-
Fields inherited from class com.vaadin.ui.AbstractComponent
DESIGN_ATTR_PLAIN_TEXT
-
Fields inherited from interface com.vaadin.server.Sizeable
SIZE_UNDEFINED, UNITS_CM, UNITS_EM, UNITS_EX, UNITS_INCH, UNITS_MM, UNITS_PERCENTAGE, UNITS_PICAS, UNITS_PIXELS, UNITS_POINTS
-
-
Method Summary
All Methods Instance Methods Concrete Methods Deprecated Methods Modifier and Type Method Description void
addClickListener(MouseEvents.ClickListener listener)
Add a click listener to the component.void
addListener(MouseEvents.ClickListener listener)
Deprecated.As of 7.0, replaced byaddClickListener(ClickListener)
void
changeVariables(Object source, Map<String,Object> variables)
Called when one or more variables handled by the implementing class are changed.String
getAlternateText()
Gets this component's "alt-text".String
getArchive()
This attribute may be used to specify a space-separated list of URIs for archives containing resources relevant to the object, which may include the resources specified by the classid and data attributes.String
getClassId()
This attribute may be used to specify the location of an object's implementation via a URI.String
getCodebase()
This attribute specifies the base path used to resolve relative URIs specified by the classid, data, and archive attributes.String
getCodetype()
Gets the MIME-Type of the code.String
getMimeType()
Gets the MIME-Type of the object.String
getParameter(String name)
Gets the value of an object parameter.Iterator<String>
getParameterNames()
Gets the embedded object parameter names.Resource
getSource()
Gets the resource contained in the embedded object.String
getStandby()
This attribute specifies a message that a user agent may render while loading the object's implementation and data.int
getType()
Gets the type of the embedded object.void
paintContent(PaintTarget target)
Invoked when the component state should be painted.void
removeClickListener(MouseEvents.ClickListener listener)
Remove a click listener from the component.void
removeListener(MouseEvents.ClickListener listener)
Deprecated.As of 7.0, replaced byremoveClickListener(ClickListener)
void
removeParameter(String name)
Removes an object parameter from the list.void
setAlternateText(String altText)
Sets this component's "alt-text", that is, an alternate text that can be presented instead of this component's normal content, for accessibility purposes.void
setArchive(String archive)
This attribute may be used to specify a space-separated list of URIs for archives containing resources relevant to the object, which may include the resources specified by the classid and data attributes.void
setClassId(String classId)
This attribute may be used to specify the location of an object's implementation via a URI.void
setCodebase(String codebase)
This attribute specifies the base path used to resolve relative URIs specified by the classid, data, and archive attributes.void
setCodetype(String codetype)
This attribute specifies the content type of data expected when downloading the object specified by classid.void
setMimeType(String mimeType)
Sets the mimeType, the MIME-Type of the object.void
setParameter(String name, String value)
Sets an object parameter.void
setSource(Resource source)
Sets the object source resource.void
setStandby(String standby)
This attribute specifies a message that a user agent may render while loading the object's implementation and data.void
setType(int type)
Sets the object type.-
Methods inherited from class com.vaadin.ui.AbstractComponent
addContextClickListener, addListener, addShortcutListener, addStyleName, attach, beforeClientResponse, detach, findAncestor, fireComponentErrorEvent, fireComponentEvent, focus, getActionManager, getCaption, getComponentError, getCustomAttributes, getData, getDebugId, getDescription, getErrorMessage, getExplicitImmediateValue, getHeight, getHeightUnits, getIcon, getId, getLocale, getParent, getPrimaryStyleName, getState, getState, getStyleName, getWidth, getWidthUnits, isCaptionAsHtml, isConnectorEnabled, isEnabled, isImmediate, isOrHasAncestor, isReadOnly, isResponsive, isVisible, readDesign, removeContextClickListener, removeListener, removeShortcutListener, removeStyleName, setCaption, setCaptionAsHtml, setComponentError, setData, setDebugId, setDescription, setEnabled, setHeight, setHeight, setHeightUndefined, setIcon, setId, setImmediate, setLocale, setParent, setPrimaryStyleName, setReadOnly, setResponsive, setSizeFull, setSizeUndefined, setStyleName, setStyleName, setVisible, setWidth, setWidth, setWidthUndefined, writeDesign
-
Methods inherited from class com.vaadin.server.AbstractClientConnector
addAttachListener, addDetachListener, addExtension, addListener, addListener, addListener, addMethodInvocationToQueue, createState, encodeState, equals, fireEvent, getAllChildrenIterable, getConnectorId, getErrorHandler, getExtensions, getListeners, getResource, getRpcManager, getRpcProxy, getSession, getStateType, getUI, handleConnectorRequest, hashCode, hasListeners, isAttached, isThis, markAsDirty, markAsDirtyRecursive, registerRpc, registerRpc, removeAttachListener, removeDetachListener, removeExtension, removeListener, removeListener, removeListener, removeListener, requestRepaint, requestRepaintAll, retrievePendingRpcCalls, setErrorHandler, setResource
-
Methods inherited from class java.lang.Object
clone, finalize, getClass, notify, notifyAll, toString, wait, wait, wait
-
Methods inherited from interface com.vaadin.server.ClientConnector
addAttachListener, addDetachListener, beforeClientResponse, detach, encodeState, getErrorHandler, getExtensions, getRpcManager, getStateType, handleConnectorRequest, isAttached, isConnectorEnabled, markAsDirtyRecursive, removeAttachListener, removeDetachListener, removeExtension, requestRepaint, requestRepaintAll, retrievePendingRpcCalls, setErrorHandler
-
Methods inherited from interface com.vaadin.ui.Component
addListener, addStyleName, attach, getCaption, getDescription, getIcon, getId, getLocale, getParent, getPrimaryStyleName, getStyleName, getUI, isEnabled, isReadOnly, isVisible, readDesign, removeListener, removeStyleName, setCaption, setEnabled, setIcon, setId, setParent, setPrimaryStyleName, setReadOnly, setStyleName, setVisible, writeDesign
-
Methods inherited from interface com.vaadin.shared.Connector
getConnectorId
-
Methods inherited from interface com.vaadin.ui.LegacyComponent
markAsDirty
-
Methods inherited from interface com.vaadin.server.Sizeable
getHeight, getHeightUnits, getWidth, getWidthUnits, setHeight, setHeight, setHeightUndefined, setSizeFull, setSizeUndefined, setWidth, setWidth, setWidthUndefined
-
Methods inherited from interface com.vaadin.server.VariableOwner
isEnabled, isImmediate
-
-
-
-
Field Detail
-
TYPE_OBJECT
public static final int TYPE_OBJECT
General object type.- See Also:
- Constant Field Values
-
TYPE_IMAGE
@Deprecated public static final int TYPE_IMAGE
Deprecated.As of 7.0, use theImage
component instead.Image types.- See Also:
- Constant Field Values
-
TYPE_BROWSER
@Deprecated public static final int TYPE_BROWSER
Deprecated.As of 7.0, use theBrowserFrame
component instead.Browser ("iframe") type.- See Also:
- Constant Field Values
-
-
Constructor Detail
-
Embedded
public Embedded()
Creates a new empty Embedded object.
-
Embedded
public Embedded(String caption)
Creates a new empty Embedded object with caption.- Parameters:
caption
-
-
-
Method Detail
-
paintContent
public void paintContent(PaintTarget target) throws PaintException
Invoked when the component state should be painted.- Specified by:
paintContent
in interfaceLegacyComponent
- Parameters:
target
- the target UIDL stream where the component should paint itself to.- Throws:
PaintException
- if the paint operation failed.
-
setAlternateText
public void setAlternateText(String altText)
Sets this component's "alt-text", that is, an alternate text that can be presented instead of this component's normal content, for accessibility purposes. Does not work whensetType(int)
has been called withTYPE_BROWSER
.- Parameters:
altText
- A short, human-readable description of this component's content.- Since:
- 6.8
-
getAlternateText
public String getAlternateText()
Gets this component's "alt-text".- See Also:
setAlternateText(String)
-
setParameter
public void setParameter(String name, String value)
Sets an object parameter. Parameters are optional information, and they are passed to the instantiated object. Parameters are are stored as name value pairs. This overrides the previous value assigned to this parameter.- Parameters:
name
- the name of the parameter.value
- the value of the parameter.
-
getParameter
public String getParameter(String name)
Gets the value of an object parameter. Parameters are optional information, and they are passed to the instantiated object. Parameters are are stored as name value pairs.- Returns:
- the Value of parameter or null if not found.
-
removeParameter
public void removeParameter(String name)
Removes an object parameter from the list.- Parameters:
name
- the name of the parameter to remove.
-
getParameterNames
public Iterator<String> getParameterNames()
Gets the embedded object parameter names.- Returns:
- the Iterator of parameters names.
-
getCodebase
public String getCodebase()
This attribute specifies the base path used to resolve relative URIs specified by the classid, data, and archive attributes. When absent, its default value is the base URI of the current document.- Returns:
- the code base.
-
getCodetype
public String getCodetype()
Gets the MIME-Type of the code.- Returns:
- the MIME-Type of the code.
-
getMimeType
public String getMimeType()
Gets the MIME-Type of the object.- Returns:
- the MIME-Type of the object.
-
getStandby
public String getStandby()
This attribute specifies a message that a user agent may render while loading the object's implementation and data.- Returns:
- The text displayed when loading
-
setCodebase
public void setCodebase(String codebase)
This attribute specifies the base path used to resolve relative URIs specified by the classid, data, and archive attributes. When absent, its default value is the base URI of the current document.- Parameters:
codebase
- The base path
-
setCodetype
public void setCodetype(String codetype)
This attribute specifies the content type of data expected when downloading the object specified by classid. This attribute is optional but recommended when classid is specified since it allows the user agent to avoid loading information for unsupported content types. When absent, it defaults to the value of the type attribute.- Parameters:
codetype
- the codetype to set.
-
setMimeType
public void setMimeType(String mimeType)
Sets the mimeType, the MIME-Type of the object.- Parameters:
mimeType
- the mimeType to set.
-
setStandby
public void setStandby(String standby)
This attribute specifies a message that a user agent may render while loading the object's implementation and data.- Parameters:
standby
- The text to display while loading
-
getClassId
public String getClassId()
This attribute may be used to specify the location of an object's implementation via a URI.- Returns:
- the classid.
-
setClassId
public void setClassId(String classId)
This attribute may be used to specify the location of an object's implementation via a URI.- Parameters:
classId
- the classId to set.
-
getSource
public Resource getSource()
Gets the resource contained in the embedded object.- Returns:
- the Resource
-
getType
public int getType()
Gets the type of the embedded object.This can be one of the following:
- TYPE_OBJECT (This is the default)
- TYPE_IMAGE
- Returns:
- the type.
-
setSource
public void setSource(Resource source)
Sets the object source resource. The dimensions are assumed if possible. The type is guessed from resource.- Parameters:
source
- the source to set.
-
setType
public void setType(int type)
Sets the object type.This can be one of the following:
TYPE_OBJECT
(This is the default)TYPE_IMAGE
(Deprecated)TYPE_BROWSER
(Deprecated)
- Parameters:
type
- the type to set.
-
getArchive
public String getArchive()
This attribute may be used to specify a space-separated list of URIs for archives containing resources relevant to the object, which may include the resources specified by the classid and data attributes. Preloading archives will generally result in reduced load times for objects. Archives specified as relative URIs should be interpreted relative to the codebase attribute.- Returns:
- Space-separated list of URIs with resources relevant to the object
-
setArchive
public void setArchive(String archive)
This attribute may be used to specify a space-separated list of URIs for archives containing resources relevant to the object, which may include the resources specified by the classid and data attributes. Preloading archives will generally result in reduced load times for objects. Archives specified as relative URIs should be interpreted relative to the codebase attribute.- Parameters:
archive
- Space-separated list of URIs with resources relevant to the object
-
addClickListener
public void addClickListener(MouseEvents.ClickListener listener)
Add a click listener to the component. The listener is called whenever the user clicks inside the component. Depending on the content the event may be blocked and in that case no event is fired. UseremoveListener(ClickListener)
to remove the listener.- Parameters:
listener
- The listener to add
-
addListener
@Deprecated public void addListener(MouseEvents.ClickListener listener)
Deprecated.As of 7.0, replaced byaddClickListener(ClickListener)
-
removeClickListener
public void removeClickListener(MouseEvents.ClickListener listener)
Remove a click listener from the component. The listener should earlier have been added usingaddListener(ClickListener)
.- Parameters:
listener
- The listener to remove
-
removeListener
@Deprecated public void removeListener(MouseEvents.ClickListener listener)
Deprecated.As of 7.0, replaced byremoveClickListener(ClickListener)
-
changeVariables
public void changeVariables(Object source, Map<String,Object> variables)
Description copied from interface:VariableOwner
Called when one or more variables handled by the implementing class are changed.- Specified by:
changeVariables
in interfaceVariableOwner
- Parameters:
source
- the Source of the variable change. This is the origin of the event. For example in Web Adapter this is the request.variables
- the Mapping from variable names to new variable values.
-
-