This represents an object that can supply trim around a IPresentablePart. Clients can implement subclasses to provide the appearance for editor workbooks, view folders, fast views, and detached windows.
StackPresentations do not store any persistent state and cannot directly make changes to the workbench. They are given an IStackPresentationSite reference on creation, which allows them to send events and requests to the workbench. However, the workbench is free to ignore these requests. The workbench will call one of the public methods on StackPresentation when (and if) the presentation is expected to change state.
For example, if the user clicks a button that is intended to close a part, the StackPresentation will send a close request to its site, but should not assume that the part has been closed until the workbench responds with a call StackPresentation.remove.
- Since
- 3.0
Definition at line 56 of file berryStackPresentation.h.
| QSize berry::StackPresentation::ComputeMinimumSize |
( |
| ) |
|
|
virtual |
Returns the minimum size for this stack. The stack is prevented from being resized smaller than this amount, and this is used as the default size for the stack when it is minimized. Typically, this is the amount of space required to fit the minimize, close, and maximize buttons and one tab.
- Returns
- the minimum size for this stack (not null)
- Deprecated:
- replaced by computePreferredSize
Definition at line 49 of file berryStackPresentation.cpp.
Referenced by ComputePreferredSize().
| int berry::StackPresentation::ComputePreferredSize |
( |
bool |
width, |
|
|
int |
availableParallel, |
|
|
int |
availablePerpendicular, |
|
|
int |
preferredResult |
|
) |
| |
|
overridevirtual |
Returns the best size for this part, given the available width and height and the workbench's preferred size for the part. Parts can overload this to enforce a minimum size, maximum size, or a quantized set of preferred sizes. If width == true, this method computes a width in pixels. If width == false, this method computes a height. availableParallel and availablePerpendicular contain the space available, and preferredParallel contains the preferred result.
This method returns an answer that is less than or equal to availableParallel and as close to preferredParallel as possible. Return values larger than availableParallel will be truncated.
Most presentations will define a minimum size at all times, and a maximum size that only applies when maximized.
The getSizeFlags method controls how frequently this method will be called and what information will be available when it is. Any subclass that specializes this method should also specialize getSizeFlags. computePreferredSize(width, INF, someSize, 0) returns the minimum size of the control (if any). computePreferredSize(width, INF, someSize, INF) returns the maximum size of the control.
Examples:
-
To maintain a constant size of 100x300 pixels: {return width ? 100 : 300}, getSizeFlags(boolean) must return SWT.MIN | SWT.MAX
-
To grow without constraints: {return preferredResult;}, getSizeFlags(boolean) must return 0.
-
To enforce a width that is always a multiple of 100 pixels, to a minimum of 100 pixels: { if (width && preferredResult != INF) { int result = preferredResult - ((preferredResult + 50) % 100) + 50; result = Math.max(100, Math.min(result, availableParallel - (availableParallel % 100)));
return result; } return preferredResult; } In this case, getSizeFlags(boolean width) must return (width ? SWT.FILL | SWT.MIN: 0)
-
To maintain a minimum area of 100000 pixels:
{return availablePerpendicular < 100 ? 1000 : 100000 / availablePerpendicular;} getSizeFlags(boolean width) must return SWT.WRAP | SWT.MIN;
- Parameters
-
| width | indicates whether a width (=true) or a height (=false) is being computed |
| availableParallel | available space. This is a width (pixels) if width == true, and a height (pixels) if width == false. A return value larger than this will be ignored. |
| availablePerpendicular | available space perpendicular to the direction being measured or INF if unbounded (pixels). This is a height if width == true, or a height if width == false. Implementations will generally ignore this argument unless they contain wrapping widgets. Note this argument will only contain meaningful information if the part returns the SWT.WRAP flag from getSizeFlags(width) |
| preferredResult | preferred size of the control (pixels, <= availableParallel). Set to INF if unknown or unbounded. |
- Returns
- returns the preferred size of the control (pixels). This is a width if width == true or a height if width == false. Callers are responsible for rounding down the return value if it is larger than availableParallel. If availableParallel is INF, then a return value of INF is permitted, indicating that the preferred size of the control is unbounded.
- See also
- ISizeProvider::getSizeFlags(boolean)
Implements berry::ISizeProvider.
Definition at line 62 of file berryStackPresentation.cpp.
References ComputeMinimumSize(), and GetSite().
| int berry::StackPresentation::GetSizeFlags |
( |
bool |
width | ) |
|
|
overridevirtual |
Returns a bitwise combination of flags indicating how and when computePreferredSize should be used. When called with horizontal=true, this indicates the usage of computePreferredSize(true,...) for computing widths. When called with horizontal=false, this indicates the usage of computeSize(false,...) for computing heights. These flags are used for optimization. Each flag gives the part more control over its preferred size but slows down the layout algorithm. Parts should return the minimum set of flags necessary to specify their constraints.
If the return value of this function ever changes, the part must call flushLayout before the changes will take effect.
-
SWT.MAX: The part has a maximum size that will be returned by computePreferredSize(horizontal, INF, someWidth, INF)
-
SWT.MIN: The part has a minimum size that will be returned by computePreferredSize(horizontal, INF, someWidth, 0)
-
SWT.WRAP: Indicates that computePreferredSize makes use of the availablePerpendicular argument. If this flag is not specified, then the third argument to computePreferredSize will always be set to INF. The perpendicular size is expensive to compute, and it is usually only used for wrapping parts.
-
SWT.FILL: The part may not return the preferred size verbatim when computePreferredSize is is given a value between the minimum and maximum sizes. This is commonly used if the part wants to use a set of predetermined sizes instead of using the workbench-provided size. For example, computePreferredSize(horizontal, availableSpace, someWidth, preferredSize) may return the nearest predetermined size. Note that this flag should be used sparingly. It can prevent layout caching and cause the workbench layout algorithm to degrade to exponential worst-case runtime. If this flag is omitted, then computePreferredSize may be used to compute the minimum and maximum sizes, but not for anything in between.
- Parameters
-
| width | a value of true or false determines whether the return value applies when computing widths or heights respectively. That is, getSizeFlags(true) will be used when calling computePreferredSize(true,...) |
- Returns
- any bitwise combination of SWT.MAX, SWT.MIN, SWT.WRAP, and SWT.FILL
Implements berry::ISizeProvider.
Definition at line 54 of file berryStackPresentation.cpp.
References GetSite(), berry::Constants::MAX, and berry::Constants::MIN.
| virtual void berry::StackPresentation::SetState |
( |
int |
state | ) |
|
|
pure virtual |
Sets the state of the presentation. That is, notifies the presentation that is has been minimized, maximized, or restored. Note that this method is the only way that a presentation is allowed to change its state.
If a presentation wishes to minimize itself, it must call setState on its associated IStackPresentationSite. If the site chooses to respond to the state change, it will call this method at the correct time. The presentation should not call this method directly.
- Parameters
-
| state | one of the IStackPresentationSite.STATE_* constants. |
Public Member Functions inherited from berry::Object
1.8.9.1