希望提供其 bean 的顯式信息的 bean 實現(xiàn)者可提供實現(xiàn)該 BeanInfo 接口的
BeanInfo 類和關于 bean 的方法、特性、事件等的顯式信息。
bean 實現(xiàn)者不必提供顯式信息的完全集。挑選要提供的信息, 其剩余的通過使用
bean 類的方法的低級反應和應用標準設計模式來自動分析獲取。
獲得提供許多不同信息作為各種 XyZDescriptor 類部分的機會。但不要擔心,實際上僅需提供
各構造子必需的最小核心信息。
參見提供 BeanInfo 類某便捷“noop”基類的 SimpleBeanInfo 類,可覆蓋用于返回顯式 info
的特定位置。
關于 bean 的所有行為參見 Introspector 類。
接口 java.beans.BeanInfo
接口 java.beans.BeanInfo
- public interface BeanInfo
變量索引
- ICON_COLOR_16x16
- 指示一個 16 x 16 色彩圖標的 Constant。
- ICON_COLOR_32x32
- 指示一個 32 x 32 色彩圖標的 Constant。
- ICON_MONO_16x16
- 指示一個 16 x 16 黑白圖標的 Constant。
- ICON_MONO_32x32
- 指示一個 32 x 32 黑白圖標的 Constant。
方法索引
- getAdditionalBeanInfo()
- 該方法允許一個 BeanInfo 對象返回可提供當前 bean 上附加信息的其它 BeanInfo 對
象的任意集合。
- getBeanDescriptor()
-
- getDefaultEventIndex()
- 一個 bean 可以有一個“缺省”事件,當使用 bean 時用戶通常使用該事件。
- getDefaultPropertyIndex()
- 一個 bean 可以有一個“缺省”特性,它是定制該 bean
的用戶為了更新而開始通常選擇的特性。 - getEventSetDescriptors()
-
- getIcon(int)
- 該方法返回一個圖像實體,用于表示工具箱、工具條等的 bean 。
-
href="#getMethodDescriptors()">getMethodDescriptors()
-
- getPropertyDescriptors()
-
變量
ICON_COLOR_16x16
public static final int ICON_COLOR_16x16
- 指示一個 16 x 16 色彩圖標的 Constant 。
ICON_COLOR_32x32
public static final int ICON_COLOR_32x32
- 指示一個 32 x 32 色彩圖標的 Constant 。
ICON_MONO_16x16
public static final int ICON_MONO_16x16
- 指示一個 16 x 16 黑白圖標的 Constant 。
ICON_MONO_32x32
public static final int ICON_MONO_32x32
- 指示一個 32 x 32 黑白圖標的Constant 。
方法
getBeanDescriptor
public abstract
href="java.beans.beandescriptor_dsc.htm#_top_">BeanDescriptor getBeanDescriptor
()
- 返回值:
- BeanDescriptor 提供關于 bean 的所有信息, 例如其
displayName 、 customizer 等。若信息應通過自動分析獲得,則返回 null 。
getEventSetDescriptors
public abstract
href="java.beans.eventsetdescriptor_dsc.htm#_top_">EventSetDescriptor[]
getEventSetDescriptors()
- 返回值:
- 描述該 bean 所激發(fā)的事件種類的 EventSetDescriptors 數(shù)組。若信息應通過自動分析獲
得,則可以返回 null 。
getDefaultEventIndex
public abstract int getDefaultEventIndex()
- 一個 bean 可以有一個“缺省”事件,當使用 bean 時用戶通常使用該事件。
- 返回值:
- getEventSetDescriptors 所返回的 EventSetDescriptor 數(shù)組中的缺省事件索引。
若
無缺省事件,則返回 -1。
getPropertyDescriptors
public abstract
href="java.beans.propertydescriptor_dsc.htm#_top_">PropertyDescriptor[]
getPropertyDescriptors()
- 返回值:
- 描述該 bean 支持的可編輯特性的 PropertyDescriptors 數(shù)組。若信息應通過自動分析獲
得,則可以返回 null。
若某個特性被索引,則結果數(shù)組中它的輸入項將屬于 PropertyDescriptor 的
IndexedPropertyDescriptor 子類。getPropertyDescriptors 的客戶能用“
instanceof”來檢驗某個給定的 PropertyDescriptor 是否為
IndexedPropertyDescriptor。
getDefaultPropertyIndex
public abstract int getDefaultPropertyIndex()
- 一個 bean 可以有一個“缺省”特性,它是定制該 bean
的用戶為了更新而最經(jīng)常選擇的特性。
- 返回值:
- getPropertyDescriptors 返回的 PropertyDescriptors 數(shù)組中的缺省特性索引。
若無
缺省特性,則返回 -1。
getMethodDescriptors
public abstract
href="java.beans.methoddescriptor_dsc.htm#_top_">MethodDescriptor[]
getMethodDescriptors()
- 返回值:
- 描述該 bean 所支持的永久可見方法的 MethodDescriptors 數(shù)組。若信息應通過自動分析
獲得,則可以返回 null。
getAdditionalBeanInfo
public abstract BeanInfo[] getAdditionalBeanInfo()
- 該方法允許一個 BeanInfo 對象返回提供當前 bean 上附加信息的其它
BeanInfo 對象的任意集合。
在不同 Beaninfo 對象提供的信息間若有沖突或重疊,則當前 BeanInfo 優(yōu)先于
getAdditionalBeanInfo 對象,數(shù)組中后面的元素優(yōu)先于前面的。
- 返回值:
- BeanInfo 對象數(shù)組??煞祷?null。
getIcon
public abstract Image getIcon(int
iconKind)
- 該方法返回表示工具箱、工具條等中的 bean 。典型的圖像圖標是 GIF
,但將來可能包含其它格式。Beans 不必提供圖標并其且該方法可返回 null。
有四個可能的圖標選項 (16x16 色、
32x32 色、 16x16 黑白色、32x32 黑白色) 。若選擇某個 bean 僅支持單個圖標,則建議支持
16x16 色。
建議圖標有“透明”背景,以便能將其描繪到某個現(xiàn)存背景上。
- 參數(shù):
- iconKind - 請求圖標種類。應為常量值 ICON_COLOR_16x16、
ICON_COLOR_32x32、
ICON_MONO_16x16 或 ICON_MONO_32x32 之一。
- 返回值:
- 表示請求圖標的一個圖像實體。若無合適圖標可用,則返回 null。