com.fr.form.ui

类 Widget

java.lang.Object

com.fr.config.utils.CacheData

com.fr.config.utils.UniqueKey

com.fr.form.event.Observer

com.fr.form.ui.Widget

所有已实现的接口:

MixinControlWidget, FCloneable, XMLable, XMLReadable, XMLWriter, java.io.Serializable, java.lang.Cloneable

直接已知子类:

AbstractBorderStyleWidget, AbstractDataControl, Button, Composite, Composite, Composite.CompositeLayout, Composite.CompositeLayout, CRBoundsWidget, FieldEditor, NameWidget, NoneWidget, ToolBar

public abstract class Widget
extends Observer
implements MixinControlWidget

另请参阅:

序列化表格

字段概要

字段

限定符和类型	字段和说明
static java.lang.String	AFTEREDIT
static java.lang.String	AFTERINIT
static java.lang.String	BEFOREEDIT
static java.lang.String	CHANGE
static int	DEFAULT_FONT_SIZE
protected boolean	disabled 是否不可用
static java.lang.String	EVENT_CLICK
static java.lang.String	EVENT_STATECHANGE
protected boolean	invisible 是否不可见
static java.lang.String	STOPEDIT
protected java.lang.String	widgetName 控件名称
static java.lang.String	XML_TAG

构造器概要

构造器

构造器和说明
Widget()

方法概要

方法

限定符和类型	方法和说明
boolean	acceptType(java.lang.Class<?>... acceptTypes) 是否接收这种类型
void	changeOnlyVisibleAuthorityState(java.lang.String selectedRole, boolean isVisible) 判断对应的角色的单元格的可见状态，是否做过权限编辑，若是做过权限编辑，则加入都已经做过权限编辑的角色列表中
void	changeUsableAuthorityState(java.lang.String selectedRole, boolean isUsable) 判断对应的角色的单元格的可见状态，是否做过权限编辑，若是做过权限编辑，则加入都已经做过权限编辑的角色列表中
void	changeVisibleAuthorityState(java.lang.String selectedRole, boolean isVisible) 判断对应的角色的单元格的可见状态，是否做过权限编辑，若是做过权限编辑，则加入都已经做过权限编辑的角色列表中
void	cleanAuthority(java.lang.String selectedRole) 清除对应角色的权限
java.lang.Object	clone()
JSONObject	createJSONConfig(Repository repo, Calculator c, NodeVisitor nodeVisitor) 以JSONObject方式返回Widget的配置信息
void	dealInvisible() 处理组件内部不可见组件
java.lang.Object	dealWithPresentableValue(java.lang.String value) 控件所在单元格设置了形态的话，某些控件需要对value值特殊处理， 比如树控件可能需要将字符串当成json格式解析 其他类似有类似需求，就要重写此方法
boolean	equals(java.lang.Object obj)
int	getContentHeight()
int	getContentWidth()
java.lang.String	getDescription()
static java.lang.String	getDisableAction() 设置控件为不可用的JavaScript函数
static java.lang.String	getEnableAction() 设置控件为可用的JavaScript函数
static java.lang.String	getInvisibleAction() 设置控件为不可见的JavaScript函数
java.lang.String	getLabelName()
static java.lang.String	getVisibleAction() 设置控件为可见的JavaScript函数
java.lang.String	getWidgetName() 获取组件的名字，在一个模板中，该名字应该具有唯一性
WidgetPrivilegeControl	getWidgetPrivilegeControl()
abstract java.lang.String	getXType() 控件xType,每个控件的特有标记和控件一一对应
boolean	hasDataOnInit() 某些控件需要在后台创建配置信息的时候就构建数据 而不必到web端初始化后再发送请求获取数据 如单选按钮组 复选框组 视图树 列表
int	hashCode() hash码
boolean	isChartRelated() 是否关联
boolean	isDirtyWidget(java.lang.String selectedRoles) 是否被编辑过 如果控件本身可见 & 可用, 那么返回不可见, 不可用列表 否则返回可见列表, 可用列表 混合的情况暂不考虑, 意义不大.
boolean	isDoneUsableAuthority(java.lang.String selectedRole) 判断对听的角色是否做过权限编辑
boolean	isDoneVisibleAuthority(java.lang.String selectedRole) 判断对听的角色是否做过权限编辑
abstract boolean	isEditor() 是否是一个不需要在填报状态直接显示的编辑器
boolean	isEnabled() 是否能用
boolean	isUsableAuthority(java.lang.String selectedRole) 判断对监听的角色是否做过权限编辑
boolean	isVisible() 是否可见
boolean	isVisibleAuthority(java.lang.String selectedRole) 判断对监听的角色是否做过权限编辑
void	readXML(XMLableReader reader) Read XML.
void	resize(double width, double height) 调整组件到指定的大小
void	resize(double width, double height, double fontScale) 调整组件到指定的大小
void	setChartRelated(boolean isChartRelated)
void	setDescription(java.lang.String description) 设置信息描述
void	setEnabled(boolean enabled) 设置组件的可用性
void	setLabelName(java.lang.String labelName)
void	setVisible(boolean isVisible) 设置组件的可见性
void	setWidgetName(java.lang.String widgetName) 设置组件的名字
void	setWidgetPrivilegeControl(WidgetPrivilegeControl widgetPrivilegeControl)
boolean	supportMobile() 支持移动
void	toImage(Calculator ca, java.awt.Rectangle rec, java.awt.Graphics g) 将当前控件转化为图片, 目前支持报表块与图表块
java.awt.image.BufferedImage	toImage(java.lang.Object value, int pxWidth, int pxHeight, Style style) 将当前单元格里的控件转化为图片, 主要用于打印复选框与复选框组
java.lang.String	toString() String类型输出
void	updateChildBounds(java.awt.Rectangle bound) 更新子控件的bound
java.lang.Object	value2Config(java.lang.Object value, CalculatorProvider ca) 转换为config信息的value有时候需要做特殊处理，针对不同控件可能有不同的处理方式。
void	writeXML(XMLPrintWriter writer) Write XML.

从类继承的方法 com.fr.form.event.Observer

addListener, clearListeners, createJSONListener, createListeners, dealWithListener4Compatible, getConvertMap, getListener, getListenerSize, supportedEvents

从类继承的方法 com.fr.config.utils.UniqueKey

copy, getId, getNameSpace, setId, setNameSpace

从类继承的方法 com.fr.config.utils.CacheData

getClassInfo, getData, invalidate, isLoad, setClassInfo, setData

从类继承的方法 java.lang.Object

finalize, getClass, notify, notifyAll, wait, wait, wait

字段详细资料

DEFAULT_FONT_SIZE

public static int DEFAULT_FONT_SIZE

EVENT_CLICK

public static final java.lang.String EVENT_CLICK

另请参阅:

常量字段值

AFTERINIT

public static final java.lang.String AFTERINIT

另请参阅:

常量字段值

BEFOREEDIT

public static final java.lang.String BEFOREEDIT

另请参阅:

常量字段值

AFTEREDIT

public static final java.lang.String AFTEREDIT

另请参阅:

常量字段值

CHANGE

public static final java.lang.String CHANGE

另请参阅:

常量字段值

STOPEDIT

public static final java.lang.String STOPEDIT

另请参阅:

常量字段值

EVENT_STATECHANGE

public static final java.lang.String EVENT_STATECHANGE

另请参阅:

常量字段值

XML_TAG

public static final java.lang.String XML_TAG

另请参阅:

常量字段值

disabled

protected boolean disabled

是否不可用

invisible

protected boolean invisible

是否不可见

widgetName

protected java.lang.String widgetName

控件名称

构造器详细资料

Widget

public Widget()

方法详细资料

getXType

public abstract java.lang.String getXType()

控件xType,每个控件的特有标记和控件一一对应

返回:

控件的xType

isEditor

public abstract boolean isEditor()

是否是一个不需要在填报状态直接显示的编辑器

返回:

是返回true

getDescription

public java.lang.String getDescription()

setDescription

public void setDescription(java.lang.String description)

设置信息描述

参数:

description - 描述

getLabelName

public java.lang.String getLabelName()

setLabelName

public void setLabelName(java.lang.String labelName)

getWidgetName

public java.lang.String getWidgetName()

从接口复制的说明: MixinControlWidget

获取组件的名字，在一个模板中，该名字应该具有唯一性

指定者:

getWidgetName 在接口中 MixinControlWidget

返回:

组件名字

setWidgetName

public void setWidgetName(java.lang.String widgetName)

从接口复制的说明: MixinControlWidget

设置组件的名字

指定者:

setWidgetName 在接口中 MixinControlWidget

参数:

widgetName - 组件名字

isEnabled

public boolean isEnabled()

是否能用

指定者:

isEnabled 在接口中 MixinControlWidget

返回:

是则返回true

setEnabled

public void setEnabled(boolean enabled)

从接口复制的说明: MixinControlWidget

设置组件的可用性

指定者:

setEnabled 在接口中 MixinControlWidget

参数:

enabled - 如果该参数为true，表示设置组件为可用，否则设置为不可用

isVisible

public boolean isVisible()

是否可见

指定者:

isVisible 在接口中 MixinControlWidget

返回:

可见

hasDataOnInit

public boolean hasDataOnInit()

某些控件需要在后台创建配置信息的时候就构建数据 而不必到web端初始化后再发送请求获取数据 如单选按钮组 复选框组 视图树 列表

返回:

返回false

setVisible

public void setVisible(boolean isVisible)

从接口复制的说明: MixinControlWidget

设置组件的可见性

指定者:

setVisible 在接口中 MixinControlWidget

参数:

isVisible - 如果该参数为true，表示设置组件为可见，否则设置为不可见

dealInvisible

public void dealInvisible()
                   throws java.lang.Exception

处理组件内部不可见组件

抛出:

java.lang.Exception

isDirtyWidget

public boolean isDirtyWidget(java.lang.String selectedRoles)

是否被编辑过 如果控件本身可见 & 可用, 那么返回不可见, 不可用列表 否则返回可见列表, 可用列表 混合的情况暂不考虑, 意义不大.

参数:

selectedRoles - 当前选中的角色

返回:

是否被编辑过

isVisibleAuthority

public boolean isVisibleAuthority(java.lang.String selectedRole)

判断对监听的角色是否做过权限编辑

参数:

selectedRole - 角色

返回:

是则返回true

isUsableAuthority

public boolean isUsableAuthority(java.lang.String selectedRole)

判断对监听的角色是否做过权限编辑

参数:

selectedRole - 角色

返回:

是则返回true

isDoneVisibleAuthority

public boolean isDoneVisibleAuthority(java.lang.String selectedRole)

判断对听的角色是否做过权限编辑

参数:

selectedRole - 角色

返回:

是则返回true

isDoneUsableAuthority

public boolean isDoneUsableAuthority(java.lang.String selectedRole)

判断对听的角色是否做过权限编辑

参数:

selectedRole - 角色

返回:

是则返回true

changeVisibleAuthorityState

public void changeVisibleAuthorityState(java.lang.String selectedRole,
                               boolean isVisible)

判断对应的角色的单元格的可见状态，是否做过权限编辑，若是做过权限编辑，则加入都已经做过权限编辑的角色列表中

参数:

selectedRole - 角色

isVisible - 是否可见

changeOnlyVisibleAuthorityState

public void changeOnlyVisibleAuthorityState(java.lang.String selectedRole,
                                   boolean isVisible)

判断对应的角色的单元格的可见状态，是否做过权限编辑，若是做过权限编辑，则加入都已经做过权限编辑的角色列表中

参数:

selectedRole - 角色

isVisible - 是否可见

changeUsableAuthorityState

public void changeUsableAuthorityState(java.lang.String selectedRole,
                              boolean isUsable)

判断对应的角色的单元格的可见状态，是否做过权限编辑，若是做过权限编辑，则加入都已经做过权限编辑的角色列表中

参数:

selectedRole - 角色

isUsable - 是否可用

cleanAuthority

public void cleanAuthority(java.lang.String selectedRole)

清除对应角色的权限

参数:

selectedRole - 角色

setChartRelated

public void setChartRelated(boolean isChartRelated)

isChartRelated

public boolean isChartRelated()

是否关联

返回:

是则返回true

acceptType

public boolean acceptType(java.lang.Class<?>... acceptTypes)

是否接收这种类型

参数:

acceptTypes - 接收的类型

返回:

接收指定的类型则返回true, 否则返回false

supportMobile

public boolean supportMobile()

支持移动

返回:

是则返回true

updateChildBounds

public void updateChildBounds(java.awt.Rectangle bound)

更新子控件的bound

参数:

bound - 位置大小

getWidgetPrivilegeControl

public WidgetPrivilegeControl getWidgetPrivilegeControl()

setWidgetPrivilegeControl

public void setWidgetPrivilegeControl(WidgetPrivilegeControl widgetPrivilegeControl)

clone

public java.lang.Object clone()
                       throws java.lang.CloneNotSupportedException

指定者:

clone 在接口中 FCloneable

覆盖:

clone 在类中 Observer

返回:

克隆后的对象

抛出:

java.lang.CloneNotSupportedException - 如果克隆失败则抛出此异常

createJSONConfig

public JSONObject createJSONConfig(Repository repo,
                          Calculator c,
                          NodeVisitor nodeVisitor)
                            throws JSONException

以JSONObject方式返回Widget的配置信息

参数:

repo - 参数repo

c - 指定解析器

nodeVisitor - 节点访问

返回:

JSONObject 返回的

抛出:

JSONException - 异常

toImage

public void toImage(Calculator ca,
           java.awt.Rectangle rec,
           java.awt.Graphics g)

将当前控件转化为图片, 目前支持报表块与图表块

参数:

ca - 算子

rec - 图片的位置大小

g - 画板

toImage

public java.awt.image.BufferedImage toImage(java.lang.Object value,
                                   int pxWidth,
                                   int pxHeight,
                                   Style style)

将当前单元格里的控件转化为图片, 主要用于打印复选框与复选框组

参数:

value - 当前格子的值

pxWidth - 控件的宽度

pxHeight - 控件的高度

style - 当前格子的样式

返回:

返回null

value2Config

public java.lang.Object value2Config(java.lang.Object value,
                            CalculatorProvider ca)

转换为config信息的value有时候需要做特殊处理，针对不同控件可能有不同的处理方式。

参数:

value - 值

ca - 计算器

返回:

特殊处理

getEnableAction

public static java.lang.String getEnableAction()

设置控件为可用的JavaScript函数

返回:

JavaScript字符串

getDisableAction

public static java.lang.String getDisableAction()

设置控件为不可用的JavaScript函数

返回:

JavaScript字符串

getVisibleAction

public static java.lang.String getVisibleAction()

设置控件为可见的JavaScript函数

返回:

JavaScript字符串

getInvisibleAction

public static java.lang.String getInvisibleAction()

设置控件为不可见的JavaScript函数

返回:

JavaScript字符串

getContentWidth

public int getContentWidth()

getContentHeight

public int getContentHeight()

resize

public void resize(double width,
          double height)

调整组件到指定的大小

参数:

width - 指定的宽度

height - 指定的高度

resize

public void resize(double width,
          double height,
          double fontScale)

调整组件到指定的大小

参数:

width - 指定的宽度

height - 指定的高度

fontScale - 字体缩放的比例

dealWithPresentableValue

public java.lang.Object dealWithPresentableValue(java.lang.String value)
                                          throws java.lang.Exception

控件所在单元格设置了形态的话，某些控件需要对value值特殊处理， 比如树控件可能需要将字符串当成json格式解析 其他类似有类似需求，就要重写此方法

参数:

value - 控件值

返回:

处理后可被识别的控件值

抛出:

java.lang.Exception

toString

public java.lang.String toString()

String类型输出

覆盖:

toString 在类中 java.lang.Object

返回:

输出

readXML

public void readXML(XMLableReader reader)

Read XML.
The method will be invoked when read data from XML file.
May override the method to read the data that you saved.

指定者:

readXML 在接口中 XMLReadable

覆盖:

readXML 在类中 Observer

参数:

reader - XML读取对象

另请参阅:

XMLableReader

writeXML

public void writeXML(XMLPrintWriter writer)

Write XML.
The method will be invoked when save data to XML file.
May override the method to save your own data.

指定者:

writeXML 在接口中 XMLWriter

覆盖:

writeXML 在类中 Observer

参数:

writer - the PrintWriter.

hashCode

public int hashCode()

hash码

覆盖:

hashCode 在类中 java.lang.Object

返回:

返回int

equals

public boolean equals(java.lang.Object obj)

覆盖:

equals 在类中 Observer