public interface ISection
The lifecycle of an ISection is as follows:
ISection.createControls()
ISection.setInput()
ISection.aboutToBeShown()
ISection.refresh()
ISection.aboutToBeHidden()
ISection.dispose()
Implementors of this class should be aware that a section instance might be
reused for different input objects (as long as they are valid section
inputs). It means that ISection.setInput
can be called at any
time between ISection.createControls
and
ISection.dispose
.
When an input change event occurs, such as a tab selection or a workbench selection change, an ISection is sent:
ISection.setInput()
ISection.refresh()
When an part activation event occurs, such as the contributor part activation event, an ISection is sent:
ISection.setInput()
ISection.aboutToBeShown()
ISection.refresh()
ISection.setInput()
ISection.refresh()
This interface should not be extended or implemented. New section instances
should be created using AbstractPropertySection
.
TabbedPropertySheetPage
Modifier and Type | Method and Description |
---|---|
void |
aboutToBeHidden()
Notifies the section that its controls are about to be hidden.
|
void |
aboutToBeShown()
Notifies the section that its controls are about to be shown.
|
void |
createControls(Composite parent,
TabbedPropertySheetPage tabbedPropertySheetPage)
Creates the controls for the section.
|
void |
dispose()
Dispose this section.
|
int |
getMinimumHeight()
Returns the minimum height needed by this section.
|
void |
refresh()
Refresh the contents of the controls displayed in this section.
|
void |
setInput(IWorkbenchPart part,
ISelection selection)
Notifies the section that the workbench selection has changed.
|
boolean |
shouldUseExtraSpace()
Determine whether this section would like extra height space in case
there is some left.
|
void createControls(Composite parent, TabbedPropertySheetPage tabbedPropertySheetPage)
Clients should take advantage of the widget factory provided by the framework to achieve a common look between property sections.
parent
- the parent composite for the section.tabbedPropertySheetPage
- the tabbed property sheet page.TabbedPropertySheetPage.getWidgetFactory()
void setInput(IWorkbenchPart part, ISelection selection)
part
- The active workench part.selection
- The active selection in the workbench part.void aboutToBeShown()
Since the controls are not visible, the section should wait for the refresh() before updating the section controls.
void aboutToBeHidden()
void dispose()
int getMinimumHeight()
SWT.DEFAULT
indicates that no minimum height is defined.boolean shouldUseExtraSpace()
true
if this section would like extra height space.void refresh()
Copyright (c) 2000, 2014 Eclipse Contributors and others. All rights reserved.Guidelines for using Eclipse APIs.