原文： http://zetcode.com/gui/javaswt/widgets/

在 Java SWT 编程教程的这一部分中，我们将介绍一些 SWT 小部件。

小部件是 GUI 应用的基本构建块。 将小部件视为乐高玩具的一部分。 多年来，几个小部件已成为所有 OS 平台上所有工具包中的标准。 例如，按钮，复选框或滚动条。

Label

Label是显示字符串或图像的不可选择的用户界面对象。 此外，它可以显示水平或垂直线。

LabelEx.java

  1. package com.zetcode;
  3. import org.eclipse.swt.SWT;
  4. import org.eclipse.swt.graphics.Point;
  5. import org.eclipse.swt.widgets.Display;
  6. import org.eclipse.swt.widgets.Label;
  7. import org.eclipse.swt.widgets.Shell;
  9. /**
  10.  * ZetCode Java SWT tutorial
  11.  *
  12.  * This program uses the Label widget to
  13.  * show lyrics of a song.
  14.  *
  15.  * Author: Jan Bodnar
  16.  * Website: zetcode.com
  17.  * Last modified: June 2015
  18.  */
  20. public class LabelEx {
  22.     final String lyrics =
  23. "And I know that he knows I'm unfaithful\n"+
  24. "And it kills him inside\n"+
  25. "To know that I am happy with some other guy\n"+
  26. "I can see him dyin'\n"+
  27. "\n"+
  28. "I don't wanna do this anymore\n"+
  29. "I don't wanna be the reason why\n"+
  30. "Every time I walk out the door\n"+
  31. "I see him die a little more inside\n"+
  32. "I don't wanna hurt him anymore\n"+
  33. "I don't wanna take away his life\n"+
  34. "I don't wanna be... A murderer";
  36.     public LabelEx(Display display) {
  38.         initUI(display);
  39.     }
  41.     private void initUI(Display display) {
  43.         Shell shell = new Shell(display, SWT.SHELL_TRIM | SWT.CENTER);
  45.         Label label = new Label(shell, SWT.LEFT);
  46.         label.setText(lyrics);
  48.         Point p = label.computeSize(SWT.DEFAULT, SWT.DEFAULT);
  49.         label.setBounds(5, 5, p.x+5, p.y+5);
  51.         shell.setText("Unfaithful");
  52.         shell.pack();
  53.         shell.open();
  55.         while (!shell.isDisposed()) {
  56.             if (!display.readAndDispatch()) {
  57.                 display.sleep();
  58.             }
  59.         }
  60.     }
  62.     @SuppressWarnings("unused")
  63.     public static void main(String[] args) {
  65.         Display display = new Display();
  66.         LabelEx ex = new LabelEx(display);
  67.         display.dispose();
  68.     }
  69. }

该代码示例在窗口上显示了一些歌词。

  1.     String lyrics =
  2. "And I know that he knows I'm unfaithful\n"+
  3. "And it kills him inside\n"+
  4. ...

我们构建多行文本。

  1. Label label = new Label(shell, SWT.LEFT);
  2. label.setText(lyrics);

Label小部件已创建； SWT.LEFT选项使其文本保持左对齐。

  1. Point p = label.computeSize(SWT.DEFAULT, SWT.DEFAULT);
  2. label.setBounds(5, 5, p.x+5, p.y+5);

我们计算文本的大小，以便在文本周围放置一些空间。

  1. shell.pack();

pack()方法将窗口调整为首选大小。 足够大以显示标签小部件。

CheckBox

在 SWT 中，复选按钮是Button的特例。 它是具有两种状态的窗口小部件：打开和关闭。 接通状态通过复选标记显示。 它用来表示一些布尔属性。

CheckButtonEx.java

  1. package com.zetcode;
  3. import org.eclipse.swt.SWT;
  4. import org.eclipse.swt.layout.RowLayout;
  5. import org.eclipse.swt.widgets.Button;
  6. import org.eclipse.swt.widgets.Display;
  7. import org.eclipse.swt.widgets.Shell;
  9. /**
  10.  * ZetCode Java SWT tutorial
  11.  *
  12.  * This program uses a check button
  13.  * widget to show/hide the title
  14.  * of the window.
  15.  *
  16.  * Author: Jan Bodnar
  17.  * Website: zetcode.com
  18.  * Last modified: June 2015
  19.  */
  21. public class CheckButtonEx {
  23.     private Shell shell;
  25.     public CheckButtonEx(Display display) {
  27.         initUI(display);
  28.     }
  30.     private void initUI(Display display) {
  32.         shell = new Shell(display);
  34.         RowLayout layout = new RowLayout();
  35.         layout.marginLeft = 30;
  36.         layout.marginTop = 30;
  37.         shell.setLayout(layout);
  39.         Button cb = new Button(shell, SWT.CHECK);
  40.         cb.setText("Show title");
  41.         cb.setSelection(true);
  43.         cb.addListener(SWT.Selection, event -> onButtonSelect(cb));
  45.         shell.setText("Check button");
  46.         shell.setSize(250, 200);
  47.         shell.open();
  49.         while (!shell.isDisposed()) {
  50.             if (!display.readAndDispatch()) {
  51.                 display.sleep();
  52.             }
  53.         }
  54.     }
  56.     private void onButtonSelect(Button cb) {
  58.         if (cb.getSelection()) {
  59.             shell.setText("Check button");
  60.         } else {
  61.             shell.setText("");
  62.         }        
  63.     }
  65.     @SuppressWarnings("unused")
  66.     public static void main(String[] args) {
  68.         Display display = new Display();
  69.         CheckButtonEx ex = new CheckButtonEx(display);
  70.         display.dispose();
  71.     }
  72. }

窗口标题的显示取决于检查按钮的状态。

  1. Button cb = new Button(shell, SWT.CHECK);
  2. cb.setText("Show title");

通过将SWT.CHECK传递给Button构造器来创建复选按钮小部件。 setText()方法设置按钮的标签。

  1. cb.setSelection(true);

默认情况下标题是可见的，因此我们默认使用setSelection()方法选择复选按钮。

  1. cb.addListener(SWT.Selection, event -> onButtonSelect(cb));

我们向按钮的SWT.Selection事件类型添加一个监听器对象。

  1. private void onButtonSelect(Button cb) {
  3.     if (cb.getSelection()) {
  4.         shell.setText("Check button");
  5.     } else {
  6.         shell.setText("");
  7.     }        
  8. }

在onButtonSelect()方法内部，我们根据选中按钮的状态显示或隐藏窗口的标题。 确认按钮的状态通过getSelection()方法确定。

Java SWT 中的小部件 - 图1

图：复选按钮

Spinner

Spinner控件允许从一系列值中选择一个数字。 可以通过单击向上和向下箭头或通过按下和向上键或向上键和来选择该值。 向下翻页键。

SpinnerEx.java

  1. package com.zetcode;
  3. import org.eclipse.swt.SWT;
  4. import org.eclipse.swt.layout.RowData;
  5. import org.eclipse.swt.layout.RowLayout;
  6. import org.eclipse.swt.widgets.Display;
  7. import org.eclipse.swt.widgets.Label;
  8. import org.eclipse.swt.widgets.Shell;
  9. import org.eclipse.swt.widgets.Spinner;
  11. public class SpinnerEx {
  13.     private Label label;
  15.     public SpinnerEx(Display display) {
  17.         initUI(display);
  18.     }
  20.     private void initUI(Display display) {    
  22.         Shell shell = new Shell(display, SWT.SHELL_TRIM | SWT.CENTER);
  24.         RowLayout layout = new RowLayout();
  25.         layout.marginLeft = 10;
  26.         layout.marginTop = 10;
  27.         layout.spacing = 30;
  28.         layout.center = true;
  29.         shell.setLayout(layout);
  31.         Spinner spinner = new Spinner(shell, SWT.BORDER);
  32.         spinner.setMinimum(0);
  33.         spinner.setMaximum(100);
  34.         spinner.setSelection(0);
  35.         spinner.setIncrement(1);
  36.         spinner.setPageIncrement(10);       
  37.         spinner.setLayoutData(new RowData(30, -1));
  39.         spinner.addListener(SWT.Selection, event -> onSelected(spinner));
  41.         label = new Label(shell, SWT.NONE);
  42.         label.setText("0");
  44.         shell.setText("Spinner");
  45.         shell.setSize(200, 150);
  46.         shell.open();
  48.         while (!shell.isDisposed()) {
  49.             if (!display.readAndDispatch()) {
  50.                 display.sleep();
  51.             }
  52.         }        
  53.     }
  55.     private void onSelected(Spinner spinner) {
  57.         String val = spinner.getText();
  58.         label.setText(val);
  59.         label.pack();
  60.     }
  62.     @SuppressWarnings("unused")
  63.     public static void main(String[] args) {
  65.         Display display = new Display();
  66.         SpinnerEx ex = new SpinnerEx(display);
  67.         display.dispose();
  68.     }    
  69. }

该示例具有Spinner和Label。 从微调器中选择的值显示在标签中。

  1. Spinner spinner = new Spinner(shell, SWT.BORDER);

创建Spinner控件的实例。

  1. spinner.setMinimum(0);
  2. spinner.setMaximum(100);
  3. spinner.setSelection(0);
  4. spinner.setIncrement(1);
  5. spinner.setPageIncrement(10);

我们使用微调器 API 指定最小，最大，当前，增量和页面增量值。

  1. spinner.addListener(SWT.Selection, event -> onSelected(spinner));

等待微调器选择事件的监听器已添加到控件中。 触发事件时，将调用onSelected()方法。

  1. private void onSelected(Spinner spinner) {
  3.     String val = spinner.getText();
  4.     label.setText(val);
  5.     label.pack();
  6. }

我们获得微调器的当前值，并将其设置为标签组件。

Java SWT 中的小部件 - 图2

图：旋钮

List小部件

List小部件使用户可以从项目列表中选择一个选项。 列表可以是单选或多选。

ListWidgetEx.java

  1. package com.zetcode;
  3. import org.eclipse.swt.SWT;
  4. import org.eclipse.swt.layout.FormAttachment;
  5. import org.eclipse.swt.layout.FormData;
  6. import org.eclipse.swt.layout.FormLayout;
  7. import org.eclipse.swt.widgets.Display;
  8. import org.eclipse.swt.widgets.Label;
  9. import org.eclipse.swt.widgets.List;
  10. import org.eclipse.swt.widgets.Shell;
  12. /**
  13.  * ZetCode Java SWT tutorial
  14.  *
  15.  * This program shows the List widget.
  16.  *
  17.  * Author: Jan Bodnar
  18.  * Website: zetcode.com
  19.  * Last modified: June 2015
  20.  */
  22. public class ListWidgetEx {
  24.     private Label status;
  26.     public ListWidgetEx(Display display) {
  28.         initUI(display);
  29.     }
  31.     private void initUI(Display display) {
  33.         Shell shell = new Shell(display);
  35.         status = new Label(shell, SWT.NONE);
  36.         status.setText("Ready");
  38.         FormLayout layout = new FormLayout();
  39.         layout.marginHeight = 5;
  40.         layout.marginWidth = 5;
  41.         layout.spacing = 5;
  42.         shell.setLayout(layout);
  44.         FormData labelData = new FormData();
  45.         labelData.left = new FormAttachment(0);
  46.         labelData.right = new FormAttachment(100);
  47.         labelData.bottom = new FormAttachment(100);
  48.         status.setLayoutData(labelData);
  50.         List list = new List(shell, SWT.BORDER);
  52.         list.add("Aliens");
  53.         list.add("Capote");
  54.         list.add("Neverending story");
  55.         list.add("Starship troopers");
  56.         list.add("Exorcist");
  57.         list.add("Omen");
  59.         list.addListener(SWT.Selection, event -> onListItemSelect(list));
  61.         FormData listData = new FormData();
  62.         listData.width = 250;
  63.         listData.height = 200;
  64.         listData.left = new FormAttachment(shell, 0);
  65.         listData.top = new FormAttachment(shell, 0);
  66.         listData.right = new FormAttachment(100, 0);
  67.         listData.bottom = new FormAttachment(status, 0);
  68.         list.setLayoutData(listData);
  70.         shell.setText("List");
  71.         shell.pack();
  72.         shell.open();
  74.         while (!shell.isDisposed()) {
  75.             if (!display.readAndDispatch()) {
  76.                 display.sleep();
  77.             }
  78.         }
  79.     }
  81.     private void onListItemSelect(List list) {
  83.         String[] items = list.getSelection();
  84.         status.setText(items[0]);        
  85.     }
  87.     @SuppressWarnings("unused")
  88.     public static void main(String[] args) {
  90.         Display display = new Display();
  91.         ListWidgetEx ex = new ListWidgetEx(display);
  92.         display.dispose();
  93.     }
  94. }

在此示例中，从列表小部件中选择的项目显示在状态栏中。

  1. status = new Label(shell, SWT.NONE);
  2. status.setText("Ready");

标签小部件用于状态栏。 SWT 不将本机窗口小部件用于状态栏。

  1. FormLayout layout = new FormLayout();
  2. layout.marginHeight = 5;
  3. layout.marginWidth = 5;
  4. layout.spacing = 5;
  5. shell.setLayout(layout);

我们使用FormLayout小部件在窗口上排列小部件。 设置了一些边距和间距。

  1. FormData labelData = new FormData();
  2. labelData.left = new FormAttachment(0);
  3. labelData.right = new FormAttachment(100);
  4. labelData.bottom = new FormAttachment(100);
  5. status.setLayoutData(labelData);

此代码将状态标签粘贴在窗口底部； 状态栏的通常位置。

  1. List list = new List(shell, SWT.BORDER);

List小部件已创建。 默认选择模式是单选。

  1. list.add("Aliens");
  2. list.add("Capote");
  3. list.add("Neverending story");
  4. list.add("Starship troopers");
  5. list.add("Exorcist");
  6. list.add("Omen");

它充满了数据。

  1. list.addListener(SWT.Selection, event -> onListItemSelect(list));

我们将选择监听器添加到List小部件。 在列表选择事件中，将调用onListItemSelect()方法。

  1. FormData listData = new FormData();
  2. listData.width = 250;
  3. listData.height = 200;
  4. listData.left = new FormAttachment(shell, 0);
  5. listData.top = new FormAttachment(shell, 0);
  6. listData.right = new FormAttachment(100, 0);
  7. listData.bottom = new FormAttachment(status, 0);
  8. list.setLayoutData(listData);

此代码使List小部件占据了窗口区域的大部分。 width和height属性指定列表的首选大小。

  1. private void onListItemSelect(List list) {
  3.     String[] items = list.getSelection();
  4.     status.setText(items[0]);        
  5. }

在onListItemSelect()内部，我们确定列表中的选定项目并将其设置为状态栏。

Java SWT 中的小部件 - 图3

图：List小部件

Slider

Slider是一个小部件，可让用户通过在有限间隔内滑动旋钮以图形方式选择一个值。 我们的示例将显示音量控制。

SliderEx.java

  1. package com.zetcode;
  3. import org.eclipse.swt.SWT;
  4. import org.eclipse.swt.graphics.Device;
  5. import org.eclipse.swt.graphics.Image;
  6. import org.eclipse.swt.layout.RowData;
  7. import org.eclipse.swt.layout.RowLayout;
  8. import org.eclipse.swt.widgets.Display;
  9. import org.eclipse.swt.widgets.Label;
  10. import org.eclipse.swt.widgets.Shell;
  11. import org.eclipse.swt.widgets.Slider;
  13. /**
  14.  * ZetCode Java SWT tutorial
  15.  *
  16.  * In this program, we use the slider
  17.  * widget to create a volume control
  18.  *
  19.  * Author: Jan Bodnar
  20.  * Website: zetcode.com
  21.  * Last modified: June 2015
  22.  */
  24. public class SliderEx {
  26.     private Shell shell;
  27.     private Label label;
  28.     private Image mute;
  29.     private Image min;
  30.     private Image med;
  31.     private Image max;
  33.     public SliderEx(Display display) {
  35.         initUI(display);
  36.     }
  38.     private void loadImages() {
  40.         Device dev = shell.getDisplay();
  42.         try {
  44.             mute = new Image(dev, "mute.png");
  45.             min = new Image(dev, "min.png");
  46.             med = new Image(dev, "med.png");
  47.             max = new Image(dev, "max.png");
  49.         } catch(Exception e) {
  51.             System.out.println("Cannot load images");
  52.             System.out.println(e.getMessage());
  53.             System.exit(1);
  54.         }       
  55.     }
  57.     private void initUI(Display display) {
  59.         shell = new Shell(display, SWT.SHELL_TRIM | SWT.CENTER);
  61.         loadImages();
  63.         RowLayout layout = new RowLayout();
  64.         layout.marginLeft = 30;
  65.         layout.marginTop = 30;
  66.         layout.spacing = 30;
  67.         layout.fill = true;
  68.         shell.setLayout(layout);
  70.         Slider slider = new Slider(shell, SWT.HORIZONTAL);
  71.         slider.setMaximum(100);
  72.         slider.setLayoutData(new RowData(180, -1));
  74.         label = new Label(shell, SWT.IMAGE_PNG);
  75.         label.setImage(mute);
  77.         slider.addListener(SWT.Selection, event -> onSelection(slider));
  79.         shell.setText("Slider");
  80.         shell.setSize(350, 200);
  81.         shell.open();
  83.         while (!shell.isDisposed()) {
  84.             if (!display.readAndDispatch()) {
  85.                 display.sleep();
  86.             }
  87.         }
  88.     }
  90.     private void onSelection(Slider slider) {
  92.         int value = slider.getSelection();
  94.         if (value == 0) {
  95.             label.setImage(mute);
  96.             label.pack();
  97.         } else if (value > 0 && value <= 30) {
  98.             label.setImage(min);
  99.         } else if (value > 30 && value < 80) {
  100.             label.setImage(med);
  101.         } else {
  102.             label.setImage(max);
  103.         }               
  104.     }
  106.     @Override
  107.     public void finalize() {
  109.         mute.dispose();
  110.         med.dispose();
  111.         min.dispose();
  112.         max.dispose();
  113.     }
  115.     public static void main(String[] args) {
  117.         Display display = new Display();
  118.         SliderEx ex = new SliderEx(display);
  119.         ex.finalize();
  120.         display.dispose();
  121.     }
  122. }

在上面的示例中，我们有一个Slider和一个Label小部件。 通过拖动滑块的旋钮，我们可以更改标签中显示的Image。

  1. try {
  3.     mute = new Image(dev, "mute.png");
  4.     min = new Image(dev, "min.png");
  5.     med = new Image(dev, "med.png");
  6.     max = new Image(dev, "max.png");
  8. } catch(Exception e) {
  10.     System.out.println("Cannot load images");
  11.     System.out.println(e.getMessage());
  12.     System.exit(1);
  13. }

图像从磁盘加载。

  1. Slider slider = new Slider(shell, SWT.HORIZONTAL);
  2. slider.setMaximum(100);

Slider小部件已创建。 最大值为 100。

  1. label = new Label(shell, SWT.IMAGE_PNG);
  2. label.setImage(mute);

使用SWT.IMAGE_PNG参数，标签窗口小部件显示 PNG 图像。 setImage()方法将图像设置为标签。

  1. slider.addListener(SWT.Selection, event -> onSelection(slider));

监听器已添加到滑块小部件。

  1. int value = slider.getSelection();

在onSelection()方法内部，我们使用getSelection()方法获得滑块控件的值。

  1. if (value == 0) {
  2.     label.setImage(mute);
  3.     label.pack();
  4. } else if (value > 0 && value <= 30) {
  5.     label.setImage(min);
  6. } else if (value > 30 && value < 80) {
  7.     label.setImage(med);
  8. } else {
  9.     label.setImage(max);
  10. }

根据获得的值，我们在标签小部件中更改图片。

  1. @Override
  2. public void finalize() {
  4.     mute.dispose();
  5.     med.dispose();
  6.     min.dispose();
  7.     max.dispose();
  8. }

最后，资源被释放。

Java SWT 中的小部件 - 图4

图：Slider小部件

Combo小部件

Combo是一个小部件，允许用户从选项的下拉列表中进行选择。

ComboEx.java

  1. package com.zetcode;
  3. import org.eclipse.swt.SWT;
  4. import org.eclipse.swt.layout.RowData;
  5. import org.eclipse.swt.layout.RowLayout;
  6. import org.eclipse.swt.widgets.Combo;
  7. import org.eclipse.swt.widgets.Display;
  8. import org.eclipse.swt.widgets.Label;
  9. import org.eclipse.swt.widgets.Shell;
  11. /**
  12.  * ZetCode Java SWT tutorial
  13.  *
  14.  * In this program, we use the Combo
  15.  * widget to select an option. 
  16.  * The selected option is shown in the
  17.  * Label widget.
  18.  *
  19.  * Author: Jan Bodnar
  20.  * Website: zetcode.com
  21.  * Last modified: June 2015
  22.  */
  24. public class ComboEx {
  26.     private Label label;
  28.     public ComboEx(Display display) {
  30.         initUI(display);
  31.     }
  33.     private void initUI(Display display) {
  35.         Shell shell = new Shell(display, SWT.SHELL_TRIM | SWT.CENTER);
  37.         RowLayout layout = new RowLayout(SWT.VERTICAL);
  38.         layout.marginLeft = 50;
  39.         layout.marginTop = 30;
  40.         layout.spacing = 30;
  41.         shell.setLayout(layout);
  43.         Combo combo = new Combo(shell, SWT.DROP_DOWN);
  44.         combo.add("Ubuntu");
  45.         combo.add("Fedora");
  46.         combo.add("Arch");
  47.         combo.add("Red Hat");
  48.         combo.add("Mint");
  49.         combo.setLayoutData(new RowData(150, -1));
  51.         label = new Label(shell, SWT.LEFT);
  52.         label.setText("...");   
  54.         combo.addListener(SWT.Selection, event -> onSelected(combo));
  56.         shell.setText("Combo");
  57.         shell.setSize(300, 250);
  58.         shell.open();
  60.         while (!shell.isDisposed()) {
  61.             if (!display.readAndDispatch()) {
  62.                 display.sleep();
  63.             }
  64.         }
  65.     }
  67.     private void onSelected(Combo combo) {
  69.         label.setText(combo.getText());
  70.         label.pack();        
  71.     }
  73.     @SuppressWarnings("unused")
  74.     public static void main(String[] args) {
  76.         Display display = new Display();
  77.         ComboEx ex = new ComboEx(display);
  78.         display.dispose();
  79.     }
  80. }

该示例显示了一个组合和一个标签。 该组合具有六个选项的列表。 这些是 Linux 发行版的名称。 标签窗口小部件显示了从组合框中选择的选项。

  1. Combo combo = new Combo(shell, SWT.DROP_DOWN);

Combo小部件已创建。

  1. combo.add("Ubuntu");
  2. combo.add("Fedora");
  3. combo.add("Mandriva");
  4. combo.add("Red Hat");
  5. combo.add("Mint");

组合框小部件充满了数据。

  1. private void onSelected(Combo combo) {
  3.     label.setText(combo.getText());
  4.     label.pack();        
  5. }

我们将所选文本设置为标签小部件。 pack()方法使标签适合组合中新字符串的大小。

Java SWT 中的小部件 - 图5

图：Combo小部件

在 Java SWT 教程的这一部分中，我们描述了 SWT 库的一些小部件。