graphic context就象Control最頂層的畫板，它可以使你向GUI components加入客制化的圖形，圖片，及不同字體的文本。同樣也提供事件處理

graphic context是在GC類中的，GC對象是附著于現(xiàn)存的Controls。

要創(chuàng)建一個graphically oriented的應(yīng)用程序，首先要創(chuàng)建graphic context，并將其與一個component相關(guān)聯(lián)，這兩步都可通過GC的constructor來實(shí)現(xiàn)。共有2個構(gòu)造函數(shù)，見下：
1. GC(Drawable)--Creates a GC and configures it for the Drawable object
2. GC(Drawable, int)--Creates and configures a GC and sets the text-display style，第二個參數(shù)可以是RIGHT_TO_LEFT或LEFT_TO_RIGHT（默認(rèn)值）;
第一個參數(shù)需要實(shí)現(xiàn)Drawable接口的對象， 此接口包含了與graphic context.內(nèi)部相聯(lián)系的方法。SWT提供了三個實(shí)現(xiàn)Drawable接口的類：Image, Device,?和 Control.


Control子類雖然都能包含圖形，但只有一個類是特別適合GC對象的：Canvas。它不僅提供了一個Composite的containment property，還可以用一系列的風(fēng)格來定義圖形在此區(qū)域內(nèi)如何顯示

示例：

package com.swtjface.Ch7;
import org.eclipse.swt.SWT;
import org.eclipse.swt.graphics.*;
import org.eclipse.swt.widgets.*;
public class DrawExample
{
public static void main (String [] args)
{
Display display = new Display();
Shell shell = new Shell(display);
shell.setText("Drawing Example");
Canvas canvas = new Canvas(shell, SWT.NONE);
canvas.setSize(150, 150);
canvas.setLocation(20, 20);//在shell中創(chuàng)建canvas
shell.open ();
shell.setSize(200,220);
GC gc = new GC(canvas);//在canvas中創(chuàng)建graphic context
gc.drawRectangle(10, 10, 40, 45);
gc.drawOval(65, 10, 30, 35);
gc.drawLine(130, 10, 90, 80);
gc.drawPolygon(new int[] {20, 70, 45, 90, 70, 70});
gc.drawPolyline(new int[] {10,120,70,100,100,130,130,75});
gc.dispose();//釋放Color對象
while (!shell.isDisposed())
{
?if (!display.readAndDispatch())
?display.sleep();
?}
?display.dispose();
?}
?}
有兩點(diǎn)需要注意：1.在調(diào)用shell.open()之前構(gòu)建Canvas對象，然后在調(diào)用shell.open()之后創(chuàng)建和使用GC對象
???????????????????? 2.在使用完之后一定要立即釋放GC object
如上例所示GC提供了一系列在Drawable對象上畫圖形的方法，如下：


但是上例中有個問題：當(dāng)shell被變灰過或者最小化過之后，圖形就會被擦去。所以我們需要解決的事，無論window怎么變化，圖形都保持可見。因此SWT在一個Drawable對象被刷新后讓你自行控制。這個更新的過程就被稱為painting。

Painting and PaintEvents

當(dāng)一個GC方法在一個Drawabel對象上畫出一個圖案，它僅執(zhí)行這個painting過程一次。如果用戶改變對象尺寸或是用另一個窗口去覆蓋它，則圖形會被消除。因此，應(yīng)用程序能否在外界事件影響下維持其外觀這一點(diǎn)相當(dāng)重要。

這些外部事件被稱為PaintEvents，接收它們的程序接口是PaintListener。一個Control在任何時候當(dāng)其外觀被應(yīng)用程序或是外界活動改變都會觸發(fā)一個PaintEvent。這些類對于事件和監(jiān)聽器的使用方式都和我們在第四章內(nèi)提到的類似。由于PaintListener只有一個事件處理方法，所以不需要使用adapter類

Canvas canvas = new Canvas(shell, SWT.NONE);
canvas.setSize(150, 150);
canvas.setLocation(20, 20);
canvas.addPaintListener(new PaintListener()
{
public void paintControl(PaintEvent pe)
{
GC gc = pe.gc;//每一個PaintEvent對象都包含有其自己的GC
gc.drawPolyline(new int[] {10,120,70,100,100,130,130,75});
}
});
shell.open();

每一個PaintEvent對象都包含有其自己的GC，主要有2個原因：1.因?yàn)檫@個GC instance是由事件產(chǎn)生的，所以PaintEvent會負(fù)責(zé)釋放他。2.應(yīng)用程序可以在shell open之前創(chuàng)建GC,這樣可以使圖形在一個獨(dú)立的類中被創(chuàng)建。

SWT在PaintListener接口內(nèi)優(yōu)化painting過程,SWT的開發(fā)者強(qiáng)烈建議Control的painting僅對PaintEvent作出反應(yīng)。如果一個應(yīng)用程序因?yàn)槠渌虮仨毟缕鋱D形，則他們推薦使用control的redraw()方法，這會在隊列中加入一個paint請求。之后，你可以調(diào)用update()方法來處理所有的綁定于該對象的paint請求。

需要牢記的是，雖然對于Control對象推薦在一個PaintListener內(nèi)painting，但是由于Device和Image對象并不能在該接口內(nèi)使用。如果你需要在一個image或device內(nèi)生成圖形，你必須單獨(dú)地生成一個GC對象并在使用結(jié)束后將其銷毀。

要客制化layout，需要繼承抽象類Layout，需要寫2個方法——computeSize() 和layout().

computeSize()

protected Point computeSize(Composite composite,
int wHint, int hHint,
boolean flushCache)
{
Point maxDimensions =
calculateMaxDimensions(composite.getChildren());
int stepsPerHemisphere =
stepsPerHemisphere(composite.getChildren().length);
int maxWidth = maxDimensions.x;
int maxHeight = maxDimensions.y;
int dimensionMultiplier = (stepsPerHemisphere + 1);
int controlWidth = maxWidth * dimensionMultiplier;
int controlHeight = maxHeight * dimensionMultiplier;
int diameter = Math.max(controlWidth, controlHeight);
Point preferredSize = new Point(diameter,
diameter);
... // code to handle case when our calculations
// are too large
return preferredSize;
}

參數(shù)：
1.composite--The object we’re going to populate. At the time this method is called, it has children, but neither the composite nor the children have been sized or positioned on the screen.

2.wHint and hHint--layout所需的最大長寬。若帶有參數(shù)SWT.DEFAULT,表示此layout可以隨意使用use whatever sizes it decides it needs.

3.flushCache--作為flag，to tell the layout whether it’s safe to use any cached values that it may be maintaining.

computeSize()的目的主要在于計算我們要layout的composite有多大
layout()
……

與之前所述的layout不同，form layout不是基于行和列的，它是基于與其他control之間的相對位置的。

FormLayout十分簡單，你只要：1.設(shè)定頁邊距（高，寬）屬性。 2.設(shè)定spacing屬性，即所有control間的距離(in pixels)

同樣可以使用FormData來配置單個的control。

FormData
如果一個control沒有一個FormData實(shí)例來描述它的話，就會默認(rèn)放在composite的右上角
width和height屬性指定了control的尺寸，in pixels.
top, bottom, right, 和left屬性，每一個都有一個FormAttachment實(shí)例，這些attachments描述了control與其他control之間的關(guān)系。

FormAttachment
有2個使用途徑：
1.通過使用percentage of the parent composite.


2.通過設(shè)定一個control和另一個control之間的相對位置?
《圖》

package com.swtjface.Ch6;
import org.eclipse.swt.*;
import org.eclipse.swt.widgets.*;
import org.eclipse.swt.layout.*;
public class Ch6FormLayoutComposite extends Composite {
public Ch6FormLayoutComposite(Composite parent) {
super(parent, SWT.NONE);
FormLayout layout = new FormLayout();
setLayout(layout);
Text t = new Text(this, SWT.MULTI);
FormData data = new FormData();
data.top = new FormAttachment(0, 0);
data.left = new FormAttachment(0, 0);
data.right = new FormAttachment(100);
data.bottom = new FormAttachment(75);//確定text的位置，因?yàn)樽笊辖鞘亲鴺?biāo)原點(diǎn)，所以right的百分?jǐn)?shù)為100。
t.setLayoutData(data);
Button ok = new Button(this, SWT.NONE);
ok.setText("Ok");
Button cancel = new Button(this, SWT.NONE);
cancel.setText("Cancel");
data = new FormData();
data.top = new FormAttachment(t);
data.right = new FormAttachment(cancel);//ok按鈕在text下面，cancel左邊
ok.setLayoutData(data);
data = new FormData();
data.top = new FormAttachment(t);
data.right = new FormAttachment(100);//cancel按鈕在text下面，在最右邊
cancel.setLayoutData(data);
}
}

最常用的一種layout.以row layout為基礎(chǔ)。

package com.swtjface.Ch6;
import org.eclipse.swt.*;
import org.eclipse.swt.widgets.*;
import org.eclipse.swt.layout.*;
public class Ch6GridLayoutComposite extends Composite {
public Ch6GridLayoutComposite(Composite parent) {
super(parent, SWT.NONE);
GridLayout layout = new GridLayout(4,false);//每一行有4個control，后一個參數(shù)是a
boolean to indicate whether the columns should take up an even amount of
space. By passing false, you tell the layout to only use the minimum amount of
space needed for each column.
setLayout(layout);
for (int i = 0; i < 16; ++i) {
Button button = new Button(this, SWT.NONE);
button.setText("Cell " + i);
}
}
}

Using GridData styles
十分類似于RowData對象。可通過其構(gòu)造函數(shù)來設(shè)定STYLE，這些STYLE可分為3類：FILL, HORIZONTAL_ALIGN, and VERTICAL_ALIGN.
1.FILL:此cell是否fill所有的availabe的空間。可用的值還包括FILL_HORIZONTAL（水平擴(kuò)張）,FILL_VERTICAL（垂直擴(kuò)張）,FILL_BOTH。
2.ALIGN，用來指定control在cell中的什么位置。值包括BEGINNING, END, CENTER和FILL。
具體參見下表

Using GridData size attributes
與RowData不同，GridData還有很多的public屬性。其中有些是布爾值類型的，一般會根據(jù)所設(shè)置的不同styles而自動管理，所以無需對其直接操作。還有一些是integer值，用來確定單個cells的大小。具體件下表：

可以多行/列顯示。

package com.swtjface.Ch6;
import org.eclipse.swt.*;
import org.eclipse.swt.widgets.*;
import org.eclipse.swt.layout.*;
public class Ch6RowLayoutComposite extends Composite {
public Ch6RowLayoutComposite(Composite parent) {
super(parent, SWT.NONE);
RowLayout layout = new RowLayout(SWT.HORIZONTAL);
setLayout(layout);
for (int i = 0; i < 16; ++i) {
Button button = new Button(this, SWT.NONE);
button.setText("Sample Text");
}
}
}

wrap——默認(rèn)為true,若設(shè)為false,所有的controls都在同一行。
pack——默認(rèn)為true.使所有的child controls都大小一樣。
justify——默認(rèn)為false. 若為true,每一行的control都會以間隔相同的方式排列。

RowData
可以通過setLayoutData()來設(shè)定每個control的大小，如：button.setLayoutData(new RowData(200 + 5 * i, 20 + i));

默認(rèn)為從左到右排放的，根據(jù)每個control實(shí)際所需的大小來分配空間，此composite中多于出來的空間，再平攤到每個control上。隨著composite的大小調(diào)整，control的大小也會跟著調(diào)整。

package com.swtjface.Ch6;
import org.eclipse.swt.*;
import org.eclipse.swt.widgets.*;
import org.eclipse.swt.layout.*;
public class Ch6FillLayoutComposite extends Composite {
public Ch6FillLayoutComposite(Composite parent) {
super(parent, SWT.NONE);
FillLayout layout = new FillLayout( SWT.VERTICAL); //默認(rèn)是SWT.HORIZONTAL
setLayout(layout);//為此Composite設(shè)定一個layout.如果漏了此語句，會顯示不出child control。
for (int i = 0; i < 8; ++i) {
Button button = new Button(this, SWT.NONE);
button.setText("Sample Text");
}
}
}

同ProgressIndicator一樣，它支持工作的虛擬單位，you need only initialize the ProgressIndicator with the total amount of work you expect to do and notify it as work is completed:

ProgressIndicator indicator = new ProgressIndicator(parent);
...
indicator.beginTask(10);
...
Display.getCurrent()display.asyncExec(new Runnable() {
public void run() {
//Inform the indicator that some amount of work has been done
indicator.worked(1);
}
});

正如上例所示，使用ProgressIndicator需要2步：
1.讓indicator知道總共有多少工作，通過使用beginTask().只有這個方法被調(diào)用了之后，這個control才會在屏幕上顯示。
2.每當(dāng)有一部分工作被完成了，就調(diào)用worked()。為了防止非ui的線程來update widgets，所以使用asyncExec()來解決這個問題。

ProgressIndicator也提供animated模式，即總工作量不知道的情況。在這種模式下，the bar continually fills and empties
until done() is called. 要使用這個模式，就要用beginAnimatedTask()代替beginTask();并且不需要worked()方法了 ProgressBar，進(jìn)度條，是ProgressIndicator的簡化版本。大多數(shù)情況下推薦使用ProgressIndicator。如果你決定直接使用ProgressBar，需要手動改變此bar的外觀。如下

//Style can be SMOOTH, HORIZONTAL, or VERTICAL
ProgressBar bar = new ProgressBar(parent, SWT.SMOOTH);
bar.setBounds(10, 10, 200, 32);
bar.setMaximum(100);
...
for(int i = 0; i < 10; i++) {
//Take care to only update the display from its
//own thread
Display.getCurrent().asyncExec(new Runnable() {
public void run() {
//Update how much of the bar should be filled in
bar.setSelection((int)(bar.getMaximum() * (i+1) / 10));
}
});
}

setSelection()causes the widget to be updated every time.This behavior is unlike that of ProgressIndicator or ProgressMonitorDialog,which will update the display only if it has changed by an amount that will be visible to the end user. 類似于scrollbars。scrollbars僅限于用在可滑動的item上，如text。

可通過setMinimum()和setMaximum()來設(shè)定它的范圍。可通過setThumb()來設(shè)定滑塊的值。在有些OS上，thumb的大小是常數(shù)。每按一下箭頭，所移動的值稱為increment.可通過setIncrement()來設(shè)定，按滑塊和箭頭間的空間所滑動的值為page increment，可通過PageIncrement()來設(shè)定。以上這些數(shù)據(jù)可以通過void setValues( int selection, int minimum, int maximum, int thumb, int increment, int pageIncrement)來一次性設(shè)定，其中selection是thumb的出發(fā)點(diǎn)。

Slider有個屬性用來設(shè)定其是水平還是垂直的，默認(rèn)為水平。

package com.swtjface.Ch5;
import org.eclipse.swt.SWT;
import org.eclipse.swt.layout.FillLayout;
import org.eclipse.swt.widgets.Composite;
import org.eclipse.swt.widgets.Slider;
public class Ch5Slider extends Composite {
public Ch5Slider(Composite parent) {
super(parent, SWT.NONE);
setLayout(new FillLayout());
Slider slider = new Slider(this, SWT.HORIZONTAL);
slider.setValues(1000, 400, 1600, 200, 10, 100);
}
}
類似于ToolBar的升級。他們的區(qū)別在于CoolBar上的item可以被重新配置，重新定大小。CoolBar的一般用途就是包含toolbars或按鈕。

String[] coolItemTypes = {"File", "Formatting", "Search"};
CoolBar coolBar = new CoolBar(parent, SWT.NONE);
for(int i = 0; i < coolItemTypes.length; i++)
{
CoolItem item = new CoolItem(coolBar, SWT.NONE);
ToolBar tb = new ToolBar(coolBar, SWT.FLAT);
for(int j = 0; j < 3; j++)
{
ToolItem ti = new ToolItem(tb, SWT.NONE);
ti.setText(coolItemTypes[i] + " Item #" + j);
}
}

是JFace的類，繼承自ContributionManager，凡是繼承了IAction或IContribution接口的對象都可被加至ToolBarManager.你只要花時間為ToolBarManager添加Action，Toolbar和ToolItem實(shí)例會自動產(chǎn)生。

你可通過調(diào)用ApplicationWindow的createToolBarManager()來為你的應(yīng)用程序添加一個toolbar。與MenuManager不同的是，createToolBarManager()需要一個style參數(shù)，這個參數(shù)用來設(shè)定ToolBar所用的按鈕的風(fēng)格：flat或normal。

• ControlContribution

除了MenuManager所用的ContributionItems之外，還有一個新的ContributionItem，只能被ToolBarManager使用——ControlContribution。這個類可將任何能被用于toolbar的Control打包進(jìn)去。

要使用ControlContribution類，必須要實(shí)現(xiàn)抽象方法createControl().

toolBarManager.add(new ControlContribution("Custom") {
protected Control createControl(Composite parent) {
SashForm sf = new SashForm(parent, SWT.NONE);
Button b1 = new Button(sf, SWT.PUSH);
b1.setText("Hello");
Button b2 = new Button(sf, SWT.PUSH);
b2.setText("World");
b2.addSelectionListener(new SelectionAdapter() {
public void widgetSelected(SelectionEvent e) {
System.out.println("Selected:" + e);
}
});
return sf;
}
});

如果你希望有任何的事件發(fā)生，必須在你的controls上實(shí)現(xiàn)SelectionListeners

• Creating toolbars by hand

如果你不想ToolBarManager來創(chuàng)建toolbar的話，可以手動創(chuàng)建，需要用到ToolBar和ToolItem類.

Toolbar
是一個composite control，包含多個ToolItems.Toolbar由多個小圖標(biāo)按鈕組成，一般是16-by-16bitmap圖片。每個按鈕都對應(yīng)一個ToolItem。Toolbar可以是水平的也可以是垂直的，默認(rèn)為水平

ToolItem
每一個ToolItem都有一個圖片，如果沒有，默認(rèn)為紅色方塊。When the user selects a ToolItem from the menu, it broadcasts the event to any registered SelectionListeners.Your application should register a listener with each ToolItem and use that listener to perform whatever logic corresponds to the menu item.

三種類型的Combo control:
1.Simple:默認(rèn)類型，一個可編輯的text field和一個供選擇的list
2.Drop-down:下拉列表，文本框可編輯
3.Read-only：文本框不可編輯的下拉列表，可用select( 0 )來將其默認(rèn)選中列表中的首項。

以上三種類型可在構(gòu)造函數(shù)中通過STYLE.*來設(shè)置。

先要將org.eclipse.text_x.y.z和org.eclipse.jface.text_x.y.z加到classpath

• TextViewer and Document

兩個重要的接口：IDocument和ITextViewer。JFace為其提供了默認(rèn)的實(shí)現(xiàn)。

一個IDocument的實(shí)例持有被編輯的真實(shí)的文本信息。它的主要實(shí)現(xiàn)是Document類。AbstractDocument提供了部分實(shí)現(xiàn)，你可通過繼承它來添加自己的實(shí)現(xiàn)。IDocument允許通過IDocumentListener接口來獲取內(nèi)容編輯的通知。

IDocument還提供了以下功能
Positions
可以給每一個text區(qū)域分配一個記號來作為它的Position。當(dāng)被指定給某個ducument時一個Position對象有an offset and a length of text。如果document的text被更新的話，Position也會同步更新，所以他永遠(yuǎn)都是指向同一段文字。Position類本身提供了一些基本的功能，可通過繼承他來完善更多有用的功能。

Partition content types
每個document由一個或多個partitions組成，通過ITypedRegion接口來表現(xiàn)。每一個partition可以有各自的內(nèi)容類型，如plain text, rich text, or HTML。要使用它，你要創(chuàng)建一個IDocumentPartitioner然后assign給你的document,然后document的partitioner就會負(fù)責(zé)響應(yīng)對指定位置內(nèi)容類型的查詢，它必須通過實(shí)現(xiàn)computePartitioning()來返回包含此document中所有ITypedRegions的一個數(shù)組。不需要實(shí)現(xiàn)你自己的document partitioner。如果沒有創(chuàng)建，整個document就是一個區(qū)域，類型為IDocument.DEFAULT_CONTENT_TYPE。

Searching
IDocument通過search()提供了搜索的功能。不支持regular expressions or other patterns，但提供了search start location,direction, and case sensitivity and whether to match whole words only.

ITextViewer將一個標(biāo)準(zhǔn)的text widget轉(zhuǎn)換成一個基于document的text widget

ITextViewer的默認(rèn)實(shí)現(xiàn)是TextViewer，它使用StyledText來顯示數(shù)據(jù)。ITextViewer支持text modifications的listener，也支持visual events（如改變viewport，即text的當(dāng)前可視區(qū)域）的監(jiān)聽器。

雖然作為ITextViewer的默認(rèn)應(yīng)用，如果你想要修改顯示，TextViewer允許你直接accessStyledText，但建議你使用TextPresentation，因?yàn)樗梢允占撐臋n中帶有的各個不同的StyleRanges。

ITextViewer還支持很多不同類型的插件，可用來修改widget的行為。可以被customized的功能有：
1.通過IUndoManager來支持undo
2.通過ITextDoubleClickStrategy來支持對鼠標(biāo)雙擊的處理
3.通過IAutoIndentStrategy來支持文本的自動縮進(jìn)
4.通過ITextHover來實(shí)現(xiàn)，當(dāng)鼠標(biāo)停留在document的一個section上時，顯示text.
要使用上述插件，你需要分配一個適當(dāng)?shù)慕涌趯?shí)例給text viewer，然后調(diào)用activatePlugins().

如下列出了org.eclipse.jface.text的子包及其作用