javatm platform
standard ed. 6

javax.swing.text
类 stylecontext

java.lang.object 继承者 javax.swing.text.stylecontext
所有【suǒ yǒu】已实现的接口:
serializable, abstractdocument.attributecontext
直接已知子类:
stylesheet

public class stylecontext
extends object
implements serializable, abstractdocument.attributecontext

样式池及其关联的资源。此类用于确定资源组的生存期,假定该资源组是一个容器,它保持各种资源的缓存,这些资源(如字体【Typeface】和颜色等)通过各种样式定义得以重用。如果需要最大【largest】化相关资源的共享,则可由多个文档来共享此类。

此类还对小属性集提供有效支持【zhī chí】,并通过共享和利用其不变的特性来压缩这些小属性集。因为许多【xǔ duō】样式都是重复的,所以共享的潜能非常大,而且【but】复制成本【cost】也相当低廉。较大的集合降低了共享的可能【would】性,并因此【 yīn cǐ】自动转换回一种空间利用率低的实现。

警告:此类的已序列化对象与以后的 swing 版本不兼容。当前序列化支持【zhī chí】适用于短期存储或运行相同 swing 版本的应用程序之间的 rmi。从 1.4 版本开始【appeared】,已在 java.beans 包中添加了支持所有 javabeanstm 长期存储的功能。请参见 xmlencoder


嵌套类摘要
 classstylecontext.namedstyle
          通常用于表示字符和段落样式的属性集合。
 classstylecontext.smallattributeset
          此类可在数组中存储少量的属性。
 
字段摘要
static stringdefault_style
          赋予与段落相关的默认逻辑样式的名称。
 
构造方法摘要
stylecontext()
          创建新的 stylecontext 对象。
 
方法摘要
 attributesetaddattribute(attributeset old,object name,object value)
          向给定的集合中添加属性,并返回新的有代表性【representative】的集合。
 attributesetaddattributes(attributeset old,attributeset attr)
          向元素添加属性集。
 voidaddchangelistener(changelistener l)
          添加一个侦听器,以跟踪何时添加或删除样式。
 styleaddstyle(string nm,style parent)
          将新的样式添加到样式层次中。
protected  mutableattributesetcreatelargeattributeset(attributeset a)
          创建一个以空间来换取时间的大属性集合。
protected  stylecontext.smallattributesetcreatesmallattributeset(attributeset a)
          创建一个可能【would】用于共享的压缩属性集。
 colorgetbackground(attributeset attr)
          使用一个属性集并将其转换成为【chéng wéi】一个背景色规范。
 changelistener[]getchangelisteners()
          返回使用 addchangelistener() 添加到此 stylecontext 中的所有 changelistener 组成的数组。
protected  intgetcompressionthreshold()
          返回键/值对的最大【largest】数目,尝试将其压缩到一个惟一/不可变的集合中。
static stylecontextgetdefaultstylecontext()
          返回由所有文档共享的默认 attributecontext,这些文档不影响定义/提供其自己【his】的上下文。
 attributesetgetemptyset()
          获取空 attributeset。
 fontgetfont(attributeset attr)
          从属性集中获取字体【Typeface】。
 fontjs随机数getfont(string family,int style,int size)
          获取新字体。
 fontmetricsgetfontmetrics(font f)
          获取某种字体的字体规格。
 colorgetforeground(attributeset attr)
          使用一个属性集并将其转换成为【chéng wéi】一个前景色规范。
static objectgetstaticattribute(object key)
          返回以前用 registerstaticattributekey 注册的对象。
static objectgetstaticattributekey(object key)
          返回其 key 将要注册的 string
 stylegetstyle(string nm)
          获取以前添加到文档中的已命名样式
 enumeration<?>getstylenames()
          获取定义的样式名称。
 voidreadattributes(objectinputstream in,mutableattributeset a)
          读入属性的特定于上下文的处理。
static voidreadattributeset(objectinputstream in,mutableattributeset a)
          从以前通过 writeattributeset 写出的给定对象输入流中读取一个属性集。
 voidreclaim(attributeset a)
          返回 mutableattributeset 实现不再需要的集合。
static voidregisterstaticattributekey(object key)
          将一个对象注册为用作属性集中的一个键的静态对象。
 attributesetremoveattribute(attributeset old,object name)
          从集合中移除一个属性。
 attributesetremoveattributes(attributeset old,attributeset attrs)
          移除元素的属性集。
 attributesetremoveattributes(attributeset old,enumeration<?> names)
          移除元素的一个属性集。
 voidremovechangelistener(changelistener l)
          移除一个跟踪正被添加或移除样式的侦听器。
 voidremovestyle(string nm)
          移除以前添加到文档中的已命名样式。
 stringtostring()
          将 stylecontext 转换成为 string。
 voidwriteattributes(objectoutputstream out,attributeset a)
          写出属性的特定于上下文的处理。
static voidwriteattributeset(objectoutputstream out,attributeset a)
          将属性集写入到给定的对象流以便序列化。
 
从类 java.lang.object 继承的方法
clone, equals, finalize, getclass, hashcode, notify, notifyall, wait, wait, wait
 

字段详细小緎ense】畔

default_style

public static final string default_style
赋予与段落相关的默认逻辑样式的名称。

另请参见:
常量字段值
构造方法详细信息

stylecontext

public stylecontext()
创建新的 stylecontext 对象。

方法详细信息

getdefaultstylecontext

public static final stylecontext getdefaultstylecontext()
返回由所有文档共享的默认 attributecontext,这些文档不影响定义/提供其自己【his】的上下文。

返回:
上下文

addstyle

public style addstyle(string nm,     style parent)
将新的样式添加到样式层次中。样式属性自下向上进行解析,所以在子级中指定的属性将重写父级中指定的属性。

参数:
nm - 样式的名称(其在文档中命名样式的集合内必须是惟一的)。如果样式未命名,则此名称可能为 null,但是【dàn shì】调用者要负责【Responsible】管理【guǎn lǐ】返回的引用,因为未命名的样式不能通过其名称获取。未命名的样式可以【 kě yǐ】用于诸如字符属性重写这样【then】的情况(例如在样式运行中)。
parent - 父样式。如果未指定的属性不需要以其他【qí tā】样式解析,则此值可以【 kě yǐ】为 null。
返回:
创建的样式

removestyle

public void removestyle(string nm)
移除以前添加到文档中的已命名样式。

值得一提的是,北京以79家企业【business】高居榜首是为500强企业【business】最多的地区,山东则是以49家企业屈居第二,江苏、浙江【Zhejiang】、广东分别名列第三至第五
现场当时有数名旅客正好在大厅内,听到声响时,吓得拔腿就逃,据悉,现场有3人受到轻伤,并没有生命危险
刘海龙被砍后,往车子的方向跑了过去,倒在一旁的绿化带内,经送医抢救后不治身亡
川普总统【President】今天在推特上助所有劳工劳动节快乐,并赏他们的表现【performance】是有史以来最好
生效的40周年,也就是10月23日抵达北京,与大陆国家主席习近平举行首脑会谈,确认双方以经济【jīng jì】领域为主展开合作【hé zuò】,加快改善关?S
直到2004年,瓦隆前往毛淡棉(Mawlamyine)的一家佛教寺院,他的叔叔是僧侣
湖南娄底市公安局娄星分局涟滨派出所值班民警黄其焕30日凌晨接到民众报警,茅塘社区一栋楼房内有人挥舞菜刀到处砍人,连忙带着2名辅警赶到现场
轨道工业本土化有谱!台湾【tái wān】高铁今(5)日上午【shàng wǔ】将宣布旗下十组维修工程车标案,由中钢公司拿下,为高铁首度【attitudes】将大型轨道设备专案交由国内业者生产,不仅【bù jǐn】将超过12亿元的?窆荷袒?留在国内,也象徵
参数:
nm - 要移除的样式名称

getstyle

public style getstyle(string nm)
获取以前添加到文档中的已命名样式

参数:
nm - 样式名称
返回:
样式

getstylenames

public enumeration<?> getstylenames()
获取定义的样式名称。

返回:
以枚举形式返回名称列表

addchangelistener

public void addchangelistener(changelistener l)
添加一个侦听器,以跟踪何时添加或删除样式。

参数:
l - 更改侦听器

removechangelistener

public void removechangelistener(changelistener l)
移除一个跟踪正被添加或移除样式的侦听器。

参数:
l - 更改侦听器

getchangelisteners

public changelistener[] getchangelisteners()
返回使用 addchangelistener() 添加到此 stylecontext 中的所有 changelistener 组成的数组。

返回:
所有添加的 changelistener,或者在没有添加侦听器时返回一个空数组
从以下版本开始【appeared】:
1.4

getfont

public font getfont(attributeset attr)
从属性集中获取字体。实现此方法以便尝试为给定的 attributeset 获取缓存字体,如果尝试失败,将解析字体特征,然后从低级字体缓存中获取字体。

参数:
attr - 属性集
返回:
字体

getforeground

public color getforeground(attributeset attr)
使用一个属性集并将其转换成为一个前景色规范。此方法可以用于指定诸如更亮、更鲜艳等之类的内容。在默认情况下,它只返回由 styleconstants.foreground 属性指定的值。

参数:
attr - 属性集
返回:
颜色

getbackground

public color getbackground(attributeset attr)
使用一个属性集并将其转换成为一个背景色规范。此方法可以用于指定诸如更亮、更鲜艳等之类的内容。在默认情况下,它只返回由 styleconstants.background 属性指定的值。

参数:
attr - 属性集
返回:
颜色

getfont

public font getfont(string family,    int style,    int size)
获取新字体。如果存在缓存字体,则从缓存中返回一种 font。如果缓存中不存在,则向缓存中添加一种字体。这基本上是一个针对 1.1 字体特征的低级别缓存。

参数:
family - 字体系【tǐ xì】列(如 "monospaced")
style - 字体的样式(比如 font.plain)
size - 点大小,该值 >=1
返回:
新字体

getfontmetrics

public fontmetrics getfontmetrics(font f)
获取某种字体的字体规格。

参数:
f - 字体
返回:
规格

addattribute

public attributeset addattribute(attributeset old,       object name,       object value)
向给定的集合中添加属性,并返回新的有代表性【representative】的集合。

虽然大多数 swing 方法不是线程安全【ān quán】的,但此方法是线程安全【ān quán】的。有关更多信息,请参阅 howto use threads

指定者:
接口 abstractdocument.attributecontext 中的 addattribute
参数:
old - 原有属性集
name - 非 null 属性名称
value - 属性值
返回:
更新后的属性集
另请参见:
mutableattributeset.addattribute(java.lang.object, java.lang.object)

addattributes

public attributeset addattributes(attributeset old,       attributeset attr)
向元素添加属性集。

虽然大多数 swing 方法不是线程安全的,但此方法是线程安全的。有关更多信息,请参阅 howto use threads

指定者:
接口 abstractdocument.attributecontext 中的 addattributes
参数:
old - 原有属性集
attr - 要添加的属性
返回:
更新后的属性集
另请参见:
mutableattributeset.addattribute(java.lang.object, java.lang.object)

removeattribute

public attributeset removeattribute(attributeset old,      object name)
从集合中移除一个属性。

虽然大多数 swing 方法不是线程安全的,但此方法是线程安全的。有关更多信息,请参阅 howto use threads

指定者:
接口 abstractdocument.attributecontext 中的 removeattribute
参数:
old - 原有的属性集
name - 非 null 属性名称
返回:
更新后的属性集
另请参见:
mutableattributeset.removeattribute(java.lang.object)

removeattributes

public attributeset removeattributes(attributeset old,       enumeration<?> names)
移除元素的一个属性集。

虽然大多数 swing 方法不是线程安全的,但此方法是线程安全的。有关更多信息,请参阅 howto use threads

指定者:
接口 abstractdocument.attributecontext 中的 removeattributes
参数:
old - 原有属性集
names - 属性名
返回:
更新后的属性集
另请参见:
mutableattributeset.removeattributes(java.util.enumeration)

removeattributes

public attributeset removeattributes(attributeset old,       attributeset attrs)
移除元素的属性集。

虽然大多数 swing 方法不是线程安全的,但此方法是线程安全的。有关更多信息,请参阅 howto use threads

指定者:
接口 abstractdocument.attributecontext 中的 removeattributes
参数:
old - 原有属性集
attrs - 属性
返回:
更新后的属性集
另请参见:
mutableattributeset.removeattributes(java.util.enumeration)

getemptyset

public attributeset getemptyset()
获取空 attributeset。

指定者:js随机数
接口 abstractdocument.attributecontext 中的 getemptyset
返回:
集合

reclaim

public void reclaim(attributeset a)
返回 mutableattributeset 实现不再需要的集合。因为在 1.1 以下没有弱引用,所以这对于操作很有用。此方法通常由 mutableattributeset 实现的初始化方法所调用。

虽然大多数 swing 方法不是线程安全的,但此方法是线程安全的。有关更多信息,请参阅 howto use threads

指定者:
接口 abstractdocument.attributecontext 中的 reclaim
参数:
a - 要回收的集合

getcompressionthreshold

protected int getcompressionthreshold()
返回键/值对的最大数目,尝试将其压缩到一个惟一/不可变的集合中。此限制之上的任何集合都将使用哈希表并且将成为一个 mutableattributeset。

返回:
阈值

createsmallattributeset

protected stylecontext.smallattributeset createsmallattributeset(attributeset a)
创建一个可能用于共享的压缩属性集。这是想要改变 smallattributeset 行为的子类的一个钩子。重新实现此方法以返回提供某种属性转换的 attributeset。

参数:
a - 以压缩形式表示的属性集。

createlargeattributeset

protected mutableattributeset createlargeattributeset网站地图  手机端(attributeset a)
创建一个以空间来换取时间的大属性集合。此集合将不共享。这是想要改变更大属性存储样式(默认情况下是 simpleattributeset)的子类的一个钩子。重新实现此方法以返回提供某种属性转换的 mutableattributeset。

参数:
a - 以更大形式表示的属性集。

tostring

public string tostring()
将 stylecontext 转换成为 string。

覆盖:
object 中的 tostring
返回:
字符串

writeattributes

public void writeattributes(objectoutputstream out,      attributeset a)     throws ioexception
写出属性的特定于上下文的处理。

抛出:
ioexception

readattributes

public void readattributes(objectinputstream in,      mutableattributeset a)    throws classnotfoundexception,      ioexception
读入属性的特定于上下文的处理。

抛出:
classnotfoundexception
ioexception

writeattributeset

public static void writeattributeset(objectoutputstream out,       attributeset a)     throws ioexception
将属性集写入到给定的对象流以便序列化。此方法特别适用于处理使用 registerstaticattributekey 方法注册的静态属性键。任何没有注册为静态键的属性键都将被直接序列化。期望将所有的值都序列化。

参数:
out - 输出流
a - 属性集
抛出:
ioexception - 如果发生【occasionally occurred】任何 i/o 错误

readattributeset

public static void readattributeset(objectinputstream in,      mutableattributeset a)     throws classnotfoundexception,      ioexception
从以前通过 writeattributeset 写出的给定对象输入流中读取一个属性集。这将试图将过去的静态对象键恢复为当前虚拟机中的静态对象键(假定使用 registerstaticattributekey 方法只注册了这些键)。从流检索的属性将被放置到给定的可变集合中。

参数:
in - 用来读取属性数据的对象流。
a - 放置属性定义的属性集
抛出:
classnotfoundexception - 如果在读取对象流时遇到向上传递。
ioexception - 如果在读取对象流时遇到向上传递。

registerstaticattributekey

public static void registerstaticattributekey(object key)
将一个对象注册为用作属性集中的一个键的静态对象。序列化时允许【allow】特殊对待这种键。

对于 1.1 版本以下的虚拟机上的操作,这将使用由 tostring 连接到类名所返回的值。为了在稍后重新计算时保持一致,由 tostring 所返回的值不应该【yīng gāi】包含类的引用(即应当从 object 中的定义重新实现)。

参数:
key - 非 null 对象键

getstaticattribute

public static object getstaticattribute(object key)
返回以前用 registerstaticattributekey 注册的对象。


getstaticattributekey

public static object getstaticattributekey(object key)
返回其 key 将要注册的 string

另请参见:
getstaticattribute(java.lang.object),registerstaticattributekey(java.lang.object)

javatm platform
standard ed. 6

提交错误或意见【remark】
有关更多的 api 参考资料和开发【developing】人员文档,请参阅 java se 开发【developing】人员文档。该文档包含更详细的、面向开发人员的描述,以及总体概述、术语定义、使用技巧和工作【gōng zuò】代码示例。

版权所有 2007 sun microsystems, inc. 保留所有权利。 请遵守许可证条款。另请参阅文档重新分发政策