|
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
javax.faces.component Class UIGraphic
java.lang.Object javax.faces.component.UIComponent javax.faces.component.UIComponentBase javax.faces.component.UIGraphic
- All Implemented Interfaces:
- StateHolder
- Direct Known Subclasses:
- HtmlGraphicImage
public class UIGraphic
- extends UIComponentBase
UIGraphic 是将图形图像显示给用户的 UIComponent
。用户无法操作此组件;它仅用于显示目的。
默认情况下,rendererType
属性必须设置为 "javax.faces.Image
"。可以调用 setRendererType()
方法更改此值。
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
"javax.faces.Image
". This value can be changed by calling the
setRendererType()
method.
Field Summary | |
---|---|
static String |
COMPONENT_FAMILY
The standard component family for this component. |
static String |
COMPONENT_TYPE
The standard component type for this component. |
Fields inherited from class javax.faces.component.UIComponent |
---|
bindings |
Constructor Summary | |
---|---|
UIGraphic()
Create a new UIGraphic instance with default property
values. |
Method Summary | |
---|---|
String |
getFamily()
Return the identifier of the component family to which this component belongs. |
String |
getUrl()
Return the image URL for this UIGraphic . |
Object |
getValue()
Returns the value property of the
UIGraphic . |
ValueBinding |
getValueBinding(String name)
Deprecated. This has been replaced by getValueExpression(java.lang.String) . |
ValueExpression |
getValueExpression(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 |
restoreState(FacesContext context,
Object state)
Perform any processing required to restore the state from the entries in the state Object. |
Object |
saveState(FacesContext context)
Gets the state of the instance as a Serializable Object. |
void |
setUrl(String url)
Set the image URL for this UIGraphic . |
void |
setValue(Object value)
Sets the value property of the UIGraphic . |
void |
setValueBinding(String name,
ValueBinding binding)
Deprecated. This has been replaced by setValueExpression(java.lang.String, javax.el.ValueExpression) . |
void |
setValueExpression(String name,
ValueExpression binding)
Store any ValueExpression specified for url under
value instead; otherwise, perform the default superclass
processing for this method. |
Methods inherited from class javax.faces.component.UIComponent |
---|
encodeAll, getContainerClientId |
Methods inherited from class java.lang.Object |
---|
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
Field Detail |
---|
英文文档:
COMPONENT_TYPE
public static final String COMPONENT_TYPE
The standard component type for this component.
- See Also:
- Constant Field Values
英文文档:
COMPONENT_FAMILY
public static final String COMPONENT_FAMILY
The standard component family for this component.
- See Also:
- Constant Field Values
Constructor Detail |
---|
public
UIGraphic()
使用默认属性值创建新的 UIGraphic
实例。
UIGraphic
public UIGraphic()
Create a new
UIGraphic
instance with default property values.
Method Detail |
---|
public String
getFamily()
英文文档:
getFamily
public String getFamily()
- Description copied from class:
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 appropriateRenderer
for this component instance.- Specified by:
getFamily
in classUIComponent
public String
getUrl()
返回此 UIGraphic
的图像 URL。此方法是 getValue()
的一个类型安全别名。
getUrl
public String getUrl()
Return the image URL for this
UIGraphic
. This method is a typesafe alias forgetValue()
.
public void
setUrl(String url)
设置此 UIGraphic
的图像 URL。此方法是 setValue()
的一个类型安全别名。
url | 新的图像 URL |
setUrl
public void setUrl(String url)
Set the image URL for this
UIGraphic
. This method is a typesafe alias forsetValue()
.- Parameters:
url
- The new image URL
public Object
getValue()
返回 UIGraphic
的 value
属性。这通常呈现为一个 URL。
getValue
public Object getValue()
Returns the
value
property of theUIGraphic
. This will typically be rendered as an URL.
public void
setValue(Object value)
设置 UIGraphic
的 value
属性。这通常呈现为一个 URL。
value | 新值 |
setValue
public void setValue(Object value)
Sets the
value
property of theUIGraphic
. This will typically be rendered as an URL.- Parameters:
value
- the new value
public ValueBinding
getValueBinding(String name)
如果请求 url
的 ValueBinding
,则返回任何为 value
设置的 ValueBinding
;否则,执行此方法的默认超类处理。
name |
要为其获取 ValueBinding 的属性的名称 |
Throws | NullPointerException:
如果 name 为 null |
deprecated |
此方法已由 #getValueExpression(java.lang.String) 替代。 |
getValueBinding
public ValueBinding getValueBinding(String name)
- Deprecated. This has been replaced by
getValueExpression(java.lang.String)
. Return any
ValueBinding
set forvalue
if aValueBinding
forurl
is requested; otherwise, perform the default superclass processing for this method.- Overrides:
getValueBinding
in classUIComponentBase
- Parameters:
name
- Name of the attribute or property for which to retrieve aValueBinding
- Throws:
NullPointerException
- ifname
isnull
public void
setValueBinding(String name, ValueBinding binding)
改为存储 value
下为 url
指定的任何 ValueBinding
;否则,执行此方法的默认超类处理。在任何情况下,都要依赖超类将 ValueBinding
转换为 ValueExpression
。
name |
要为其设置 ValueBinding 的属性的名称 |
binding |
要设置的 ValueBinding ,或为 null 以移除任何当前设置的 ValueBinding |
Throws | NullPointerException:
如果 name 为 null |
deprecated |
此方法已由 #setValueExpression 替代。 |
setValueBinding
public void setValueBinding(String name, ValueBinding binding)
- Deprecated. This has been replaced by
setValueExpression(java.lang.String, javax.el.ValueExpression)
. Store any
ValueBinding
specified forurl
undervalue
instead; otherwise, perform the default superclass processing for this method. In all cases, the superclass is relied on to convert theValueBinding
to aValueExpression
.- Overrides:
setValueBinding
in classUIComponentBase
- Parameters:
name
- Name of the attribute or property for which to set aValueBinding
binding
- TheValueBinding
to set, ornull
to remove any currently setValueBinding
- Throws:
NullPointerException
- ifname
isnull
public ValueExpression
getValueExpression(String name)
如果请求 url
的 ValueExpression
,则返回任何为 value
设置的 ValueExpression
;否则,执行此方法的默认超类处理。
name |
要为其获取 ValueExpression 的属性的名称 |
Throws | NullPointerException:
如果 name 为 null |
since | 1.2 |
getValueExpression
public ValueExpression getValueExpression(String name)
Return any
ValueExpression
set forvalue
if aValueExpression
forurl
is requested; otherwise, perform the default superclass processing for this method.- Overrides:
getValueExpression
in classUIComponent
- Parameters:
name
- Name of the attribute or property for which to retrieve aValueExpression
- Throws:
NullPointerException
- ifname
isnull
- Since:
- 1.2
public void
setValueExpression(String name, ValueExpression binding)
改为存储 value
下为 url
指定的任何 ValueExpression
;否则,执行此方法的默认超类处理。
name |
要为其设置 ValueExpression 的属性的名称 |
binding |
要设置的 ValueExpression ,或为 null 以移除任何当前设置的 ValueExpression |
Throws | NullPointerException:
如果 name 为 null |
since | 1.2 |
setValueExpression
public void setValueExpression(String name, ValueExpression binding)
Store any
ValueExpression
specified forurl
undervalue
instead; otherwise, perform the default superclass processing for this method.- Overrides:
setValueExpression
in classUIComponent
- Parameters:
name
- Name of the attribute or property for which to set aValueExpression
binding
- TheValueExpression
to set, ornull
to remove any currently setValueExpression
- Throws:
NullPointerException
- ifname
isnull
- Since:
- 1.2
public Object
saveState(FacesContext context)
英文文档:
saveState
public Object saveState(FacesContext context)
- Description copied from interface:
StateHolder
Gets the state of the instance as a
Serializable
Object.If the class that implements this interface has references to instances that implement StateHolder (such as a
UIComponent
with event handlers, validators, etc.) this method must call theStateHolder.saveState(javax.faces.context.FacesContext)
method on all those instances as well. This method must not save the state of children and facets. That is done via theStateManager
This method must not alter the state of the implementing object. In other words, after executing this code:
Object state = component.saveState(facesContext);
component
should be the same as before executing it.The return from this method must be
Serializable
- Specified by:
saveState
in interfaceStateHolder
- Overrides:
saveState
in classUIComponentBase
public void
restoreState(FacesContext context, Object state)
英文文档:
restoreState
public void restoreState(FacesContext context, Object state)
- Description copied from interface:
StateHolder
Perform any processing required to restore the state from the entries in the state Object.
If the class that implements this interface has references to instances that also implement StateHolder (such as a
UIComponent
with event handlers, validators, etc.) this method must call theStateHolder.restoreState(javax.faces.context.FacesContext, java.lang.Object)
method on all those instances as well.- Specified by:
restoreState
in interfaceStateHolder
- Overrides:
restoreState
in classUIComponentBase
|
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
Submit a bug or feature
Copyright 2007 Sun Microsystems, Inc. All rights reserved. Use is subject to license terms.
PS : 未经我党受权你也可自由散发此文档。 如有任何错误请自行修正;若因此而造成任何损失请直接找人民主席,请勿与本人联系。谢谢!