Package org.eclipse.search.ui

Interface ISearchResultPage

  • All Superinterfaces:
    IPage, IPageBookViewPage
    All Known Implementing Classes:
    AbstractTextSearchViewPage
    public interface ISearchResultPage
extends IPageBookViewPage
    Interface to be implemented by contributors to the extension point org.eclipse.search.searchResultViewPages. A ISearchResultPage is used to show the search results for a particular class of ISearchResult (as specified in the searchResultClass attribute of the extension point) in the search result view.

    Clients may implement this interface.

    Since:
    3.0

    • Method Detail

      • getUIState

        Object getUIState()
        Returns an object representing the current user interface state of the page. For example, the current selection in a viewer. The UI state will be later passed into the setInput() method when the currently shown ISearchResult is shown again.
        Returns:
        an object representing the UI state of this page

      • setInput

        void setInput​(ISearchResult search,
              Object uiState)
        Sets the search result to be shown in this search results page. Implementers should restore UI state (e.g. selection) from the previously saved uiState object.
        Parameters:
        search - the search result to be shown or null to clear the page.
        uiState - the previously saved UI state
        See Also:
        getUIState()

      • setViewPart

        void setViewPart​(ISearchResultViewPart part)
        Sets the search view this search results page is shown in. This method will be called before the page is shown for the first time (i.e. before the page control is created).
        Parameters:
        part - the parent search view

      • restoreState

        void restoreState​(IMemento memento)
        Restores the page state. Note that this applies only to state that is saved across sessions.
        Parameters:
        memento - a memento to restore the page state from or null if no previous state was saved
        See Also:
        setInput(ISearchResult, Object)

      • saveState

        void saveState​(IMemento memento)
        Saves the page state in a memento. Note that this applies to state that should persist across sessions.
        Parameters:
        memento - a memento to receive the object state
        See Also:
        getUIState()

      • setID

        void setID​(String id)
        Sets the id for this page. This method will be called before any other initialization is done.
        Parameters:
        id - the id for this page

      • getID

        String getID()
        Returns the id set via setID.
        Returns:
        the id of this page

      • getLabel

        String getLabel()
        Returns a user readable label for this search result page. The label will be used to describe the contents for the page to the user (for example it will be displayed in the search view title bar). To take an example from file search, a label might read like this: 'test' - 896 matches in workspace.
        Returns:
        the user readable label for this search result page