Class SWTObservables


  • @Deprecated
    public class SWTObservables
    extends Object
    Deprecated.
    A factory for creating observables for SWT widgets
    Since:
    1.1
    • Constructor Detail

      • SWTObservables

        public SWTObservables()
        Deprecated.
    • Method Detail

      • getRealm

        @Deprecated
        public static Realm getRealm​(Display display)
        Deprecated.
        please use DisplayRealm.getRealm(Display) instead.
        Returns the realm representing the UI thread for the given display.
        Parameters:
        display -
        Returns:
        the realm representing the UI thread for the given display
      • observeDelayedValue

        @Deprecated
        public static ISWTObservableValue observeDelayedValue​(int delay,
                                                              ISWTObservableValue observable)
        Deprecated.
        use WidgetProperties instead
        Returns an observable which delays notification of value change events from observable until delay milliseconds have elapsed since the last change event, or until a FocusOut event is received from the underlying widget (whichever happens first). This observable helps to boost performance in situations where an observable has computationally expensive listeners (e.g. changing filters in a viewer) or many dependencies (master fields with multiple detail fields). A common use of this observable is to delay validation of user input until the user stops typing in a UI field.

        To notify about pending changes, the returned observable fires a stale event when the wrapped observable value fires a change event, and remains stale until the delay has elapsed and the value change is fired. A call to getValue() while a value change is pending will fire the value change immediately, short-circuiting the delay.

        Note that this observable will not forward ValueChangingEvent events from a wrapped IVetoableValue.

        Parameters:
        delay - the delay in milliseconds
        observable - the observable being delayed
        Returns:
        an observable which delays notification of value change events from observable until delay milliseconds have elapsed since the last change event.
        Since:
        1.2
      • observeEnabled

        @Deprecated
        public static ISWTObservableValue observeEnabled​(Widget widget)
        Deprecated.
        use WidgetProperties instead
        Returns an observable value tracking the enabled state of the given widget. The supported types are:
        • org.eclipse.swt.widgets.Control
        • org.eclipse.swt.widgets.Menu
        • org.eclipse.swt.widgets.MenuItem
        • org.eclipse.swt.widgets.ScrollBar
        • org.eclipse.swt.widgets.ToolItem
        Parameters:
        widget -
        Returns:
        an observable value tracking the enabled state of the given widget.
        Since:
        1.5
      • observeEnabled

        @Deprecated
        public static ISWTObservableValue observeEnabled​(Control control)
        Deprecated.
        use WidgetProperties instead
        Returns an observable value tracking the enabled state of the given control
        Parameters:
        control - the control to observe
        Returns:
        an observable value tracking the enabled state of the given control
      • observeVisible

        @Deprecated
        public static ISWTObservableValue observeVisible​(Control control)
        Deprecated.
        use WidgetProperties instead
        Returns an observable value tracking the visible state of the given control
        Parameters:
        control - the control to observe
        Returns:
        an observable value tracking the visible state of the given control
      • observeTooltipText

        @Deprecated
        public static ISWTObservableValue observeTooltipText​(Widget widget)
        Deprecated.
        use WidgetProperties instead
        Returns an observable tracking the tooltip text of the given item. The supported types are:
        • org.eclipse.swt.widgets.Control
        • org.eclipse.swt.custom.CTabItem
        • org.eclipse.swt.widgets.TabItem
        • org.eclipse.swt.widgets.TableColumn
        • org.eclipse.swt.widgets.ToolItem
        • org.eclipse.swt.widgets.TrayItem
        • org.eclipse.swt.widgets.TreeColumn
        Parameters:
        widget -
        Returns:
        an observable value tracking the tooltip text of the given item
        Since:
        1.3
      • observeTooltipText

        @Deprecated
        public static ISWTObservableValue observeTooltipText​(Control control)
        Deprecated.
        use WidgetProperties instead
        Returns an observable value tracking the tooltip text of the given control
        Parameters:
        control - the control to observe
        Returns:
        an observable value tracking the tooltip text of the given control
      • observeSelection

        @Deprecated
        public static ISWTObservableValue observeSelection​(Widget widget)
        Deprecated.
        use WidgetProperties instead
        Returns an observable observing the selection attribute of the provided control. The supported types are:
        • org.eclipse.swt.widgets.Spinner
        • org.eclipse.swt.widgets.Button
        • org.eclipse.swt.widgets.Combo
        • org.eclipse.swt.custom.CCombo
        • org.eclipse.swt.widgets.List
        • org.eclipse.swt.widgets.MenuItem (since 1.5)
        • org.eclipse.swt.widgets.Scale
        Parameters:
        widget -
        Returns:
        observable value
        Throws:
        IllegalArgumentException - if control type is unsupported
        Since:
        1.5
      • observeSelection

        @Deprecated
        public static ISWTObservableValue observeSelection​(Control control)
        Deprecated.
        use WidgetProperties instead
        Returns an observable observing the selection attribute of the provided control. The supported types are:
        • org.eclipse.swt.widgets.Button
        • org.eclipse.swt.widgets.Combo
        • org.eclipse.swt.custom.CCombo
        • org.eclipse.swt.widgets.List
        • org.eclipse.swt.widgets.Scale
        • org.eclipse.swt.widgets.Slider (since 1.5)
        • org.eclipse.swt.widgets.Spinner
        Parameters:
        control -
        Returns:
        observable value
        Throws:
        IllegalArgumentException - if control type is unsupported
      • observeMin

        @Deprecated
        public static ISWTObservableValue observeMin​(Control control)
        Deprecated.
        use WidgetProperties instead
        Returns an observable observing the minimum attribute of the provided control. The supported types are:
        • org.eclipse.swt.widgets.Spinner
        • org.eclipse.swt.widgets.Slider (since 1.5)
        • org.eclipse.swt.widgets.Scale
        Parameters:
        control -
        Returns:
        observable value
        Throws:
        IllegalArgumentException - if control type is unsupported
      • observeMax

        @Deprecated
        public static ISWTObservableValue observeMax​(Control control)
        Deprecated.
        use WidgetProperties instead
        Returns an observable observing the maximum attribute of the provided control. The supported types are:
        • org.eclipse.swt.widgets.Spinner
        • org.eclipse.swt.widgets.Slider (since 1.5)
        • org.eclipse.swt.widgets.Scale
        Parameters:
        control -
        Returns:
        observable value
        Throws:
        IllegalArgumentException - if control type is unsupported
      • observeText

        @Deprecated
        public static ISWTObservableValue observeText​(Control control,
                                                      int[] events)
        Deprecated.
        use WidgetProperties instead
        Returns an observable observing the text attribute of the provided control. The supported types are:
        • org.eclipse.swt.widgets.Text
        • org.eclipse.swt.custom.StyledText (as of 1.3)
        Parameters:
        control -
        events - array of SWT event types to register for change events. May include SWT.None, SWT.Modify, SWT.FocusOut or SWT.DefaultSelection.
        Returns:
        observable value
        Throws:
        IllegalArgumentException - if control type is unsupported
        Since:
        1.3
      • observeText

        @Deprecated
        public static ISWTObservableValue observeText​(Control control,
                                                      int event)
        Deprecated.
        use WidgetProperties instead
        Returns an observable observing the text attribute of the provided control. The supported types are:
        • org.eclipse.swt.widgets.Text
        • org.eclipse.swt.custom.StyledText (as of 1.3)
        Parameters:
        control -
        event - event type to register for change events
        Returns:
        observable value
        Throws:
        IllegalArgumentException - if control type is unsupported
      • observeText

        @Deprecated
        public static ISWTObservableValue observeText​(Widget widget)
        Deprecated.
        use WidgetProperties instead
        Returns an observable observing the text attribute of the provided widget. The supported types are:
        • org.eclipse.swt.widgets.Button (as of 1.3)
        • org.eclipse.swt.custom.CCombo
        • org.eclipse.swt.custom.CLabel
        • org.eclipse.swt.widgets.Combo
        • org.eclipse.swt.widgets.Group (as of 1.7)
        • org.eclipse.swt.widgets.Item
        • org.eclipse.swt.widgets.Label
        • org.eclipse.swt.widgets.Link (as of 1.2)
        • org.eclipse.swt.widgets.Shell
        • org.eclipse.swt.widgets.StyledText (as of 1.3)
        • org.eclipse.swt.widgets.Text (as of 1.3)
        Parameters:
        widget -
        Returns:
        observable value
        Throws:
        IllegalArgumentException - if the type of widget is unsupported
        Since:
        1.3
      • observeText

        @Deprecated
        public static ISWTObservableValue observeText​(Control control)
        Deprecated.
        use WidgetProperties instead
        Returns an observable observing the text attribute of the provided control. The supported types are:
        • org.eclipse.swt.widgets.Button (as of 1.3)
        • org.eclipse.swt.custom.CCombo
        • org.eclipse.swt.custom.CLabel
        • org.eclipse.swt.widgets.Combo
        • org.eclipse.swt.widgets.Group (as of 1.7)
        • org.eclipse.swt.widgets.Label
        • org.eclipse.swt.widgets.Link (as of 1.2)
        • org.eclipse.swt.widgets.Shell
        • org.eclipse.swt.custom.StyledText (as of 1.3)
        • org.eclipse.swt.widgets.Text (as of 1.3)
        Parameters:
        control -
        Returns:
        observable value
        Throws:
        IllegalArgumentException - if control type is unsupported
      • observeMessage

        @Deprecated
        public static ISWTObservableValue observeMessage​(Widget widget)
        Deprecated.
        use WidgetProperties instead
        Returns an observable observing the message attribute of the provided widget. the supported types are:
        • org.eclipse.swt.widgets.Text
        • org.eclipse.swt.widgets.ToolTip
        Parameters:
        widget -
        Returns:
        an observable observing the message attribute of the provided widget.
        Since:
        1.3
      • observeImage

        @Deprecated
        public static ISWTObservableValue observeImage​(Widget widget)
        Deprecated.
        use WidgetProperties instead
        Returns an observable observing the image attribute of the provided widget. The supported types are:
        • org.eclipse.swt.widgets.Button
        • org.eclipse.swt.custom.CLabel
        • org.eclipse.swt.widgets.Item
        • org.eclipse.swt.widgets.Label
        Parameters:
        widget -
        Returns:
        observable value
        Throws:
        IllegalArgumentException - if widget type is unsupported
        Since:
        1.3
      • observeItems

        @Deprecated
        public static IObservableList observeItems​(Control control)
        Deprecated.
        use WidgetProperties instead
        Returns an observable observing the items attribute of the provided control. The supported types are:
        • org.eclipse.swt.widgets.Combo
        • org.eclipse.swt.custom.CCombo
        • org.eclipse.swt.widgets.List
        Parameters:
        control -
        Returns:
        observable list
        Throws:
        IllegalArgumentException - if control type is unsupported
      • observeSingleSelectionIndex

        @Deprecated
        public static ISWTObservableValue observeSingleSelectionIndex​(Control control)
        Deprecated.
        use WidgetProperties instead
        Returns an observable observing the single selection index attribute of the provided control. The supported types are:
        • org.eclipse.swt.widgets.Table
        • org.eclipse.swt.widgets.Combo
        • org.eclipse.swt.custom.CCombo
        • org.eclipse.swt.widgets.List
        Parameters:
        control -
        Returns:
        observable value
        Throws:
        IllegalArgumentException - if control type is unsupported
      • observeForeground

        @Deprecated
        public static ISWTObservableValue observeForeground​(Control control)
        Deprecated.
        use WidgetProperties instead
        Returns an observable value tracking the foreground color of the given control
        Parameters:
        control - the control to observe
        Returns:
        an observable value tracking the foreground color of the given control
      • observeBackground

        @Deprecated
        public static ISWTObservableValue observeBackground​(Control control)
        Deprecated.
        use WidgetProperties instead
        Returns an observable value tracking the background color of the given control
        Parameters:
        control - the control to observe
        Returns:
        an observable value tracking the background color of the given control
      • observeFont

        @Deprecated
        public static ISWTObservableValue observeFont​(Control control)
        Deprecated.
        use WidgetProperties instead
        Returns an observable value tracking the font of the given control.
        Parameters:
        control - the control to observe
        Returns:
        an observable value tracking the font of the given control
      • observeSize

        @Deprecated
        public static ISWTObservableValue observeSize​(Control control)
        Deprecated.
        use WidgetProperties instead
        Returns an observable value tracking the size of the given control.
        Parameters:
        control - the control to observe
        Returns:
        an observable value tracking the size of the given control
        Since:
        1.3
      • observeLocation

        public static ISWTObservableValue observeLocation​(Control control)
        Deprecated.
        Returns an observable value tracking the location of the given control.
        Parameters:
        control - the control to observe
        Returns:
        an observable value tracking the location of the given control
        Since:
        1.3
      • observeFocus

        @Deprecated
        public static ISWTObservableValue observeFocus​(Control control)
        Deprecated.
        use WidgetProperties instead
        Returns an observable value tracking the focus of the given control.
        Parameters:
        control - the control to observe
        Returns:
        an observable value tracking the focus of the given control
        Since:
        1.3
      • observeBounds

        @Deprecated
        public static ISWTObservableValue observeBounds​(Control control)
        Deprecated.
        use WidgetProperties instead
        Returns an observable value tracking the bounds of the given control.
        Parameters:
        control - the control to observe
        Returns:
        an observable value tracking the bounds of the given control
        Since:
        1.3
      • observeEditable

        @Deprecated
        public static ISWTObservableValue observeEditable​(Control control)
        Deprecated.
        use WidgetProperties instead
        Returns an observable observing the editable attribute of the provided control. The supported types are:
        • org.eclipse.swt.custom.CCombo (since 1.6)
        • org.eclipse.swt.custom.StyledText (since 1.6)
        • org.eclipse.swt.widgets.Text
        Parameters:
        control -
        Returns:
        observable value
        Throws:
        IllegalArgumentException - if control type is unsupported