(incubating) | The Free and Open Productivity Suite
Announcing Apache OpenOffice 3.4

Developer's Guide

API

SDK

Tips 'n' Tricks

Miscellaneous

Content for OpenOffice.org version 3.3.

:: com :: sun :: star :: view ::

unpublished interface XMultiSelectionSupplier
Base Interfaces
XMultiSelectionSupplierXSelectionSupplier

XSelectionSupplier
(referenced interface's summary:)
makes it possible to access and change the selection in a view.
Usage Restrictions
not published
Description
makes it possible to append and remove objects from a selection.

The method XSelectionSupplier::setSelection for an instance that also supports should be implemented that it also takes either a selectable object or a sequence of selectable objects.

Adding an object more than once to a selection should not toggle the selection for that object but only select it once


Methods' Summary
addSelection adds the object or the objects represented by Selection to the selection of this XMultiSelectionSupplier.  
removeSelection remove the object or objects represented by Selection from the selection of this XMultiSelectionSupplier.  
clearSelection clears the selection of this XMultiSelectionSupplier.  
getSelectionCount returns the number of selected objects of this XMultiSelectionSupplier.  
createSelectionEnumeration  
createReverseSelectionEnumeration  
Methods' Details
addSelection
boolean
addSelection( [in] any  Selection )
raises( ::com::sun::star::lang::IllegalArgumentException );

Description
adds the object or the objects represented by Selection to the selection of this XMultiSelectionSupplier.
Parameter Selection
either an Object that is selectable or a sequence of objects that are selectable.
Returns
true/, if Selection was added to the current selection. false, if Selection or parts of Selection could not be added to the current selection. For example, if the selection already contains objects that are forbidden to be selected together with Selection @raises com::sun::star::lang::IllegalArgumentException If Selection is not a selectable object for this XMultiSelectionSupplier.

Adding an object to the selection that is already part of the selection should not raise this exception

removeSelection
void
removeSelection( [in] any  Selection )
raises( ::com::sun::star::lang::IllegalArgumentException );

Description
remove the object or objects represented by Selection from the selection of this XMultiSelectionSupplier.
Parameter Selection
either an Object that is selectable or a sequence of objects that are selectable.
Returns
true/, if Selection was added to the current selection. false, if Selection or parts of Selection could not be added to the current selection. For example, if the selection already contains objects that are forbidden to be selected together with Selection. @raises com::sun::star::lang::IllegalArgumentException If Selection is not a selectable object for this XMultiSelectionSupplier.

Removing an object from the selection that is not part of the selection should not raise this exception

clearSelection
void
clearSelection();

Description
clears the selection of this XMultiSelectionSupplier.
getSelectionCount
long
getSelectionCount();

Description
returns the number of selected objects of this XMultiSelectionSupplier.
createSelectionEnumeration
::com::sun::star::container::XEnumeration
createSelectionEnumeration();

Returns
a new object to enumerate the selection of this XMultiSelectionSupplier. It returns NULL if there are no objects in the selection.
createReverseSelectionEnumeration
::com::sun::star::container::XEnumeration
createReverseSelectionEnumeration();

Returns
a new object to enumerate the selection of this XMultiSelectionSupplier in reverse order. If the order of the selected objects It returns NULL if there are no objects in the selection.
Top of Page

Apache Feather

Copyright & License | Privacy | Contact Us

Apache and the Apache feather logos are trademarks of The Apache Software Foundation. OpenOffice.org and the seagull logo are registered trademarks of The Apache Software Foundation. Other names appearing on the site may be trademarks of their respective owners.

Apache OpenOffice is an effort undergoing incubation at The Apache Software Foundation (ASF), sponsored by the Apache Incubator. Incubation is required of all newly accepted projects until a further review indicates that the infrastructure, communications, and decision making process have stabilized in a manner consistent with other successful ASF projects. While incubation status is not necessarily a reflection of the completeness or stability of the code, it does indicate that the project has yet to be fully endorsed by the ASF.