SWT之FormAttachment

偏执的太偏执、 2022-07-15 08:19 164阅读 0赞

像其它的layout类一样，FormLayout用的data类是:FormData。FormData用另外一 个类来控制窗口小部件的大小和位置: FormAttachment.一个FormData最多用4个FormAttachment,它们分别对应这个小部件的4个面:顶部，底部，左边和右 边。FormAttachment定义了小部件在parent composite或是这个composite里其它部件的位置。

FormAttachment计算位置和大小的方法:

y=ax+b

在这个等式中,在数学上y代表的是纵坐标,x是横坐标值.a是斜率,b是偏移量.按照FormAttachment的规则,y是 高,x是宽度,a是一个相对其它部件的百分率,b是偏移量.FormAttachment实例中的每个数据成员分别代表这些值.

以下(表一)是FormAttachment的数据成员表和相应的意思:

表 一:FormAttachment数据成员

<table> 
 <thead> 
 <tr> 
 <th align="left"> Attribute </th> 
 <th align="left"> Description </th> 
 </tr> 
 </thead> 
 <tbody> 
 <tr> 
 <td align="left"> int alignment </td> 
 <td align="left"> 指定是以另外一个部件的哪一边为基准的.可能的值是:SWT.TOP , SWT.CENTER , 和 SWT.BOTTOM.默认是以最近的一边为基准. </td> 
 </tr> 
 <tr> 
 <td align="left"> Control control </td> 
 <td align="left"> 指定 FormAttachment是以哪个部件为参照物. </td> 
 </tr> 
 <tr> 
 <td align="left"> int denominator </td> 
 <td align="left"> 指定分母.默认值为100 </td> 
 </tr> 
 <tr> 
 <td align="left"> int numerator </td> 
 <td align="left"> 指定分子 </td> 
 </tr> 
 <tr> 
 <td align="left"> int offset </td> 
 <td align="left"> 指定离 composite边界或部件的边界的偏移量.单位是象素. </td> 
 </tr> 
 </tbody> 
</table>

FormAttachment 拥有5个构造函数,没有一个是空的,它们如下表(表二)所示:

表二:FormAttachment 的 构造函数:

<table> 
 <thead> 
 <tr> 
 <th align="left"> Constructor </th> 
 <th align="left"> Description </th> 
 </tr> 
 </thead> 
 <tbody> 
 <tr> 
 <td align="left"> FormAttachment(Control control) </td> 
 <td align="left"> 以另外的某个部件为参照物. </td> 
 </tr> 
 <tr> 
 <td align="left"> FormAttachment(Control control, int offset) </td> 
 <td align="left"> 以另外的某个部件为参照物,加上偏移量. </td> 
 </tr> 
 <tr> 
 <td align="left"> FormAttachment(Control control, int offset, int alignment) </td> 
 <td align="left"> 以另外的某个部件为参照物,加上偏移量和alignment </td> 
 </tr> 
 <tr> 
 <td align="left"> FormAttachment(int numerator) </td> 
 <td align="left"> 设定分子.分母为100,没有偏移量 </td> 
 </tr> 
 <tr> 
 <td align="left"> FormAttachment(int numerator, int offset) </td> 
 <td align="left"> 指定分子和偏移量和 100的分母 </td> 
 </tr> 
 <tr> 
 <td align="left"> FormAttachment(int numerator, int denominator, int offset) </td> 
 <td align="left"> 特定的分子,分母,偏移 量 </td> 
 </tr> 
 </tbody> 
</table>

FormData最多包含4个FormAttachment 实例,每个对应了与它联系的部件的一边.另外,FormData也可以指定宽和高.表四列出了FormData的数据成员:

<table> 
 <thead> 
 <tr> 
 <th align="left"> Attribute </th> 
 <th align="left"> Description </th> 
 </tr> 
 </thead> 
 <tbody> 
 <tr> 
 <td align="left"> FormAttachment bottom </td> 
 <td align="left"> The FormAttachment corresponding to the bottom side of the control. 这个FormAttachment 用 来指定部件的底部位置 </td> 
 </tr> 
 <tr> 
 <td align="left"> int height </td> 
 <td align="left"> 这个部件的高度.单位为象素. </td> 
 </tr> 
 <tr> 
 <td align="left"> FormAttachment left </td> 
 <td align="left"> 这个FormAttachment 用来指定部件的左部位置 </td> 
 </tr> 
 <tr> 
 <td align="left"> FormAttachment right </td> 
 <td align="left"> 这个FormAttachment 用来指定部件的右部位置 </td> 
 </tr> 
 <tr> 
 <td align="left"> FormAttachment top </td> 
 <td align="left"> 这个FormAttachment 用来指定部件的顶部位置 </td> 
 </tr> 
 <tr> 
 <td align="left"> int width </td> 
 <td align="left"> 这个部件的宽度.单位为 象素. </td> 
 </tr> 
 </tbody> 
</table>

当你生成一个FormData对象,你可以自己传给它宽和高的值.如果你没有指定FormAttachment 对 象,部件会自动以parent composite的上边界和左边为起始边界.如果你这样定义了多个部件,它们会都在composite的左上角.

FormLayout 有 两个数据成员 marginHeight和marginWidth,用来以象素为单位来指定大小.它们用来指定包围composite里所有内容的空白. marginHeight对应的是顶部和底部的空白大小,marginWidth对应的是左边和右边的空白大小.空白的默认值是0.

以上的话如果你看得不大懂也没有关系,我们按照具体的例子来看就知道了.

用到FormLayout的最简单的例子就是一个窗口里一个按钮,并且不用 FormData.

import org.eclipse.swt.SWT; import org.eclipse.swt.layout.FormLayout; import org.eclipse.swt.widgets.Button; import org.eclipse.swt.widgets.Display; import org.eclipse.swt.widgets.Shell; public class TestFormLayout \{ public static void main(String\[\] args) \{ Display display = new Display(); Shell shell = new Shell(display); shell.setLayout(new FormLayout()); new Button(shell, SWT.PUSH).setText("Button"); shell.pack(); shell.open(); while (!shell.isDisposed()) \{ if (!display.readAndDispatch()) \{ display.sleep(); \} \} display.dispose(); \} \}

通过上述代码我们可以简单的在一个shell上设置一个button，并且button距离整个界面的其他的边界距离为0。

我们可以通过设定marginHeight和marginWidth值改变周围的空白，即距离边界的距离.

代码象这样:

FormLayout layout = new FormLayout(); layout.marginHeight = 5; layout.marginWidth = 10; shell.setLayout(layout); 
     
    
    但是,只有用FormData和FormAttachment你才能做更多的事.

试着使 用FormData,但是不用FormAttachment s,FormData有公共成员属性 height和width用来改变按钮的大小.

Button button = new Button(shell, SWT.PUSH); button.setText("Button"); FormData data = new FormData(); data.height = 50; data.width = 50; button.setLayoutData(data);

按钮在窗口中的位置是静态的,也就是说改变窗口的大小不影响按钮的位置.

我们举个例子,比如说,你希望这个按钮始终离窗口的右边界50个象素的话,
    
    你必须在你刚刚产生的FormData上添加一个FormAttachment.
    
    因为你现在要指定这个按钮的右边的具体情况了.所以你现在要设置FormData的right属性,
    
    还记得FormData的right属性是一个FormAttachment对象吧.
    
    当与parent composite产生联系时,如果是顶部和左边的话,分子设置为0,
    
    如果是顶部和右边的话,分子设置为100,分别代表了0%和100%.可以在
    
    构造函数中设置分子.我们现在把分子设置为100,偏移量设置为-50.
    
    我们不需要设置分母,因为它的默认大小是100.代码象这样:
    
    data.right = new FormAttachment(100, -50);
     
    
    
    
    
    现在编译并运行程序,按钮离右边刚好50个象素.缩小窗口也不会有任何影响,按钮离右边始终是50象素.
    
    
    
    现在按钮总是维持它离右边50个象素,
    
    但是我们需要它始终保持位置不变,并且随着窗口的伸缩而伸缩.要实现这个要求,我们必须设置它的左边,
    
    所以可以这样实现:
    
    
    
    
    data.left = new FormAttachment(0, 10);
     
    
    
    
    把分子的值设置为0表示它是以窗口的最左边来计算偏移量的.
    
    偏移量设置为10表示它始终离窗口最左边10个象素.
    
    重新编译运行程序,初始界面好象和刚刚差不多,
    
    但是改变窗口大小就可以看到按钮离窗口左边的大小始终没有改变.

离左边和离右边的值已经设置好了,所以它的宽度自然也定下来了，我们可以把原来 FormData设置的按钮宽度那行代码删掉了.

现在有点熟悉了 吧,现在我们把按钮联系到窗口的顶部和底部.我们可以把它放到离窗口顶部25%的距离.我们可以简单的表示为1/4,而不是0.25让分母保持为默认值 (这样也可以).我们把偏移量设置为0.加上这句代码:

data.top = new FormAttachment(1, 4, 0);

现在按钮保持与顶部1/4的距离了.无论怎么改变窗口大小都是1/4。

让我们在这个按钮下面再添加一个按钮.我们把这个按钮布置在现在的按钮下面,添加按钮的顶部在现在的按钮的底部下面5个象 素.并且左边和右边分别和现在的按钮对齐.从下面的代码开始:

Button button2 = new Button(shell, SWT.PUSH); button2.setText("Button 2");

然后我们产生一个FormData对象,设置它的bottom成员.我们把分子设置为0,偏移量为0。
    
    data = new FormData();
    button2.setLayoutData(data);
    data.bottom = new FormAttachment(100, 0);
     
    
    
    
    为了以现在的按钮为标准来算偏移量,我们只需要把第一个按钮传个FormAttachment的构造函数就可以了,那么现
    
    在就不是以窗口边界来计算,而是以传递给它的按钮来计算了.
    
    我们要把这个按钮加到以有按钮的下面5个象素处,所以偏移量是5.

data.top = new FormAttachment(button, 5);
     
    
    我们不需要设置为以按钮的底部为界,因为默认情况下,边界被自动设是离这个按钮最近的边界.
    
    因为我们指定的FormAttachment是用来指定新按钮的顶部的,
    
    而且新按钮是在第一个按钮后面加上去的,新按钮离第一个按钮的地方最近的就是底部.
    
    
    
    你可能就用同样的构造函数来设置新按钮的左边界,甚至就用只需要一个Control对象的构造函数,
    
    因为偏移量是0.象这样:
    
    
    data.left = new FormAttachment(button);
     
    
    
    
    但是这句代码是以第一个按钮的右边为基准来计算的,如上图所示:因为新添加的按钮左边离第一个按钮最近的边界是它的右边.
    
    所以我们必须清楚地指定按第一个按钮的左边界为基准.
    
    只需要传给构造函数SWT.LEFT值给FromData对象的alignment成员:
    
    
    
    data.left = new FormAttachment(button, 0, SWT.LEFT);
     
    
    我们同样的方法设置新按钮的右边,完成任务.
    
    data.right = new FormAttachment(button, 0, SWT.RIGHT);
     
    
    完整的代码如下：
    
    import org.eclipse.swt.widgets.*;
    import org.eclipse.swt.layout.FormAttachment;
    import org.eclipse.swt.layout.FormData;
    import org.eclipse.swt.layout.FormLayout;
    import org.eclipse.swt.SWT;
    
    public class FormLayoutFormAttachment {
      public static void main(String[] args) {
        Display display = new Display();
        Shell shell = new Shell(display);
        FormLayout layout = new FormLayout();
        layout.marginHeight = 5;
        layout.marginWidth = 10;
        shell.setLayout(layout);
        Button button = new Button(shell, SWT.PUSH);
        button.setText("Button");
        FormData data = new FormData();
        data.height = 50;
        data.right = new FormAttachment(100, -50);
        data.left = new FormAttachment(0, 10);
        data.top = new FormAttachment(1, 4, 0);
        button.setLayoutData(data);
    
        Button button2 = new Button(shell, SWT.PUSH);
        button2.setText("Button 2");
        data = new FormData();
        button2.setLayoutData(data);
        data.bottom = new FormAttachment(100, 0);
        data.top = new FormAttachment(button, 5);
        data.left = new FormAttachment(button, 0, SWT.LEFT);
        data.right = new FormAttachment(button, 0, SWT.RIGHT);
    
        shell.pack();
        shell.open();
        while (!shell.isDisposed()) {
          if (!display.readAndDispatch()) {
            display.sleep();
          }
        }
        display.dispose();
      }
    }
     
    
    
    下面写一个更加复杂的程序,代码如下:我就不多解释了,应该都看得懂,运行结果出来后,
    
    无论怎么改变窗口的大小,所有按钮的位置都没有改变.
    
    
    
    import org.eclipse.swt.SWT;
    import org.eclipse.swt.layout.FormAttachment;
    import org.eclipse.swt.layout.FormData;
    import org.eclipse.swt.layout.FormLayout;
    import org.eclipse.swt.widgets.Button;
    import org.eclipse.swt.widgets.Display;
    import org.eclipse.swt.widgets.Shell;
    
    public class TestFormLayout {
    	public static void main(String[] args) {
    		Display display = new Display();
    		Shell shell = new Shell(display);
    		FormLayout layout = new FormLayout();
    		layout.marginHeight = 5;
    		layout.marginWidth = 10;
    		shell.setLayout(layout);
    		Button button = new Button(shell, SWT.PUSH);
    		button.setText("Button");
    		FormData data = new FormData();
    		data.height = 50;
    		data.right = new FormAttachment(100, -50);
    		data.left = new FormAttachment(0, 10);
    		data.top = new FormAttachment(1, 4, 0);
    		button.setLayoutData(data);
    
    		Button button2 = new Button(shell, SWT.PUSH);
    		button2.setText("Button 2");
    		data = new FormData();
    		button2.setLayoutData(data);
    		data.bottom = new FormAttachment(100, 0);
    		data.top = new FormAttachment(button, 5);
    		data.left = new FormAttachment(button, 0, SWT.LEFT);
    		data.right = new FormAttachment(button, 0, SWT.RIGHT);
    
    		shell.pack();
    		shell.open();
    		while (!shell.isDisposed()) {
    			if (!display.readAndDispatch()) {
    				display.sleep();
    			}
    		}
    		display.dispose();
    	}
    }
     
    
    
    
    下面写一个更加复杂的程序,代码如下:
    
    
    
    运行结果出来后,无论怎么改变窗口的大小,所有按钮的位置都没有改变.
    
    
    
    import org.eclipse.swt.SWT;
    import org.eclipse.swt.layout.FormAttachment;
    import org.eclipse.swt.layout.FormData;
    import org.eclipse.swt.layout.FormLayout;
    import org.eclipse.swt.layout.GridData;
    import org.eclipse.swt.layout.GridLayout;
    import org.eclipse.swt.widgets.Button;
    import org.eclipse.swt.widgets.Composite;
    import org.eclipse.swt.widgets.Display;
    import org.eclipse.swt.widgets.Shell;
    
    public class FormLayoutComplex {
    	public static void main(String[] args) {
    		Display display = new Display();
    		Shell shell = new Shell(display);
    		FormLayout layout = new FormLayout();
    		shell.setLayout(layout);
    		Button one = new Button(shell, SWT.PUSH);
    		one.setText("One");
    		FormData data = new FormData();
    		data.top = new FormAttachment(0, 5);
    		data.left = new FormAttachment(0, 5);
    		data.bottom = new FormAttachment(50, -5);
    		data.right = new FormAttachment(50, -5);
    		one.setLayoutData(data);
    
    		Composite composite = new Composite(shell, SWT.NONE);
    		GridLayout gridLayout = new GridLayout();
    		gridLayout.marginHeight = 0;
    		gridLayout.marginWidth = 0;
    		composite.setLayout(gridLayout);
    		Button two = new Button(composite, SWT.PUSH);
    		two.setText("two");
    		GridData gridData = new GridData(GridData.FILL_BOTH);
    		two.setLayoutData(gridData);
    		Button three = new Button(composite, SWT.PUSH);
    		three.setText("three");
    		gridData = new GridData(GridData.FILL_BOTH);
    		three.setLayoutData(gridData);
    		Button four = new Button(composite, SWT.PUSH);
    		four.setText("four");
    		gridData = new GridData(GridData.FILL_BOTH);
    		four.setLayoutData(gridData);
    		data = new FormData();
    		data.top = new FormAttachment(0, 5);
    		data.left = new FormAttachment(one, 5);
    		data.bottom = new FormAttachment(50, -5);
    		data.right = new FormAttachment(100, -5);
    		composite.setLayoutData(data);
    
    		Button five = new Button(shell, SWT.PUSH);
    		five.setText("five");
    		data = new FormData();
    		data.top = new FormAttachment(one, 5);
    		data.left = new FormAttachment(0, 5);
    		data.bottom = new FormAttachment(100, -5);
    		data.right = new FormAttachment(100, -5);
    		five.setLayoutData(data);
    		shell.pack();
    		shell.open();
    		while (!shell.isDisposed()) {
    			if (!display.readAndDispatch()) {
    				display.sleep();
    			}
    		}
    		display.dispose();
    	}
    }