Follow Techotopia on Twitter

On-line Guides
All Guides
eBook Store
iOS / Android
Linux for Beginners
Office Productivity
Linux Installation
Linux Security
Linux Utilities
Linux Virtualization
Linux Kernel
System/Network Admin
Programming
Scripting Languages
Development Tools
Web Development
GUI Toolkits/Desktop
Databases
Mail Systems
openSolaris
Eclipse Documentation
Techotopia.com
Virtuatopia.com

How To Guides
Virtualization
General System Admin
Linux Security
Linux Filesystems
Web Servers
Graphics & Desktop
PC Hardware
Windows
Problem Solutions
Privacy Policy

  




 

 


Eclipse Platform
Release 3.5

org.eclipse.ui.views.properties.tabbed
Interface ISection

All Known Implementing Classes:
AbstractOverridableTabListPropertySection, AbstractPropertySection, AdvancedPropertySection

public interface ISection

Represents a section of properties for a given input.

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 is because both a tab selection event and an input selection event have occurred.

This interface should not be extended or implemented. New section instances should be created using AbstractPropertySection.

See Also:
TabbedPropertySheetPage

Method Summary
 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.
 

Method Detail

createControls

void createControls(
Composite parent,
                    
TabbedPropertySheetPage tabbedPropertySheetPage)
Creates the controls for the section.

Clients should take advantage of the widget factory provided by the framework to achieve a common look between property sections.

Parameters:
parent - the parent composite for the section.
tabbedPropertySheetPage - the tabbed property sheet page.
See Also:
TabbedPropertySheetPage.getWidgetFactory()

setInput

void setInput(
IWorkbenchPart part,
              
ISelection selection)
Notifies the section that the workbench selection has changed.

Parameters:
part - The active workench part.
selection - The active selection in the workbench part.

aboutToBeShown

void aboutToBeShown()
Notifies the section that its controls are about to be shown. It is expected that sections enable domain related functions in this method, most commonly add listeners.

Since the controls are not visible, the section should wait for the refresh() before updating the section controls.


aboutToBeHidden

void aboutToBeHidden()
Notifies the section that its controls are about to be hidden. It is expected that sections disable domain related functions in this method, most commonly remove listeners.


dispose

void dispose()
Dispose this section.


getMinimumHeight

int getMinimumHeight()
Returns the minimum height needed by this section. A return value of SWT.DEFAULT indicates that no minimum height is defined.

Returns:
the minimum height needed by this section.

shouldUseExtraSpace

boolean shouldUseExtraSpace()
Determine whether this section would like extra height space in case there is some left. Normally this is true when the section is the last to be displayed on a tab or is the only section on a tab.

Returns:
true if this section would like extra height space.

refresh

void refresh()
Refresh the contents of the controls displayed in this section.


Eclipse Platform
Release 3.5

Guidelines for using Eclipse APIs.

Copyright (c) Eclipse contributors and others 2000, 2008. All rights reserved.


 
 
  Published under the terms of the Eclipse Public License Version 1.0 ("EPL") Design by Interspire