JFace Viewer 4

<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">

5.1.8. TreeViewer TreeViewer ç±»å°è£äºtreeæ§ä»¶ãæ æ¥çå¨æç§ç¶å­å³ç³»æ¥æ¾ç¤ºåç­çº§ç对象å表ãæ­¤æ¥çå¨éè¦è®¾ç½®æ ç­¾ä¾ç»å¨åå容ä¾ç»å¨ãThe CheckboxTreeViewerå å¥äºå¯¹ä¸ªå«æ¡ç®æ³ç°çæ¯æï¼è¿å¯ä»¥é中ååéä¸æ¡ç®ç¸å³èçå¤éæ¡ã常ç¨çAPIåæ¬: add(Object, Object) 为æ¥çå¨ä¸­æå®åç´ æ·»å å­åç´ ã add(Object, Object[]) 为æ¥çå¨ä¸­æå®åç´ æ·»å è¥å¹²å­åç´ ã addTreeListener(ITreeViewerListener)为æ¥çå¨æ·»å å±å¼æ¶ç¼©äºä»¶çå¬å¨ã collapseAll() æ¶ç¼©æ æ¥çå¨çææèç¹ï¼åªæ¾ç¤ºæ ¹èç¹ã collapseToLevel(Object, int) 以æå®å素为根ï¼æ¶ç¼©å°æå®å±æ¬¡ã expandAll() ä»æ ¹èç¹å¼å§ï¼å±å¼ææèç¹ã expandToLevel(int)å°æ¥çå¨å±å¼å°æå®å±æ¬¡ã expandToLevel(Object, int) å±å¼æå®åç´ çææç¶èç¹ï¼ä½¿æå®åç´ å¯è§ã并以æå®å素为根ï¼å±å¼å°æå®å±æ¬¡ã getExpandedElements() è¿åæ¥çå¨ä¸­å±å¼èç¹å¯¹åºåç´ çå表ï¼åæ¬é£äºè¢«æ è®°ä¸ºå±å¼ç¶æ,ä½æ¯å ä¸ºç¶èç¹æ¯æ¶ç¼©çï¼æ以å½åéèçåç´ ã getExpandedState(Object) è¿åæå®å素对åºçèç¹æ¯å±å¼è¿æ¯æ¶ç¼©ç¶æã Tree getTree() è¿åæ æ¥çå¨çæ æ§ä»¶ã getVisibleExpandedElements() è·åç¨æ·å¯è§çå±å¼åç´ ã isExpandable(Object) è¿åæå®å素对åºçèç¹æ¯å¦å¯ä»¥è¢«å±å¼ã remove(Object) ä»æ¥çå¨ä¸­å é¤æå®åç´ ã remove(Object[])ä»æ¥çå¨ä¸­å é¤æå®åç´ ã reveal(Object) æ»å¨æ¥çå¨ï¼ç¡®ä¿æå®å素被æ¾ç¤ºã scrollDown(int, int) Scrolls the viewer's control down by one item from the given display-relative coordinates. scrollUp(int, int) Scrolls the viewer's control up by one item from the given display-relative coordinates. setAutoExpandLevel(int) 设置èªå¨å±å¼å±æ¬¡çº§å«ã setContentProvider(IContentProvider) AbstractTreeViewerå®ç°è¯¥æ¹æ³ï¼ç¡®ä¿è¾å¥çå容æ¥çå¨ä¸º ITreeContentProviderã setExpandedElements(Object[]) 设置å±å¼çèç¹ã setExpandedState(Object, boolean) 设置æå®å素对åºçèç¹ä¸ºå±å¼è¿æ¯æ¶ç¼©ã setLabelProvider(IBaseLabelProvider) æ æ¥çå¨å®ç°Viewer æ¡æ¶ç该æ¹æ³ç¡®ä¿è¾å¥çæ ç­¾æ¥çå¨ä¸ºILabelProviderã CheckboxTreeViewer å¢å äºå¦ä¸API: addCheckStateListener(ICheckStateListener) 为æ¥çå¨å¢å é中ç¶ææ¹åçå¬å¨ã getChecked(Object)è¿åæå®åç´ çé中ç¶æã getCheckedElements() è¿åæ¥çå¨çé中åç´ å表ï¼åæ¬é£äºè¢«æ è®°ä¸ºé中ç¶æ,ä½æ¯å ä¸ºç¶èç¹æ¯æ¶ç¼©çï¼æ以å½åéèçåç´ ã getGrayed(Object) è¿åæå®åç´  çæ³ç°ç¶æã getGrayedElements() è¿åæ¥çå¨çæ³ç°åç´ å表ï¼åæ¬é£äºè¢«æ è®°ä¸ºæ³ç°ç¶æ,ä½æ¯å ä¸ºç¶èç¹æ¯æ¶ç¼©çï¼æ以å½åéèçåç´ ã setChecked(Object, boolean)设置æå®åç´ çé中ç¶æã setCheckedElements(Object[]) 设置æ¥çå¨çé中åç´ ã setGrayChecked(Object, boolean) 设置æå®å素被é中并æ³ç°ï¼ç­åäºè°ç¨setGrayed å setCheckedæ¹æ³ã setGrayed(Object, boolean) 设置æå®åç´ çæ³ç°ç¶æã setGrayedElements(Object[]) 设置æå®å素为æ³ç°ç¶æã setParentsGrayed(Object, boolean) 设置æå®åç´ åå¶ç¶å素为æ³ç°ç¶æã setSubtreeChecked(Object, boolean) 设置æå®åç´ åå¶å­åç´ çé中ç¶æã ä¸é¢çç¨åºä¾å­å±ç¤ºäºææ ·æ建ä¸ä¸ªæ æ¥çå¨ã(åè§ Figure 5-10)ã import org.eclipse.jface.viewers.*; import org.eclipse.swt.*; import org.eclipse.swt.layout.*; import org.eclipse.swt.widgets.*; public class TreeViewerExample { public static void main(String[] args) { Display display = new Display(); Shell shell = new Shell(display); shell.setText("Tree Viewer Example"); shell.setBounds(100, 100, 200, 200); shell.setLayout(new FillLayout()); final TreeViewer treeViewer = new TreeViewer(shell, SWT.SINGLE); treeViewer.setLabelProvider( new PersonListLabelProvider()); treeViewer.setContentProvider( new PersonTreeContentProvider()); treeViewer.setInput(Person.example()); shell.open(); while (!shell.isDisposed()) { if (!display.readAndDispatch()) display.sleep(); } display.dispose(); } } Figure 5-10. TreeViewer æ ·ä¾ å建æ æ¥çå¨åï¼ä½¿ç¨setLabelProvider()æ¹æ³è®¾ç½®æ ç­¾ä¾ç»å¨ï¼ä½¿ç¨setContentProvider()æ¹æ³è®¾ç½®å容ä¾ç»å¨ã PersonTreeContentProvider, è¿åæ¯ä¸ªèç¹çç¶èç¹åå­èç¹ã ç¨åºå¦ä¸: import org.eclipse.jface.viewers.*; public class PersonTreeContentProvider extends ArrayContentProvider implements ITreeContentProvider { public Object[] getChildren(Object parentElement) { Person person = (Person) parentElement; return person.children; } public Object getParent(Object element) { Person person = (Person) element; return person.parent; } public boolean hasChildren(Object element) { Person person = (Person) element; return person.children.length > 0; } }