©
本文档使用 PHP中文网手册 发布
|
JavaTM 2 Platform Standard Ed. 6 |
|||||||||
上一个类 下一个类 | 框架 无框架 | |||||||||
摘要: 嵌套 | 字段 | 构造方法 | 方法 | 详细信息: 字段 | 构造方法 | 方法 |
java.lang.Object javax.swing.text.StyleContext
public class StyleContext
样式池及其关联的资源。此类用于确定资源组的生存期,假定该资源组是一个容器,它保持各种资源的缓存,这些资源(如字体和颜色等)通过各种样式定义得以重用。如果需要最大化相关资源的共享,则可由多个文档来共享此类。
此类还对小属性集提供有效支持,并通过共享和利用其不变的特性来压缩这些小属性集。因为许多样式都是重复的,所以共享的潜能非常大,而且复制成本也相当低廉。较大的集合降低了共享的可能性,并因此自动转换回一种空间利用率低的实现。
警告:此类的已序列化对象与以后的 Swing 版本不兼容。当前序列化支持适用于短期存储或运行相同 Swing 版本的应用程序之间的 RMI。从 1.4 版本开始,已在 java.beans
包中添加了支持所有 JavaBeansTM 长期存储的功能。请参见 XMLEncoder
。
嵌套类摘要 | |
---|---|
class |
StyleContext.NamedStyle
通常用于表示字符和段落样式的属性集合。 |
class |
StyleContext.SmallAttributeSet
此类可在数组中存储少量的属性。 |
字段摘要 | |
---|---|
static String |
DEFAULT_STYLE
赋予与段落相关的默认逻辑样式的名称。 |
构造方法摘要 | |
---|---|
StyleContext()
创建新的 StyleContext 对象。 |
方法摘要 | |
---|---|
AttributeSet |
addAttribute(AttributeSet old,
Object name,
Object value)
向给定的集合中添加属性,并返回新的有代表性的集合。 |
AttributeSet |
addAttributes(AttributeSet old,
AttributeSet attr)
向元素添加属性集。 |
void |
addChangeListener(ChangeListener l)
添加一个侦听器,以跟踪何时添加或删除样式。 |
Style |
addStyle(String nm,
Style parent)
将新的样式添加到样式层次中。 |
protected MutableAttributeSet |
createLargeAttributeSet(AttributeSet a)
创建一个以空间来换取时间的大属性集合。 |
protected StyleContext.SmallAttributeSet |
createSmallAttributeSet(AttributeSet a)
创建一个可能用于共享的压缩属性集。 |
Color |
getBackground(AttributeSet attr)
使用一个属性集并将其转换成为一个背景色规范。 |
ChangeListener[] |
getChangeListeners()
返回使用 addChangeListener() 添加到此 StyleContext 中的所有 ChangeListener 组成的数组。 |
protected int |
getCompressionThreshold()
返回键/值对的最大数目,尝试将其压缩到一个惟一/不可变的集合中。 |
static StyleContext |
getDefaultStyleContext()
返回由所有文档共享的默认 AttributeContext,这些文档不影响定义/提供其自己的上下文。 |
AttributeSet |
getEmptySet()
获取空 AttributeSet。 |
Font |
getFont(AttributeSet attr)
从属性集中获取字体。 |
Font |
getFont(String family,
int style,
int size)
获取新字体。 |
FontMetrics |
getFontMetrics(Font f)
获取某种字体的字体规格。 |
Color |
getForeground(AttributeSet attr)
使用一个属性集并将其转换成为一个前景色规范。 |
static Object |
getStaticAttribute(Object key)
返回以前用 registerStaticAttributeKey 注册的对象。 |
static Object |
getStaticAttributeKey(Object key)
返回其 key 将要注册的 String |
Style |
getStyle(String nm)
获取以前添加到文档中的已命名样式 |
Enumeration<?> |
getStyleNames()
获取定义的样式名称。 |
void |
readAttributes(ObjectInputStream in,
MutableAttributeSet a)
读入属性的特定于上下文的处理。 |
static void |
readAttributeSet(ObjectInputStream in,
MutableAttributeSet a)
从以前通过 writeAttributeSet 写出的给定对象输入流中读取一个属性集。 |
void |
reclaim(AttributeSet a)
返回 MutableAttributeSet 实现不再需要的集合。 |
static void |
registerStaticAttributeKey(Object key)
将一个对象注册为用作属性集中的一个键的静态对象。 |
AttributeSet |
removeAttribute(AttributeSet old,
Object name)
从集合中移除一个属性。 |
AttributeSet |
removeAttributes(AttributeSet old,
AttributeSet attrs)
移除元素的属性集。 |
AttributeSet |
removeAttributes(AttributeSet old,
Enumeration<?> names)
移除元素的一个属性集。 |
void |
removeChangeListener(ChangeListener l)
移除一个跟踪正被添加或移除样式的侦听器。 |
void |
removeStyle(String nm)
移除以前添加到文档中的已命名样式。 |
String |
toString()
将 StyleContext 转换成为 String。 |
void |
writeAttributes(ObjectOutputStream out,
AttributeSet a)
写出属性的特定于上下文的处理。 |
static void |
writeAttributeSet(ObjectOutputStream out,
AttributeSet a)
将属性集写入到给定的对象流以便序列化。 |
从类 java.lang.Object 继承的方法 |
---|
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait |
字段详细信息 |
---|
public static final String DEFAULT_STYLE
构造方法详细信息 |
---|
public StyleContext()
方法详细信息 |
---|
public static final StyleContext getDefaultStyleContext()
public Style addStyle(String nm, Style parent)
nm
- 样式的名称(其在文档中命名样式的集合内必须是惟一的)。如果样式未命名,则此名称可能为 null,但是调用者要负责管理返回的引用,因为未命名的样式不能通过其名称获取。未命名的样式可以用于诸如字符属性重写这样的情况(例如在样式运行中)。parent
- 父样式。如果未指定的属性不需要以其他样式解析,则此值可以为 null。
public void removeStyle(String nm)
nm
- 要移除的样式名称public Style getStyle(String nm)
nm
- 样式名称
public Enumeration<?> getStyleNames()
public void addChangeListener(ChangeListener l)
l
- 更改侦听器public void removeChangeListener(ChangeListener l)
l
- 更改侦听器public ChangeListener[] getChangeListeners()
ChangeListener
组成的数组。
ChangeListener
,或者在没有添加侦听器时返回一个空数组public Font getFont(AttributeSet attr)
attr
- 属性集
public Color getForeground(AttributeSet attr)
attr
- 属性集
public Color getBackground(AttributeSet attr)
attr
- 属性集
public Font getFont(String family, int style, int size)
family
- 字体系列(如 "Monospaced")style
- 字体的样式(比如 Font.PLAIN)size
- 点大小,该值 >= 1
public FontMetrics getFontMetrics(Font f)
f
- 字体
public AttributeSet addAttribute(AttributeSet old, Object name, Object value)
虽然大多数 Swing 方法不是线程安全的,但此方法是线程安全的。有关更多信息,请参阅 How to Use Threads。
AbstractDocument.AttributeContext
中的 addAttribute
old
- 原有属性集name
- 非 null 属性名称value
- 属性值
MutableAttributeSet.addAttribute(java.lang.Object, java.lang.Object)
public AttributeSet addAttributes(AttributeSet old, AttributeSet attr)
虽然大多数 Swing 方法不是线程安全的,但此方法是线程安全的。有关更多信息,请参阅 How to Use Threads。
AbstractDocument.AttributeContext
中的 addAttributes
old
- 原有属性集attr
- 要添加的属性
MutableAttributeSet.addAttribute(java.lang.Object, java.lang.Object)
public AttributeSet removeAttribute(AttributeSet old, Object name)
虽然大多数 Swing 方法不是线程安全的,但此方法是线程安全的。有关更多信息,请参阅 How to Use Threads。
AbstractDocument.AttributeContext
中的 removeAttribute
old
- 原有的属性集name
- 非 null 属性名称
MutableAttributeSet.removeAttribute(java.lang.Object)
public AttributeSet removeAttributes(AttributeSet old, Enumeration<?> names)
虽然大多数 Swing 方法不是线程安全的,但此方法是线程安全的。有关更多信息,请参阅 How to Use Threads。
AbstractDocument.AttributeContext
中的 removeAttributes
old
- 原有属性集names
- 属性名
MutableAttributeSet.removeAttributes(java.util.Enumeration>)
public AttributeSet removeAttributes(AttributeSet old, AttributeSet attrs)
虽然大多数 Swing 方法不是线程安全的,但此方法是线程安全的。有关更多信息,请参阅 How to Use Threads。
AbstractDocument.AttributeContext
中的 removeAttributes
old
- 原有属性集attrs
- 属性
MutableAttributeSet.removeAttributes(java.util.Enumeration>)
public AttributeSet getEmptySet()
AbstractDocument.AttributeContext
中的 getEmptySet
public void reclaim(AttributeSet a)
虽然大多数 Swing 方法不是线程安全的,但此方法是线程安全的。有关更多信息,请参阅 How to Use Threads。
AbstractDocument.AttributeContext
中的 reclaim
a
- 要回收的集合protected int getCompressionThreshold()
protected StyleContext.SmallAttributeSet createSmallAttributeSet(AttributeSet a)
a
- 以压缩形式表示的属性集。protected MutableAttributeSet createLargeAttributeSet(AttributeSet a)
a
- 以更大形式表示的属性集。public String toString()
Object
中的 toString
public void writeAttributes(ObjectOutputStream out, AttributeSet a) throws IOException
IOException
public void readAttributes(ObjectInputStream in, MutableAttributeSet a) throws ClassNotFoundException, IOException
ClassNotFoundException
IOException
public static void writeAttributeSet(ObjectOutputStream out, AttributeSet a) throws IOException
registerStaticAttributeKey
方法注册的静态属性键。任何没有注册为静态键的属性键都将被直接序列化。期望将所有的值都序列化。
out
- 输出流a
- 属性集
IOException
- 如果发生任何 I/O 错误public static void readAttributeSet(ObjectInputStream in, MutableAttributeSet a) throws ClassNotFoundException, IOException
writeAttributeSet
写出的给定对象输入流中读取一个属性集。这将试图将过去的静态对象键恢复为当前虚拟机中的静态对象键(假定使用 registerStaticAttributeKey
方法只注册了这些键)。从流检索的属性将被放置到给定的可变集合中。
in
- 用来读取属性数据的对象流。a
- 放置属性定义的属性集
ClassNotFoundException
- 如果在读取对象流时遇到向上传递。
IOException
- 如果在读取对象流时遇到向上传递。public static void registerStaticAttributeKey(Object key)
对于 1.1 版本以下的虚拟机上的操作,这将使用由 toString
连接到类名所返回的值。为了在稍后重新计算时保持一致,由 toString 所返回的值不应该包含类的引用(即应当从 Object 中的定义重新实现)。
key
- 非 null 对象键public static Object getStaticAttribute(Object key)
registerStaticAttributeKey
注册的对象。
public static Object getStaticAttributeKey(Object key)
key
将要注册的 String
getStaticAttribute(java.lang.Object)
,
registerStaticAttributeKey(java.lang.Object)
|
JavaTM 2 Platform Standard Ed. 6 |
|||||||||
上一个类 下一个类 | 框架 无框架 | |||||||||
摘要: 嵌套 | 字段 | 构造方法 | 方法 | 详细信息: 字段 | 构造方法 | 方法 |
版权所有 2004 Sun Microsystems, Inc. 保留所有权利。 请遵守许可证条款。另请参阅文档重新分发政策。