JavaTM 2 Platform
Standard Ed. 5.0

java.beans
类 FeatureDescriptor

java.lang.Object
  继承者 java.beans.FeatureDescriptor
直接已知子类:
BeanDescriptor, EventSetDescriptor, MethodDescriptor, ParameterDescriptor, PropertyDescriptor

public class FeatureDescriptor
extends Object

FeatureDescriptor 类是 PropertyDescriptor、EventSetDescriptor 和 MethodDescriptor 等的公共基类。

它支持一些可以设置和检索任意的内省描述符(introspection descriptor)的公共信息。

此外,它还提供了一种扩展机制,从而任意属性/值对都可以与设计特性相关联。


构造方法摘要
FeatureDescriptor()
          构造一个 FeatureDescriptor
 
方法摘要
 Enumeration<String> attributeNames()
          获得此特性的语言环境无关名称的枚举。
 String getDisplayName()
          获得此特性的本地化显示名称。
 String getName()
          获得此特性的编程名称。
 String getShortDescription()
          获得此特性的简短描述。
 Object getValue(String attributeName)
          利用此特性检索特定属性。
 boolean isExpert()
          "expert" 标志用于区别那些打算供高级用户使用的特定与那些打算供普通用户使用的特性。
 boolean isHidden()
          "hidden" 标志用于标识只打算供工具使用、不应对人类开放的特性。
 boolean isPreferred()
          "preferred" 标志用于标识呈现给用户的特别重要的特性。
 void setDisplayName(String displayName)
          设置此特性的本地化显示名称。
 void setExpert(boolean expert)
          "expert" 标志用于区别打算供高级用户使用的特性和那些打算供普通用户使用的特性。
 void setHidden(boolean hidden)
          "hidden" 标志用于标识只打算供工具使用、不应对人类开放的特性。
 void setName(String name)
          设置此特性的编程名称。
 void setPreferred(boolean preferred)
          "preferred" 标志用于标识呈现给用户的特别重要的特性。
 void setShortDescription(String text)
          可以将简短描述与某一特性相关联。
 void setValue(String attributeName, Object value)
          将某一指定属性与此特性相关联。
 
从类 java.lang.Object 继承的方法
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

构造方法详细信息

FeatureDescriptor

public FeatureDescriptor()
构造一个 FeatureDescriptor

方法详细信息

getName

public String getName()
获得此特性的编程名称。

返回:
属性/方法/事件的编程名称

setName

public void setName(String name)
设置此特性的编程名称。

参数:
name - 属性/方法/事件的编程名称

getDisplayName

public String getDisplayName()
获得此特性的本地化显示名称。

返回:
属性/方法/事件的本地化显示名称。此名称默认与 getName 返回的编程名称相同。

setDisplayName

public void setDisplayName(String displayName)
设置此特性的本地化显示名称。

参数:
displayName - 属性/方法/事件的本地化显示名称。

isExpert

public boolean isExpert()
"expert" 标志用于区别那些打算供高级用户使用的特定与那些打算供普通用户使用的特性。

返回:
如果此特性只打算供高级用户使用,则返回 true。

setExpert

public void setExpert(boolean expert)
"expert" 标志用于区别打算供高级用户使用的特性和那些打算供普通用户使用的特性。

参数:
expert - 如果此特性只打算供高级用户使用,则该参数为 true。

isHidden

public boolean isHidden()
"hidden" 标志用于标识只打算供工具使用、不应对人类开放的特性。

返回:
如果应对人类用户隐藏此特性,则返回 true。

setHidden

public void setHidden(boolean hidden)
"hidden" 标志用于标识只打算供工具使用、不应对人类开放的特性。

参数:
hidden - 如果应对人类用户隐藏此特性,则该参数为 true。

isPreferred

public boolean isPreferred()
"preferred" 标志用于标识呈现给用户的特别重要的特性。

返回:
如果应该优先向人类用户显示此特性,则返回 true。

setPreferred

public void setPreferred(boolean preferred)
"preferred" 标志用于标识呈现给用户的特别重要的特性。

参数:
preferred - 如果应该优先向人类用户显示此特性,则该参数为 true。

getShortDescription

public String getShortDescription()
获得此特性的简短描述。

返回:
与此属性/方法/事件有关的本地化简短描述。默认简短描述为显示名称。

setShortDescription

public void setShortDescription(String text)
可以将简短描述与某一特性相关联。这些描述性字符串通常应该少于 40 个字符。

参数:
text - 与此属性/方法/事件有关的(本地化)简短描述。

setValue

public void setValue(String attributeName,
                     Object value)
将某一指定属性与此特性相关联。

参数:
attributeName - 属性的与语言环境无关的名称
value - 值。

getValue

public Object getValue(String attributeName)
利用此特性检索特定属性。

参数:
attributeName - 属性的与语言环境无关的名称
返回:
属性值。如果属性是未知的,则返回 null。

attributeNames

public Enumeration<String> attributeNames()
获得此特性的语言环境无关名称的枚举。

返回:
已向 setValue 注册的所有属性的语言环境无关名称的枚举。

JavaTM 2 Platform
Standard Ed. 5.0

提交错误或意见
有关更多的 API 参考资料和开发人员文档,请参阅 Java 2 SDK SE 开发人员文档。该文档包含更详细的、面向开发人员的描述,以及总体概述、术语定义、使用技巧和工作代码示例。

版权所有 2004 Sun Microsystems, Inc. 保留所有权利。 请遵守许可证条款。另请参阅文档重新分发政策