public class UIGraphic extends UIComponentBase
UIGraphic is a UIComponent
that displays a graphical image to the user. The user cannot
manipulate this component; it is for display purposes only.
By default, the rendererType
property must be set to "jakarta.faces.Image
". This value can
be changed by calling the setRendererType()
method.
Modifier and Type | Field and Description |
---|---|
static java.lang.String |
COMPONENT_FAMILY
The standard component family for this component.
|
static java.lang.String |
COMPONENT_TYPE
The standard component type for this component.
|
ATTRS_WITH_DECLARED_DEFAULT_VALUES, BEANINFO_KEY, bindings, COMPOSITE_COMPONENT_TYPE_KEY, COMPOSITE_FACET_NAME, CURRENT_COMPONENT, CURRENT_COMPOSITE_COMPONENT, FACETS_KEY, HONOR_CURRENT_COMPONENT_ATTRIBUTES_PARAM_NAME, VIEW_LOCATION_KEY
Constructor and Description |
---|
UIGraphic()
Create a new
UIGraphic instance with default property values. |
Modifier and Type | Method and Description |
---|---|
java.lang.String |
getFamily()
Return the identifier of the component family to which this component belongs. |
java.lang.String |
getUrl()
Return the image URL for this
UIGraphic . |
java.lang.Object |
getValue()
Returns the
value property of the UIGraphic . |
ValueBinding |
getValueBinding(java.lang.String name)
Deprecated.
This has been replaced by
getValueExpression(java.lang.String) . |
ValueExpression |
getValueExpression(java.lang.String name)
Return any
ValueExpression set for value if a ValueExpression for url is
requested; otherwise, perform the default superclass processing for this method. |
void |
setUrl(java.lang.String url)
Set the image URL for this
UIGraphic . |
void |
setValue(java.lang.Object value)
Sets the
value property of the UIGraphic . |
void |
setValueBinding(java.lang.String name,
ValueBinding binding)
Deprecated.
This has been replaced by
setValueExpression(java.lang.String, jakarta.el.ValueExpression) . |
void |
setValueExpression(java.lang.String name,
ValueExpression binding)
Store any
ValueExpression specified for url under value instead; otherwise, perform
the default superclass processing for this method. |
addClientBehavior, addFacesListener, broadcast, clearInitialState, decode, encodeBegin, encodeChildren, encodeEnd, findComponent, getAttributes, getChildCount, getChildren, getClientBehaviors, getClientId, getDefaultEventName, getEventNames, getFacesContext, getFacesListeners, getFacet, getFacetCount, getFacets, getFacetsAndChildren, getId, getListenersForEventClass, getParent, getPassThroughAttributes, getRenderer, getRendererType, getRendersChildren, invokeOnComponent, isRendered, isTransient, markInitialState, processDecodes, processRestoreState, processSaveState, processUpdates, processValidators, queueEvent, removeFacesListener, restoreAttachedState, restoreState, saveAttachedState, saveState, setId, setParent, setRendered, setRendererType, setTransient, subscribeToEvent, unsubscribeFromEvent
encodeAll, getClientId, getCompositeComponentParent, getContainerClientId, getCurrentComponent, getCurrentCompositeComponent, getNamingContainer, getPassThroughAttributes, getResourceBundleMap, getStateHelper, getStateHelper, getTransientStateHelper, getTransientStateHelper, initialStateMarked, isCompositeComponent, isInView, isVisitable, popComponentFromEL, processEvent, pushComponentToEL, restoreTransientState, saveTransientState, setInView, visitTree
public static final java.lang.String COMPONENT_TYPE
The standard component type for this component.
public static final java.lang.String COMPONENT_FAMILY
The standard component family for this component.
public UIGraphic()
Create a new UIGraphic
instance with default property values.
public java.lang.String getFamily()
UIComponent
Return the identifier of the component family to which this component belongs. This identifier, in conjunction with
the value of the rendererType
property, may be used to select the appropriate Renderer
for this
component instance. Note this method should NOT return null
getFamily
in class UIComponent
public java.lang.String getUrl()
Return the image URL for this UIGraphic
. This method is a typesafe alias for getValue()
.
public void setUrl(java.lang.String url)
Set the image URL for this UIGraphic
. This method is a typesafe alias for setValue()
.
url
- The new image URLpublic java.lang.Object getValue()
Returns the value
property of the UIGraphic
. This will typically be rendered as an URL.
public void setValue(java.lang.Object value)
Sets the value
property of the UIGraphic
. This will typically be rendered as an URL.
value
- the new value@Deprecated public ValueBinding getValueBinding(java.lang.String name)
getValueExpression(java.lang.String)
.
Return any ValueBinding
set for value
if a ValueBinding
for url
is
requested; otherwise, perform the default superclass processing for this method.
getValueBinding
in class UIComponentBase
name
- Name of the attribute or property for which to retrieve a ValueBinding
null
.java.lang.NullPointerException
- if name
is null
@Deprecated public void setValueBinding(java.lang.String name, ValueBinding binding)
setValueExpression(java.lang.String, jakarta.el.ValueExpression)
.
Store any ValueBinding
specified for url
under value
instead; otherwise, perform
the default superclass processing for this method. In all cases, the superclass is relied on to convert the
ValueBinding
to a ValueExpression
.
setValueBinding
in class UIComponentBase
name
- Name of the attribute or property for which to set a ValueBinding
binding
- The ValueBinding
to set, or null
to remove any currently set ValueBinding
java.lang.NullPointerException
- if name
is null
public ValueExpression getValueExpression(java.lang.String name)
Return any ValueExpression
set for value
if a ValueExpression
for url
is
requested; otherwise, perform the default superclass processing for this method.
getValueExpression
in class UIComponent
name
- Name of the attribute or property for which to retrieve a ValueExpression
null
.java.lang.NullPointerException
- if name
is null
public void setValueExpression(java.lang.String name, ValueExpression binding)
Store any ValueExpression
specified for url
under value
instead; otherwise, perform
the default superclass processing for this method.
setValueExpression
in class UIComponent
name
- Name of the attribute or property for which to set a ValueExpression
binding
- The ValueExpression
to set, or null
to remove any currently set
ValueExpression
java.lang.NullPointerException
- if name
is null