概述  软件包   类  使用  树  已过时  索引  帮助 
JavaTM Platform
Standard Ed. 6
 上一个类   下一个类 框架    无框架    
摘要： 嵌套 | 字段 | 构造方法 | 方法 详细信息： 字段 | 构造方法 | 方法

javax.swing
类 SizeRequirements

java.lang.Object
  继承者 javax.swing.SizeRequirements
所有已实现的接口：
Serializable
public class SizeRequirements
extends Object
implements Serializable

为方便布局管理器，计算组件的有关大小和位置信息。大小和位置的所有计算方法都是将 SizeRequirements 数组作为参数的类方法。SizeRequirements 类支持两种布局类型：

平铺
组件按端到端方式放置，起点可以为坐标 0 （最左或最顶端位置）或所分配区域的末尾对应的坐标（最右或最底端位置）。
对齐
组件按每个组件的 X 或 Y 对齐值指定的方式对齐。

每个 SizeRequirements 对象包含了有关单个组件或一组组件的宽度（和 X 对齐方式）或高度（和 Y 对齐方式）的信息：

minimum
组件或组件组的最小合理宽度/高度，以像素为单位。
preferred
组件或组件组的自然宽度/高度，以像素为单位。
maximum
组件或组件组的最大合理宽度/高度，以像素为单位。
alignment
组件或组件组的 X/Y 对齐方式。

警告：此类的已序列化对象与以后的 Swing 版本不兼容。当前序列化支持适用于短期存储，或适用于在运行相同 Swing 版本的应用程序之间进行 RMI（Remote Method Invocation，远程方法调用）。从 1.4 版本开始，已在 java.beans 包中添加了支持所有 JavaBeansTM 长期存储的功能。请参见 XMLEncoder。

另请参见：
Component.getMinimumSize(), Component.getPreferredSize(), Component.getMaximumSize(), Component.getAlignmentX(), Component.getAlignmentY()

字段摘要
 float alignment
          对齐方式，指定为介于 0.0 和 1.0 之间的值，包含这两个边界值。
 int maximum
          允许的最大大小。
 int minimum
          要求的最小大小。
 int preferred
          首选（自然）大小。
 
构造方法摘要
SizeRequirements()
          创建 SizeRequirements 对象，其最小、首选和最大大小设置为零，对齐方式值为 0.5（居中）。
SizeRequirements(int min, int pref, int max, float a)
          用指定的最小、首选和最大大小以及指定的对齐方式创建 SizeRequirements 对象。
 
方法摘要
static int[] adjustSizes(int delta, SizeRequirements[] children)
          按给定总量调整指定的大小数组。
static void calculateAlignedPositions(int allocated, SizeRequirements total, SizeRequirements[] children, int[] offsets, int[] spans)
          创建一组偏移量/区域对，指定如何按照指定对齐方式对一组组件进行布局。
static void calculateAlignedPositions(int allocated, SizeRequirements total, SizeRequirements[] children, int[] offsets, int[] spans, boolean normal)
          创建一组偏移量/区域对，指定如何按指定对齐方式对一组组件进行布局。
static void calculateTiledPositions(int allocated, SizeRequirements total, SizeRequirements[] children, int[] offsets, int[] spans)
          创建一组表示如何对一组组件进行端到端布局的偏移量/区域对。
static void calculateTiledPositions(int allocated, SizeRequirements total, SizeRequirements[] children, int[] offsets, int[] spans, boolean forward)
          创建一组表示如何对一组组件进行端到端布局的偏移量/区域对。
static SizeRequirements getAlignedSizeRequirements(SizeRequirements[] children)
          确定对齐一组组件所需的总空间。
static SizeRequirements getTiledSizeRequirements(SizeRequirements[] children)
          确定端到端放置一组组件需要占用的总空间。
 String toString()
          返回一个描述最小、首选和最大大小以及对齐方式要求的字符串。
 
从类 java.lang.Object 继承的方法
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait
 

字段详细信息

minimum

public int minimum
要求的最小大小。对于组件 comp，该大小应该等于 comp.getMinimumSize().width 或 comp.getMinimumSize().height。

preferred

public int preferred
首选（自然）大小。对于组件 comp，该大小应该等于 comp.getPreferredSize().width 或 comp.getPreferredSize().height。

maximum

public int maximum
允许的最大大小。对于组件 comp，该大小应该等于 comp.getMaximumSize().width 或 comp.getMaximumSize().height。

alignment

public float alignment
对齐方式，指定为介于 0.0 和 1.0 之间的值，包含这两个边界值。要指定居中，对齐方式应为 0.5。

构造方法详细信息

SizeRequirements

public SizeRequirements()
创建 SizeRequirements 对象，其最小、首选和最大大小设置为零，对齐方式值为 0.5（居中）。

SizeRequirements

public SizeRequirements(int min,
                        int pref,
                        int max,
                        float a)
用指定的最小、首选和最大大小以及指定的对齐方式创建 SizeRequirements 对象。

参数：
min - 最小大小 >= 0
pref - 首选大小 >= 0
max - 最大大小 >= 0
a - 对齐方式 >= 0.0f && <= 1.0f
方法详细信息

toString

public String toString()
返回一个描述最小、首选和最大大小以及对齐方式要求的字符串。

覆盖：
类 Object 中的 toString
返回：
字符串

getTiledSizeRequirements

public static SizeRequirements getTiledSizeRequirements(SizeRequirements[] children)
确定端到端放置一组组件需要占用的总空间。集合中每个组件的要求通过传入的 SizeRequirements 数组中的一个条目表示。返回的 SizeRequirements 对象的对齐方式为 0.5 （居中）。所需空间永远不会大于 Integer.MAX_VALUE。

参数：
children - 一组组件的空间要求。该向量可以是零长度，它将导致传回一个默认的 SizeRequirements 对象实例。
返回：
总空间要求。

getAlignedSizeRequirements

public static SizeRequirements getAlignedSizeRequirements(SizeRequirements[] children)
确定对齐一组组件所需的总空间。集合中每个组件的要求通过传入的 SizeRequirements 数组中的一个条目表示。所需总空间永远不会大于 Integer.MAX_VALUE。

参数：
children - 所需的子级集合。如果长度为零，返回的结果将是一个默认的 SizeRequirements 实例。
返回：
总空间要求。

calculateTiledPositions

public static void calculateTiledPositions(int allocated,
                                           SizeRequirements total,
                                           SizeRequirements[] children,
                                           int[] offsets,
                                           int[] spans)
创建一组表示如何对一组组件进行端到端布局的偏移量/区域对。此方法需要您指定要分配的总空间量、要放置的每个组件的大小要求（指定为 SizeRequirements 数组）以及组件集合的总大小要求。通过调用 getTiledSizeRequirements 方法可获得总大小要求。组件将按正向平铺，偏移量从 0 递增。

参数：
allocated - 要分配的总区域 >= 0。
total - 请求的子级总数。该参数是可选的，可以为 null。
children - 每个组件的大小要求。
offsets - 每个子级相对于 0 的偏移量，用于分配区域（确定区域的放置）。
spans - 为每个子级分配的区域，它们构成了总目标区域。

calculateTiledPositions

public static void calculateTiledPositions(int allocated,
                                           SizeRequirements total,
                                           SizeRequirements[] children,
                                           int[] offsets,
                                           int[] spans,
                                           boolean forward)
创建一组表示如何对一组组件进行端到端布局的偏移量/区域对。此方法需要您指定要分配的总空间量、要放置的每个组件的大小要求（指定为一组 SizeRequirements）以及组件集合的总大小要求。通过调用 getTiledSizeRequirements 方法可获得总大小要求。 该方法还需要使用一个标志，用来指示组件应该以正向（偏移量从 0 递增）还是反向（偏移量从已分配空间末尾递减）平铺。正向表示组件从左到右或从顶部到底部平铺。反向表示组件从右到左或从底部到顶部平铺。

参数：
allocated - 要分配的总区域 >= 0。
total - 请求的子级总数。该参数是可选的，可以为 null。
children - 每个组件的大小要求。
offsets - 每个子级相对于 0 的偏移量，用于分配区域（确定区域的放置）。
spans - 为每个子级分配的区域，它们构成了总目标区域。
forward - 如果为 true，按从 0 递增的偏移量平铺；如果为 false，按从已分配空间末尾递减的偏移量平铺。

calculateAlignedPositions

public static void calculateAlignedPositions(int allocated,
                                             SizeRequirements total,
                                             SizeRequirements[] children,
                                             int[] offsets,
                                             int[] spans)
创建一组偏移量/区域对，指定如何按照指定对齐方式对一组组件进行布局。得到的区域分配将互相重叠，每个组件尽可能地放到给定的总分配中。此方法需要您指定要分配的总空间量、要放置的每个组件的大小要求（指定为一组 SizeRequirements）以及组件集合的总大小要求（实际上只使用其中的对齐字段）。通过调用 getAlignedSizeRequirements 可获得总大小要求。 将执行正常对齐方式，对齐方式值为 0.0f（表示组件的左/上边界）。

参数：
allocated - 要分配的总区域 >= 0。
total - 请求的子级总数。
children - 每个组件的大小要求。
offsets - 每个子级相对于 0 的偏移量，用于分配区域（确定区域的放置）。
spans - 为每个子级分配的区域，它们构成了总目标区域。
从以下版本开始：
1.4

calculateAlignedPositions

public static void calculateAlignedPositions(int allocated,
                                             SizeRequirements total,
                                             SizeRequirements[] children,
                                             int[] offsets,
                                             int[] spans,
                                             boolean normal)
创建一组偏移量/区域对，指定如何按指定对齐方式对一组组件进行布局。得到的区域分配将互相重叠，每个组件尽可能地放到给定的总分配中。此方法需要您指定要分配的总空间量、要放置的每个组件的大小要求（指定为一组 SizeRequirements）以及组件集合的总大小要求（实际上只使用其中的对齐字段）。调用 getAlignedSizeRequirements 可获得总大小要求。 此方法还需要使用一个标志，用来指示应该执行正常或反向对齐。正常对齐方式下，值 0.0f 表示要对齐的组件的左/顶端边界。反向对齐方式下，0.0f 表示右/底端边界。

参数：
allocated - 要分配的总区域 >= 0。
total - 请求的子级总数。
children - 每个组件的大小要求。
offsets - 区域分配位置每个子级相对于 0 的偏移（确定区域的放置）。
spans - 为每个子级分配的区域，它们构成了总目标区域。
normal - 值为 true 时，对齐方式值 0.0f 表示左/顶端；值为 false 时，它表示右/底端。
从以下版本开始：
1.4

adjustSizes

public static int[] adjustSizes(int delta,
                                SizeRequirements[] children)
按给定总量调整指定的大小数组。

参数：
delta - 指定大小差异的 int
children - SizeRequirements 对象的数组
返回：
包含每一项的最终大小的 int 数组
概述  软件包   类  使用  树  已过时  索引  帮助 
JavaTM Platform
Standard Ed. 6
 上一个类   下一个类 框架    无框架    
摘要： 嵌套 | 字段 | 构造方法 | 方法 详细信息： 字段 | 构造方法 | 方法
提交错误或意见
有关更多的 API 参考资料和开发人员文档，请参阅 Java SE 开发人员文档。该文档包含更详细的、面向开发人员的描述，以及总体概述、术语定义、使用技巧和工作代码示例。

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