组成:1)模型和元素,模型为元素的集合;2)内容提供者与标签提供者;3)控件 ;4)查看器(负责协调前面三个部分)。
模型维护的是元素集合,需要自己开发,当模型内容改变时应向外界发出一个"属性改变"的事件。
通过内容提供器对模型解析,所有内容提供者都实现IContentProvider接口,对于具体的子类,又有子接口,如列表和表格查看器实现 IStructuredContentProvider,树查看器实现ITreeContentProvider。内容提供器的另一个工作是监听模型的变化,并操作查看器将变化反映在界面上。
LabelProvider负责每个元素如何在界面显示,需要实现IBaseLabelProvider,表格查看器要实现 ITableLabelProvider。其中的isLabelProperty(object element ,String property)指定property属性是否会用于显示,在更新元素时,查看器会调用这个方法,若元素的变化不影响显示,则没有必要更新
要实现对模型的监听,需要将模型模拟成一个事件源,将内容提供方模拟成一个监听器。协调关系如图:
下面给个例子,代码来自《eclipse学习笔记》:
User:为元素,是自定义的Java类
public class ListModel {
public static final String ADD_ELEMENT = "addElement";
public static final String REMOVE_ELEMENT = "removeElement";
private PropertyChangeSupport delegate;
private Vector content;
public ListModel() {
content = new Vector();
delegate = new PropertyChangeSupport(this);
}
//模拟事件源
public void addPropertyChangeListener(PropertyChangeListener listener) {
delegate.addPropertyChangeListener(listener);
}
public void firePropertyChange(PropertyChangeEvent evt) {
delegate.firePropertyChange(evt);
}
public void removePropertyChangeListener(PropertyChangeListener listener) {
delegate.removePropertyChangeListener(listener);
}
//触发属性改变事件
public void add(Object element) {
if (content.add((User) element))
firePropertyChange(new PropertyChangeEvent(this, ADD_ELEMENT, null,
element));
}
//触发属性改变事件
public void remove(Object element) {
if (content.remove(element))
firePropertyChange(new PropertyChangeEvent(this, REMOVE_ELEMENT,
null, element));
}
public Object[] elements() {
return content.toArray();
}
}
public class ListContentProvider implements IStructuredContentProvider,PropertyChangeListener{
private ListViewer viewer;
private ListModel model;
//返回元素集合
@Override
public Object[] getElements(Object inputElement) {
return model.elements();
}
@Override
public void dispose() {
}
//设置输入模型,注册监听器开始对新模型监听
@Override
public void inputChanged(Viewer viewer, Object oldInput, Object newInput) {
this.viewer = (ListViewer) viewer;
if (oldInput instanceof ListModel)
((ListModel) oldInput).removePropertyChangeListener(this);
if (newInput instanceof ListModel) {
this.model = (ListModel) newInput;
((ListModel) newInput).addPropertyChangeListener(this);
}
}
//响应属性改变事件
@Override
public void propertyChange(PropertyChangeEvent evt) {
if (ListModel.ADD_ELEMENT.equals(evt.getPropertyName()))
viewer.add(evt.getNewValue());
if (ListModel.REMOVE_ELEMENT.equals(evt.getPropertyName()))
viewer.remove(evt.getNewValue());
}
}
public class ListLabelProvider implements ILabelProvider{
@Override
public Image getImage(Object element) {
return null;
}
@Override
public String getText(Object element) {
if(element instanceof User)
return ((User)element).getName();
return element.toString();
}
}
//使用
public static void main(String[] args) {
Display display = Display.getDefault();
Shell shell = new Shell(display);
shell.setSize(400, 400);
shell.setLayout(new FillLayout());
ListViewer viewer = new ListViewer(shell, SWT.BORDER);
viewer.setContentProvider(new ListContentProvider());
viewer.setLabelProvider(new ListLabelProvider());
ListModel input = new ListModel();
viewer.setInput(input);
shell.open();
shell.layout();
//只需要操作模型就能改变视图,实现界面与模型完全分离
input.add(new User("1","张三"));
input.add(new User("2","李四"));
input.add(new User("3","王五"));
while (!shell.isDisposed())
if (!display.readAndDispatch())
display.sleep();
}