javax.swing

Class SizeSequence

java.lang.Object

javax.swing.SizeSequence

public class SizeSequence
extends Object

SizeSequence对象有效地维护有序的大小和相应位置的列表。 SizeSequence可能适合的情况是显示多行不等大小的组件。 在这种情况下，可以使用单个SizeSequence对象跟踪所有行的高度和Y位置。

另一个例子是多列组件，例如JTable ，其中列大小并不都相等。 JTable可能使用单个SizeSequence对象来存储所有列的宽度和X位置。 JTable可以使用SizeSequence对象来查找对应于某个位置的列。 每当一个或多个列大小更改时， JTable可以更新SizeSequence对象。

下图显示了多列组件的大小和位置数据之间的关系。

在图中，第一索引（0）对应于第一列，第二索引（1）到第二列，等等。 第一列的位置从0开始，列占用大小₀像素，其中大小₀是由getSize(0)返回的值。 因此，第一列以大小_0-1结束。然后第二列从位置大小₀开始并占据大小₁ （ getSize(1) ）像素。

请注意， SizeSequence对象简单地表示沿轴的间隔。 在我们的示例中，间隔代表高度或宽度（以像素为单位）。 但是，任何其他计量单位（例如，以天为单位）都可以同样有效。

实施说明

通常当存储条目的大小和位置时，可以选择存储大小或存储其位置。 渲染过程中需要的两个常见操作是： getIndex(position)和setSize(index, size) 。 无论选择哪种内部格式，当条目数量变大时，这些操作之一都是昂贵的。 如果存储大小，则查找包含特定位置的条目的索引在条目数量上是线性的。 如果替换存储位置，则在特定索引处设置条目的大小需要更新受影响的条目的位置，这也是线性计算。

像上述技术一样，这个类在内部保存一个N个整数的数组，但是使用混合编码，这是基于大小和基于位置的方法之间的一半。 结果是数据结构占用相同的空间来存储信息，但可以在Log（N）时间而不是O（N）中执行大多数操作，其中N是列表中的条目数。

在条目数量上保持O（N）的两个操作是insertEntries和removeEntries方法，这两个操作都是通过将内部数组转换为一组整数大小来实现的，将其复制到新数组中，然后重新构建混合表示到位。

从以下版本开始：

1.3

构造方法摘要

构造方法

Constructor and Description
SizeSequence() 创建一个不包含条目的新的 SizeSequence对象。
SizeSequence(int numEntries) 创建一个新的 SizeSequence对象，其中包含指定数量的条目，全部初始化为大小为0。
SizeSequence(int[] sizes) 创建一个包含指定大小的新的 SizeSequence对象。
SizeSequence(int numEntries, int value) 创建一个新的 SizeSequence对象，其中包含指定数量的条目，全部初始化为 value 。

方法摘要

Modifier and Type	Method and Description
int	getIndex(int position) 返回与指定位置对应的条目的索引。
int	getPosition(int index) 返回指定条目的起始位置。
int	getSize(int index) 返回指定条目的大小。
int[]	getSizes() 返回所有条目的大小。
void	insertEntries(int start, int length, int value) 向这个 SizeSequence添加一组连续的条目。
void	removeEntries(int start, int length) 移除此条目的一组连续的 SizeSequence 。
void	setSize(int index, int size) 设置指定条目的大小。
void	setSizes(int[] sizes) 重新设置这个 SizeSequence对象，使用 sizes参数中的数据。

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

构造方法详细信息

SizeSequence

public SizeSequence()

创建一个不包含条目的新的SizeSequence对象。 要添加条目，您可以使用insertEntries或setSizes 。

另请参见：

insertEntries(int, int, int) ， setSizes(int[])

SizeSequence

public SizeSequence(int numEntries)

创建一个新的 SizeSequence对象，其中包含指定数量的条目，全部初始化为具有大小0。

参数

numEntries - 要追踪的尺寸数量

异常

NegativeArraySizeException - 如果 numEntries < 0

SizeSequence

public SizeSequence(int numEntries,
                    int value)

创建一个新的 SizeSequence对象，其中包含指定数量的条目，全部初始化为 value 。

参数

numEntries - 要跟踪的大小数

value - 每个大小的初始值

SizeSequence

public SizeSequence(int[] sizes)

创建一个包含指定大小的新的 SizeSequence对象。

参数

sizes -尺寸的阵列，以被包含在 SizeSequence

方法详细信息

setSizes

public void setSizes(int[] sizes)

重设此SizeSequence对象，使用sizes参数中的数据。 此方法重新初始化此对象，使其包含与sizes数组一样多的条目。 每个条目的大小都将初始化为sizes中相应项目的sizes 。

参数

sizes - 要包含在这个 SizeSequence

getSizes

public int[] getSizes()

返回所有条目的大小。

结果

一个包含此对象中的大小的新数组

getPosition

public int getPosition(int index)

返回指定条目的起始位置。 例如， getPosition(0)返回0， getPosition(1)等于getSize(0) ， getPosition(2)等于getSize(0) + getSize(1) ，依此类推。

请注意，如果index大于length返回的值可能无意义。

参数

index - 需要排名的条目的索引

结果

指定条目的起始位置

getIndex

public int getIndex(int position)

返回与指定位置对应的条目的索引。 例如， getIndex(0)为0，因为第一个入口总是从0开始。

参数

position - 条目的位置

结果

占据指定位置的条目的索引

getSize

public int getSize(int index)

返回指定条目的大小。 如果index超出范围(0 <= index < getSizes().length) ，行为是未指定的。

参数

index - 与条目对应的索引

结果

条目的大小

setSize

public void setSize(int index,
                    int size)

设置指定条目的大小。 请注意，如果index的值index的范围内， (0 <= index < getSizes().length)该行为是未指定的。

参数

index - 与条目对应的索引

size - 条目的大小

insertEntries

public void insertEntries(int start,
                          int length,
                          int value)

向这个SizeSequence添加一组连续的条目。 请注意， start和length的值必须满足以下条件： (0 <= start < getSizes().length) AND (length >= 0) 。 如果不满足这些条件，则该行为是未指定的，并且可能会抛出异常。

参数

start - 要分配给组中第一个条目的索引

length - 组中的条目数

value - 要分配给每个新条目的大小

异常

ArrayIndexOutOfBoundsException - 如果参数超出范围：（ 0 <= start < (getSizes().length)) AND (length >= 0)

removeEntries

public void removeEntries(int start,
                          int length)

从这个SizeSequence中删除一组连续的条目。 请注意， start和length的值必须满足以下条件： (0 <= start < getSizes().length) AND (length >= 0) 。 如果不满足这些条件，则该行为是未指定的，并且可能会抛出异常。

参数

start - 要删除的第一个条目的索引

length - 要删除的条目数