general public Image getImage(Object element)
This technique answers an SWT Image to be utilized when showing the domain item, element. In the event that domain item doesn’t have a corresponding image, it is possible to respond to null. Because images use OS resources you have to be careful to get rid of them when you’re not with them. This is achieved by caching the pictures into the label provider or the plug-in course and losing them if the audience is disposed.
Another point that is important bear in mind is that the tree viewer will measure your pictures if they’re various sizes. The image that is first using this technique could be the “standard” tree audience image size. All the pictures would be scaled up or down seriously to match how big this very first image. These plus and minus images found in the tree audience to demonstrate expanded and collapsed products will also be scaled towards the “standard” size.
A size that is safe utilize for the pictures is 16×16.
general public String getText( element that is object
The getText method answers a string that represents click now the label for the domain item, element. When there is no label when it comes to element, solution null.
public void dispose()
The dispose technique is named once the tree audience which contains the label provider is disposed. This process is frequently utilized to get rid of the cached pictures handled by the receiver.
Into the code in the above list, the tree viewerâ€™s label provider ended up being set to an example of MovingBoxLabelProvider . Letâ€™s take a good look at this course in more detail.
This technique answers the image that is correct the provided domain item, element. An ImageDescriptor is employed to load the image for the domain object that is corresponding. If a graphic have not yet been packed, the image descriptor is expected to produce the image. The getImageDescriptor (sequence) technique is shown below. This process are frequently implemented as a static technique in the plug-in course because it is a generic energy technique and makes utilization of the installURL that is plug-inâ€™s.
This dispose technique makes certain the label provider precisely gets rid of the pictures this has developed. This might be extremely important to guarantee that operating-system resources aren’t â€œleaked.â€
Establishing the Initial Input
Now the content was discussed by that weâ€™ve provider while the label provider, our company is almost finished because of the rule necessary to produce the tree audience. The main one action lacking through the instance rule is setting the initial input for the tree audience. Since it appears now, our tree viewer will not include any objects that are domain. Hereâ€™s the rule utilized setting the initial input regarding the tree audience.
Once you set the tree viewerâ€™s input, the tree audience works with the label and content providers to show the tree. Also, keep in mind our content providerâ€™s inputChanged(â€¦) technique shall be invoked whenever the tree viewerâ€™s setInput technique is named.
The getInitalInput() method merely produces our test group of domain things.
Generally in most applications, an individual selects something through the tree audience to be able to perform some particular action. You may be notified of those choices by the addition of a variety modification listener into the tree audience. Whenever a variety happens into the tree audience, it will inform every one of its selection modification audience, moving along a range occasion explaining exactly what happens to be chosen. Remember that these occasions movement within the direction that is opposite of model-generated activities we talked about early in the day.
Hereâ€™s a typical example of managing selection when you look at the tree audience.
Right here an class that is anonymous changed listener is done. The choice changed technique is implemented to produce the presently selected things in a label or to clear the label if no things are chosen. A points that are few note:
- Some casting is required because the selection changed listener method is defined in a very generic way. For instance, a tree viewerâ€™s selection is always an IStructuredSelection although the SelectionChangedEvent â€™s getSelection technique will respond to the greater amount of ISelection that is generic .
- We have been with the label providerâ€™s getText() approach to help us in transforming the domain things to a textual representation to show when you look at the label.
- The selection-changed listener will be called by the applicationâ€™s UI thread in most UI frameworks. SWT isn’t any exclusion; what this means is you need to be careful to go back from listener methods in a fashion that is timely.