#
Result Sorters

###### Identifier:

org.eclipse.search.searchResultSorters

###### Description:

This extension point allows a plug-in to contribute search result sorters to the search result view's Sort context menu.

###### Configuration Markup:

<!ELEMENT extension (sorter*)>

<!ATTLIST extension

point CDATA #REQUIRED

id CDATA #IMPLIED

name CDATA #IMPLIED>

- point - a fully qualified identifier of the target extension point
- id - an optional identifier of the extension instance
- name - an optional name of the extension instance

<!ELEMENT sorter EMPTY>

<!ATTLIST sorter

id CDATA #REQUIRED

pageId CDATA #REQUIRED

label CDATA #REQUIRED

tooltip CDATA #IMPLIED

icon CDATA #IMPLIED

class CDATA #REQUIRED>

- id - a unique name that will be used to identify this search result sorter.
- pageId - the ID of a registered search page for which the sorter will be activated. "*" activates the sorter for all pages.
- label - a translatable label that will be used as the menu item's label.
- tooltip - a translatable text that will be used as the menu item's tool tip . If omitted, the menu item will have no tool tip.
- icon - a relative name of the image that will be shown in the context menu along with the label. If omitted, the menu entry will only contain a label.
- class - a name of the class that extends `org.eclipse.jface.viewers.ViewerSorter`

###### Examples:

The following is an example of a search page extension definition:

       <extension point="org.eclipse.search.searchResultSorters">
        <sorter
            id="org.eclipse.search.internal.ui.FileNameSorter"
            pageId="*"
            label="%FileNameSorter.label"
            tooltip="%FilenNameSorter.tooltip"
            icon="icons/full/ecl16/search_sort.gif"
            class="org.eclipse.search.internal.ui.FileNameSorter">
        </sorter>
       </extension>

###### API Information:

The contributed class must implement `org.eclipse.jface.viewers.ViewerSorter`

###### Supplied Implementation:

The search infrastructure provides a sorter that sorts the matches by the resource name.

Copyright (c) 2001, 2004 IBM Corporation and others.
All rights reserved. This program and the accompanying materials are made available under the terms of the Common Public License v1.0 which accompanies this distribution, and is available at http://www.eclipse.org/legal/cpl-v10.html