diff options
Diffstat (limited to 'offapi/com/sun/star/util/XSortable.idl')
-rw-r--r-- | offapi/com/sun/star/util/XSortable.idl | 90 |
1 files changed, 90 insertions, 0 deletions
diff --git a/offapi/com/sun/star/util/XSortable.idl b/offapi/com/sun/star/util/XSortable.idl new file mode 100644 index 0000000000..5200dafcf3 --- /dev/null +++ b/offapi/com/sun/star/util/XSortable.idl @@ -0,0 +1,90 @@ +/* -*- Mode: C++; tab-width: 4; indent-tabs-mode: nil; c-basic-offset: 4 -*- */ +/* + * This file is part of the LibreOffice project. + * + * This Source Code Form is subject to the terms of the Mozilla Public + * License, v. 2.0. If a copy of the MPL was not distributed with this + * file, You can obtain one at http://mozilla.org/MPL/2.0/. + * + * This file incorporates work covered by the following license notice: + * + * Licensed to the Apache Software Foundation (ASF) under one or more + * contributor license agreements. See the NOTICE file distributed + * with this work for additional information regarding copyright + * ownership. The ASF licenses this file to you under the Apache + * License, Version 2.0 (the "License"); you may not use this file + * except in compliance with the License. You may obtain a copy of + * the License at http://www.apache.org/licenses/LICENSE-2.0 . + */ + + + +module com { module sun { module star { module util { + + +/** makes it possible to sort the contents of this object. + + <p>The available properties describing the sort criteria are + defined in the sort descriptor implemented by the object that + implements this interface.</p> + + <p>There are older deprecated sort descriptors:</p> + <ul> + <li>com::sun::star::util::SortDescriptor</li> + <li>com::sun::star::table::TableSortDescriptor</li> + <li>com::sun::star::text::TextSortDescriptor</li> + </ul> + + <p>And a new set of sort descriptors:</p> + <ul> + <li>com::sun::star::util::SortDescriptor2</li> + <li>com::sun::star::table::TableSortDescriptor2</li> + <li>com::sun::star::text::TextSortDescriptor2</li> + </ul> + + <p>Both types may be implemented by the same object. + When calling the sort method however properties from different + descriptors must not be mixed.</p> + */ +published interface XSortable: com::sun::star::uno::XInterface +{ + /** @returns + a sequence of properties which allows to specify/modify the + sort criteria. + + <p>The set of properties is specific to the type of object that + implements this interface. Therefore they can usually be used + only for objects of that same type.</p> + + @see com::sun::star::util::SortDescriptor + @see com::sun::star::table::TableSortDescriptor + @see com::sun::star::text::TextSortDescriptor + @see com::sun::star::util::SortDescriptor2 + @see com::sun::star::table::TableSortDescriptor2 + @see com::sun::star::text::TextSortDescriptor2 + + */ + sequence< com::sun::star::beans::PropertyValue > createSortDescriptor(); + + /** sorts the contents of the object according to the specified + properties. + + <p>The specified properties are usually the same or a subset of + those obtained by calling createSortDescriptor() + on the same type of object.<p> + + @see com::sun::star::util::SortDescriptor + @see com::sun::star::table::TableSortDescriptor + @see com::sun::star::text::TextSortDescriptor + @see com::sun::star::util::SortDescriptor2 + @see com::sun::star::table::TableSortDescriptor2 + @see com::sun::star::text::TextSortDescriptor2 + */ + void sort( [in] sequence< com::sun::star::beans::PropertyValue > xDescriptor ); + +}; + + +}; }; }; }; + +/* vim:set shiftwidth=4 softtabstop=4 expandtab: */ |