Interface MUIElement
- All Superinterfaces:
MApplicationElement
,MLocalizable
- All Known Subinterfaces:
MApplication
,MArea
,MCompositePart
,MDialog
,MDirectMenuItem
,MDirectToolItem
,MDynamicMenuContribution
,MElementContainer<T>
,MGenericStack<T>
,MGenericTile<T>
,MGenericTrimContainer<T>
,MHandledItem
,MHandledMenuItem
,MHandledToolItem
,MItem
,MMenu
,MMenuContribution
,MMenuElement
,MMenuItem
,MMenuSeparator
,MPart
,MPartSashContainer
,MPartSashContainerElement
,MPartStack
,MPerspective
,MPerspectiveStack
,MPlaceholder
,MPopupMenu
,MStackElement
,MToolBar
,MToolBarContribution
,MToolBarElement
,MToolBarSeparator
,MToolControl
,MToolItem
,MTrimBar
,MTrimContribution
,MTrimElement
,MTrimmedWindow
,MWindow
,MWindowElement
,MWizardDialog
- All Known Implementing Classes:
ApplicationImpl
,AreaImpl
,CompositePartImpl
,DirectMenuItemImpl
,DirectToolItemImpl
,DynamicMenuContributionImpl
,ElementContainerImpl
,GenericStackImpl
,GenericTileImpl
,GenericTrimContainerImpl
,HandledItemImpl
,HandledMenuItemImpl
,HandledToolItemImpl
,ItemImpl
,MenuContributionImpl
,MenuElementImpl
,MenuImpl
,MenuItemImpl
,MenuSeparatorImpl
,PartImpl
,PartSashContainerImpl
,PartStackImpl
,PerspectiveImpl
,PerspectiveStackImpl
,PlaceholderImpl
,PopupMenuImpl
,ToolBarContributionImpl
,ToolBarElementImpl
,ToolBarImpl
,ToolBarSeparatorImpl
,ToolControlImpl
,ToolItemImpl
,TrimBarImpl
,TrimContributionImpl
,TrimmedWindowImpl
,UIElementImpl
,WindowImpl
This is the base mix-in shared by all model elements that can be rendered into the UI presentation of the application. Its main job is to manage the bindings between the concrete element and the UI 'widget' representing it in the UI.
- Since:
- 1.0
- Restriction:
- This interface is not intended to be implemented by clients.
The following features are supported:
-
Method Summary
Modifier and TypeMethodDescriptionReturns the value of the 'Accessibility Phrase' attribute.Returns the value of the 'Container Data' attribute.Returns the value of the 'Cur Shared Ref' reference.Returns the value of the 'Localized Accessibility Phrase' attribute.Returns the value of the 'Parent' container reference.Returns the value of the 'Renderer' attribute.Returns the value of the 'Visible When' containment reference.Returns the value of the 'Widget' attribute.boolean
isOnTop()
Returns the value of the 'On Top' attribute.boolean
Returns the value of the 'To Be Rendered' attribute.boolean
Returns the value of the 'Visible' attribute.void
setAccessibilityPhrase
(String value) Sets the value of the 'Accessibility Phrase
' attribute.void
setContainerData
(String value) Sets the value of the 'Container Data
' attribute.void
setCurSharedRef
(MPlaceholder value) Sets the value of the 'Cur Shared Ref
' reference.void
setOnTop
(boolean value) Sets the value of the 'On Top
' attribute.void
setParent
(MElementContainer<MUIElement> value) Sets the value of the 'Parent
' container reference.void
setRenderer
(Object value) Sets the value of the 'Renderer
' attribute.void
setToBeRendered
(boolean value) Sets the value of the 'To Be Rendered
' attribute.void
setVisible
(boolean value) Sets the value of the 'Visible
' attribute.void
setVisibleWhen
(MExpression value) Sets the value of the 'Visible When
' containment reference.void
Sets the value of the 'Widget
' attribute.Methods inherited from interface org.eclipse.e4.ui.model.application.MApplicationElement
getContributorURI, getElementId, getPersistedState, getTags, getTransientData, setContributorURI, setElementId
Methods inherited from interface org.eclipse.e4.ui.model.application.ui.MLocalizable
updateLocalization
-
Method Details
-
getWidget
Object getWidget()Returns the value of the 'Widget' attribute.This field represents the platform specific UI 'widget' that is representing this UIElement on the screen. It will only be non-null when the element has been rendered.
- Returns:
- the value of the 'Widget' attribute.
- See Also:
-
setWidget
Sets the value of the 'Widget
' attribute.- Parameters:
value
- the new value of the 'Widget' attribute.- See Also:
-
getRenderer
Object getRenderer()Returns the value of the 'Renderer' attribute.This field tracks the specific renderer used to create the 'widget'.
- Returns:
- the value of the 'Renderer' attribute.
- See Also:
-
setRenderer
Sets the value of the 'Renderer
' attribute.- Parameters:
value
- the new value of the 'Renderer' attribute.- See Also:
-
isToBeRendered
boolean isToBeRendered()Returns the value of the 'To Be Rendered' attribute. The default value is"true"
.This field controls whether the given UIElement should be displayed within the application. Note that due to lazy loading it is possible to have this field set to true but to not have actually rendered the element itself (it does show up as a tab on the appropiate stack but will only be rendered when that tab is selected.
- Returns:
- the value of the 'To Be Rendered' attribute.
- See Also:
-
setToBeRendered
void setToBeRendered(boolean value) Sets the value of the 'To Be Rendered
' attribute.- Parameters:
value
- the new value of the 'To Be Rendered' attribute.- See Also:
-
isOnTop
boolean isOnTop()Returns the value of the 'On Top' attribute.Developers: Add more detailed documentation by editing this comment in org.eclipse.ui.model.workbench/model/UIElements.ecore. There is a GenModel/documentation node under each type and attribute.
- Returns:
- the value of the 'On Top' attribute.
- See Also:
-
setOnTop
void setOnTop(boolean value) Sets the value of the 'On Top
' attribute.- Parameters:
value
- the new value of the 'On Top' attribute.- See Also:
-
isVisible
boolean isVisible()Returns the value of the 'Visible' attribute. The default value is"true"
.This field determines whether or not the given UIElement appears in the presentation or whether it should be 'cached' for specialized use. Under normal circumstances this flag should always be 'true'.
The MinMaxAddon uses this flag for example when a stack becomes minimized. By setting the flag to false the stack's widget is cleanly removed from the UI but is still 'rendered'. Once the widget has been cached the minimized stack can then display the widget using its own technques.
- Returns:
- the value of the 'Visible' attribute.
- See Also:
-
setVisible
void setVisible(boolean value) Sets the value of the 'Visible
' attribute.- Parameters:
value
- the new value of the 'Visible' attribute.- See Also:
-
getParent
MElementContainer<MUIElement> getParent()Returns the value of the 'Parent' container reference. It is bidirectional and its opposite is 'Children
'.This field is a reference to this element's container. Note that while this field is valid for most UIElements there are a few (such as TrimBars and the Windows associated with top level windows and perspectives) where this will return 'null'
- Returns:
- the value of the 'Parent' container reference.
- See Also:
-
setParent
Sets the value of the 'Parent
' container reference.- Parameters:
value
- the new value of the 'Parent' container reference.- See Also:
-
getContainerData
String getContainerData()Returns the value of the 'Container Data' attribute.This is a persistend field that may be used by the parent element's renderer to maintain any data that it needs to control the container. For example this is where the SashRenderer stores the 'weight' of a particular element.
NOTE: This field is effectively deprecated in favor of the parent renderer simply adding a new keyed value to the UIElement's 'persistentData' map.
- Returns:
- the value of the 'Container Data' attribute.
- See Also:
-
setContainerData
Sets the value of the 'Container Data
' attribute.- Parameters:
value
- the new value of the 'Container Data' attribute.- See Also:
-
getVisibleWhen
MExpression getVisibleWhen()Returns the value of the 'Visible When' containment reference.Developers: Add more detailed documentation by editing this comment in org.eclipse.ui.model.workbench/model/UIElements.ecore. There is a GenModel/documentation node under each type and attribute.
- Returns:
- the value of the 'Visible When' containment reference.
- See Also:
-
setVisibleWhen
Sets the value of the 'Visible When
' containment reference.- Parameters:
value
- the new value of the 'Visible When' containment reference.- See Also:
-
getAccessibilityPhrase
String getAccessibilityPhrase()Returns the value of the 'Accessibility Phrase' attribute.This field is provided as a way to inform accessibility screen readers with extra information. The intent is that the reader should 'say' this phrase as well as what it would normally emit given the widget hierarchy.
- Returns:
- the value of the 'Accessibility Phrase' attribute.
- See Also:
-
setAccessibilityPhrase
Sets the value of the 'Accessibility Phrase
' attribute.- Parameters:
value
- the new value of the 'Accessibility Phrase' attribute.- See Also:
-
getLocalizedAccessibilityPhrase
String getLocalizedAccessibilityPhrase()Returns the value of the 'Localized Accessibility Phrase' attribute.- Returns:
- the value of the 'Localized Accessibility Phrase' attribute.
-