String.java, [...]: Merge from GNU Classpath HEAD.
2006-06-09 Thomas Fitzsimmons <fitzsim@redhat.com> * java/lang/String.java, classpath/native/jni/classpath/jcl.h, classpath/native/jni/qt-peer/eventmethods.h, classpath/native/jni/qt-peer/qtmenupeer.cpp, classpath/native/jni/qt-peer/.cvsignore, classpath/native/jni/gtk-peer/gdkdisplay.h, classpath/native/jni/gtk-peer/cairographics2d.h, classpath/native/jni/gtk-peer/gnu_java_awt_peer_gtk_CairoGraphics2D.c, classpath/native/jni/gtk-peer/gnu_java_awt_peer_gtk_GdkFontPeer.c, classpath/native/jni/gtk-peer/gnu_java_awt_peer_gtk_FreetypeGlyphVector.c, classpath/native/jni/gtk-peer/gnu_java_awt_peer_gtk_GdkGraphicsEnvironment.c, classpath/native/jni/gtk-peer/gnu_java_awt_peer_gtk_ComponentGraphicsCopy.c, classpath/native/jni/gtk-peer/gnu_java_awt_peer_gtk_ComponentGraphics.c, classpath/native/jni/gtk-peer/.cvsignore, classpath/native/jni/gtk-peer/gnu_java_awt_peer_gtk_GtkImage.c, classpath/native/jni/gtk-peer/gnu_java_awt_peer_gtk_GtkVolatileImage.c, classpath/native/jni/gtk-peer/gnu_java_awt_peer_gtk_GtkToolkit.c, classpath/native/jni/gtk-peer/gnu_java_awt_peer_gtk_GtkCanvasPeer.c, classpath/native/jni/gtk-peer/gtkpeer.h, classpath/native/jni/gtk-peer/gnu_java_awt_peer_gtk_GtkClipboard.c, classpath/native/jni/gtk-peer/gnu_java_awt_peer_gtk_CairoSurface.c, classpath/native/jni/gtk-peer/gnu_java_awt_peer_gtk_GdkScreenGraphicsDevice.c, classpath/native/jni/gtk-peer/gnu_java_awt_peer_gtk_GdkTextLayout.c, classpath/native/jni/gtk-peer/gnu_java_awt_peer_gtk_GtkFramePeer.c, classpath/native/jni/gtk-peer/Makefile.am, classpath/native/jni/gtk-peer/gnu_java_awt_peer_gtk_GtkComponentPeer.c, classpath/native/jawt/Makefile.am, classpath/native/jawt/.cvsignore, classpath/native/target/Linux/Makefile.in, classpath/native/plugin/gcjwebplugin.cc, classpath/native/plugin/Makefile.am, classpath/native/plugin/.cvsignore, classpath/resource/Makefile.in, classpath/gnu/java/awt/peer/gtk/VolatileImageGraphics.java, classpath/gnu/java/awt/peer/gtk/CairoGraphics2D.java, classpath/gnu/java/awt/peer/gtk/CairoSurface.java, classpath/gnu/java/awt/peer/gtk/GdkFontPeer.java, classpath/gnu/java/awt/peer/gtk/GdkPixbufDecoder.java, classpath/gnu/java/awt/peer/gtk/FreetypeGlyphVector.java, classpath/gnu/java/awt/peer/gtk/GdkGraphicsEnvironment.java, classpath/gnu/java/awt/peer/gtk/GdkGraphics2D.java, classpath/gnu/java/awt/peer/gtk/ComponentGraphicsCopy.java, classpath/gnu/java/awt/peer/gtk/GtkComponentPeer.java, classpath/gnu/java/awt/peer/gtk/GdkGraphics.java, classpath/gnu/java/awt/peer/gtk/GtkToolkit.java, classpath/gnu/java/awt/peer/gtk/GdkScreenGraphicsDevice.java, classpath/gnu/java/awt/peer/gtk/BufferedImageGraphics.java, classpath/gnu/java/awt/peer/gtk/GdkTextLayout.java, classpath/gnu/java/awt/peer/gtk/GdkGraphicsConfiguration.java, classpath/gnu/java/awt/peer/gtk/ComponentGraphics.java, classpath/gnu/java/awt/peer/gtk/CairoSurfaceGraphics.java, classpath/gnu/java/awt/peer/gtk/GtkImage.java, classpath/gnu/java/awt/peer/gtk/GtkVolatileImage.java, classpath/gnu/java/awt/peer/gtk/GdkGlyphVector.java, classpath/gnu/java/awt/peer/gtk/GtkCanvasPeer.java, classpath/gnu/java/awt/peer/swing/SwingContainerPeer.java, classpath/gnu/java/awt/peer/swing/SwingComponent.java, classpath/gnu/java/awt/peer/swing/SwingTextFieldPeer.java, classpath/gnu/java/awt/peer/swing/SwingMenuBarPeer.java, classpath/gnu/java/awt/peer/swing/SwingFramePeer.java, classpath/gnu/java/awt/peer/swing/SwingComponentPeer.java, classpath/gnu/java/awt/peer/swing/SwingWindowPeer.java, classpath/gnu/java/awt/print/JavaPrinterJob.java, classpath/gnu/java/awt/print/PostScriptGraphics2D.java, classpath/gnu/java/awt/print/SpooledDocument.java, classpath/gnu/java/awt/print/JavaPrinterGraphics.java, classpath/gnu/java/awt/BitwiseXORComposite.java, classpath/gnu/java/awt/font/GNUGlyphVector.java, classpath/gnu/java/awt/font/opentype/NameDecoder.java, classpath/gnu/java/awt/java2d/RasterGraphics.java, classpath/gnu/java/awt/java2d/TexturePaintContext.java, classpath/gnu/java/awt/java2d/PolyEdge.java, classpath/gnu/java/awt/java2d/AbstractGraphics2D.java, classpath/gnu/java/awt/java2d/AlphaCompositeContext.java, classpath/gnu/java/awt/java2d/ImagePaint.java, classpath/gnu/java/awt/Buffers.java, classpath/gnu/classpath/Configuration.java.in, classpath/gnu/javax/swing/text/html/CombinedAttributes.java, classpath/gnu/javax/swing/text/html/CharacterAttributeTranslator.java, classpath/gnu/javax/swing/text/html/parser/htmlAttributeSet.java, classpath/gnu/javax/swing/text/html/parser/SmallHtmlAttributeSet.java, classpath/gnu/javax/swing/text/html/ImageViewIconFactory.java, classpath/tools/toolwrapper.c, classpath/tools/gnu/classpath/tools/native2ascii/Native2ASCII.java, classpath/tools/gnu/classpath/tools/native2ascii/Messages.java, classpath/tools/gnu/classpath/tools/getopt/FileArgumentCallback.java, classpath/tools/gnu/classpath/tools/getopt/OptionGroup.java, classpath/tools/gnu/classpath/tools/getopt/OptionException.java, classpath/tools/gnu/classpath/tools/getopt/Messages.java, classpath/tools/gnu/classpath/tools/getopt/Option.java, classpath/tools/gnu/classpath/tools/getopt/Parser.java, classpath/tools/gnu/classpath/tools/getopt/ClasspathToolParser.java, classpath/tools/gnu/classpath/tools/jarsigner/JarSigner.java, classpath/tools/gnu/classpath/tools/jarsigner/Main.java, classpath/tools/gnu/classpath/tools/jarsigner/Messages.java, classpath/tools/gnu/classpath/tools/jarsigner/package.html, classpath/tools/gnu/classpath/tools/keytool/ListCmd.java, classpath/tools/gnu/classpath/tools/keytool/StorePasswdCmd.java, classpath/tools/gnu/classpath/tools/keytool/ExportCmd.java, classpath/tools/gnu/classpath/tools/keytool/GenKeyCmd.java, classpath/tools/gnu/classpath/tools/keytool/Messages.java, classpath/tools/gnu/classpath/tools/keytool/package.html, classpath/tools/gnu/classpath/tools/keytool/Command.java, classpath/tools/gnu/classpath/tools/keytool/IdentityDBCmd.java, classpath/tools/gnu/classpath/tools/keytool/Main.java, classpath/tools/gnu/classpath/tools/keytool/DeleteCmd.java, classpath/tools/gnu/classpath/tools/keytool/CertReqCmd.java, classpath/tools/gnu/classpath/tools/keytool/SelfCertCmd.java, classpath/tools/gnu/classpath/tools/keytool/KeyCloneCmd.java, classpath/tools/gnu/classpath/tools/keytool/KeyPasswdCmd.java, classpath/tools/gnu/classpath/tools/keytool/ImportCmd.java, classpath/tools/gnu/classpath/tools/keytool/PrintCertCmd.java, classpath/tools/gnu/classpath/tools/rmi/registry/package.html, classpath/tools/gnu/classpath/tools/rmi/RMIC.txt, classpath/tools/gnu/classpath/tools/rmi/RMIC.java, classpath/tools/gnu/classpath/tools/appletviewer/ErrorApplet.java, classpath/tools/gnu/classpath/tools/appletviewer/AppletClassLoader.java, classpath/tools/gnu/classpath/tools/appletviewer/CommonAppletContext.java, classpath/tools/gnu/classpath/tools/appletviewer/StandaloneAppletContext.java, classpath/tools/gnu/classpath/tools/appletviewer/AppletSecurityManager.java, classpath/tools/gnu/classpath/tools/appletviewer/PluginAppletContext.java, classpath/tools/gnu/classpath/tools/appletviewer/AppletWarning.java, classpath/tools/gnu/classpath/tools/appletviewer/StandaloneAppletViewer.java, classpath/tools/gnu/classpath/tools/appletviewer/AppletTag.java, classpath/tools/gnu/classpath/tools/appletviewer/ConsoleDialog.java, classpath/tools/gnu/classpath/tools/appletviewer/Main.java, classpath/tools/gnu/classpath/tools/appletviewer/StandaloneAppletWindow.java, classpath/tools/gnu/classpath/tools/appletviewer/PluginAppletViewer.java, classpath/tools/gnu/classpath/tools/appletviewer/TagParser.java, classpath/tools/gnu/classpath/tools/appletviewer/PluginAppletWindow.java, classpath/tools/gnu/classpath/tools/appletviewer/CommonAppletStub.java, classpath/tools/gnu/classpath/tools/serialver/Messages.java, classpath/tools/gnu/classpath/tools/serialver/SerialVer.java, classpath/tools/gnu/classpath/tools/jar/Creator.java, classpath/tools/gnu/classpath/tools/jar/Entry.java, classpath/tools/gnu/classpath/tools/jar/Lister.java, classpath/tools/gnu/classpath/tools/jar/Main.java, classpath/tools/gnu/classpath/tools/jar/Updater.java, classpath/tools/gnu/classpath/tools/jar/Messages.java, classpath/tools/gnu/classpath/tools/jar/Extractor.java, classpath/tools/gnu/classpath/tools/jar/Action.java, classpath/tools/gnu/classpath/tools/jar/Indexer.java, classpath/tools/gnu/classpath/tools/jar/WorkSet.java, classpath/tools/gnu/classpath/tools/giop/GRMIC.txt, classpath/tools/gnu/classpath/tools/giop/grmic/GiopRmicCompiler.java, classpath/tools/gnu/classpath/tools/giop/GRMIC.java, classpath/tools/Makefile.am, classpath/tools/jarsigner.in, classpath/tools/keytool.in, classpath/tools/appletviewer.in, classpath/tools/.cvsignore, classpath/configure.ac, classpath/javax/swing/JTabbedPane.java, classpath/javax/swing/AbstractButton.java, classpath/javax/swing/JViewport.java, classpath/javax/swing/KeyboardManager.java, classpath/javax/swing/JMenuItem.java, classpath/javax/swing/JMenuBar.java, classpath/javax/swing/MenuSelectionManager.java, classpath/javax/swing/JOptionPane.java, classpath/javax/swing/JSpinner.java, classpath/javax/swing/JCheckBoxMenuItem.java, classpath/javax/swing/JEditorPane.java, classpath/javax/swing/JFormattedTextField.java, classpath/javax/swing/JTree.java, classpath/javax/swing/CellRendererPane.java, classpath/javax/swing/JScrollPane.java, classpath/javax/swing/tree/VariableHeightLayoutCache.java, classpath/javax/swing/tree/TreeNode.java, classpath/javax/swing/tree/FixedHeightLayoutCache.java, classpath/javax/swing/tree/DefaultTreeCellEditor.java, classpath/javax/swing/tree/TreePath.java, classpath/javax/swing/tree/RowMapper.java, classpath/javax/swing/tree/DefaultMutableTreeNode.java, classpath/javax/swing/tree/DefaultTreeModel.java, classpath/javax/swing/tree/AbstractLayoutCache.java, classpath/javax/swing/tree/TreeSelectionModel.java, classpath/javax/swing/tree/DefaultTreeSelectionModel.java, classpath/javax/swing/tree/DefaultTreeCellRenderer.java, classpath/javax/swing/tree/ExpandVetoException.java, classpath/javax/swing/JList.java, classpath/javax/swing/table/JTableHeader.java, classpath/javax/swing/table/AbstractTableModel.java, classpath/javax/swing/table/DefaultTableModel.java, classpath/javax/swing/table/TableCellEditor.java, classpath/javax/swing/table/TableCellRenderer.java, classpath/javax/swing/ProgressMonitor.java, classpath/javax/swing/JToolBar.java, classpath/javax/swing/TransferHandler.java, classpath/javax/swing/DefaultCellEditor.java, classpath/javax/swing/DefaultButtonModel.java, classpath/javax/swing/JLayeredPane.java, classpath/javax/swing/text/DefaultEditorKit.java, classpath/javax/swing/text/DefaultCaret.java, classpath/javax/swing/text/FieldView.java, classpath/javax/swing/text/JTextComponent.java, classpath/javax/swing/text/TextAction.java, classpath/javax/swing/text/StyleContext.java, classpath/javax/swing/text/html/HTMLDocument.java, classpath/javax/swing/text/html/MinimalHTMLWriter.java, classpath/javax/swing/text/html/ImageView.java, classpath/javax/swing/text/html/HTMLEditorKit.java, classpath/javax/swing/text/AbstractWriter.java, classpath/javax/swing/text/GapContent.java, classpath/javax/swing/text/Utilities.java, classpath/javax/swing/text/PlainView.java, classpath/javax/swing/UIManager.java, classpath/javax/swing/JSplitPane.java, classpath/javax/swing/JComponent.java, classpath/javax/swing/SwingUtilities.java, classpath/javax/swing/border/AbstractBorder.java, classpath/javax/swing/border/CompoundBorder.java, classpath/javax/swing/border/TitledBorder.java, classpath/javax/swing/border/MatteBorder.java, classpath/javax/swing/border/BevelBorder.java, classpath/javax/swing/RepaintManager.java, classpath/javax/swing/JTable.java, classpath/javax/swing/UIDefaults.java, classpath/javax/swing/DefaultDesktopManager.java, classpath/javax/swing/JMenu.java, classpath/javax/swing/JLabel.java, classpath/javax/swing/JSlider.java, classpath/javax/swing/plaf/basic/BasicToolBarUI.java, classpath/javax/swing/plaf/basic/BasicButtonUI.java, classpath/javax/swing/plaf/basic/BasicOptionPaneUI.java, classpath/javax/swing/plaf/basic/BasicTextAreaUI.java, classpath/javax/swing/plaf/basic/BasicToggleButtonUI.java, classpath/javax/swing/plaf/basic/BasicSpinnerUI.java, classpath/javax/swing/plaf/basic/BasicSliderUI.java, classpath/javax/swing/plaf/basic/BasicTabbedPaneUI.java, classpath/javax/swing/plaf/basic/BasicComboPopup.java, classpath/javax/swing/plaf/basic/BasicCheckBoxUI.java, classpath/javax/swing/plaf/basic/BasicInternalFrameUI.java, classpath/javax/swing/plaf/basic/BasicProgressBarUI.java, classpath/javax/swing/plaf/basic/BasicRadioButtonUI.java, classpath/javax/swing/plaf/basic/BasicPanelUI.java, classpath/javax/swing/plaf/basic/BasicSplitPaneUI.java, classpath/javax/swing/plaf/basic/BasicTreeUI.java, classpath/javax/swing/plaf/basic/BasicTableHeaderUI.java, classpath/javax/swing/plaf/basic/BasicFileChooserUI.java, classpath/javax/swing/plaf/basic/BasicScrollPaneUI.java, classpath/javax/swing/plaf/basic/BasicComboBoxUI.java, classpath/javax/swing/plaf/basic/BasicListUI.java, classpath/javax/swing/plaf/basic/BasicIconFactory.java, classpath/javax/swing/plaf/basic/BasicTextUI.java, classpath/javax/swing/plaf/basic/BasicLookAndFeel.java, classpath/javax/swing/plaf/basic/BasicDirectoryModel.java, classpath/javax/swing/plaf/basic/BasicRootPaneUI.java, classpath/javax/swing/plaf/basic/BasicTableUI.java, classpath/javax/swing/plaf/basic/SharedUIDefaults.java, classpath/javax/swing/plaf/multi/MultiComboBoxUI.java, classpath/javax/swing/plaf/multi/MultiListUI.java, classpath/javax/swing/plaf/multi/MultiSplitPaneUI.java, classpath/javax/swing/plaf/multi/MultiFileChooserUI.java, classpath/javax/swing/plaf/multi/MultiOptionPaneUI.java, classpath/javax/swing/plaf/multi/MultiTabbedPaneUI.java, classpath/javax/swing/plaf/multi/MultiLookAndFeel.java, classpath/javax/swing/plaf/metal/MetalSliderUI.java, classpath/javax/swing/plaf/metal/MetalIconFactory.java, classpath/javax/swing/plaf/metal/MetalComboBoxIcon.java, classpath/javax/swing/plaf/metal/MetalTabbedPaneUI.java, classpath/javax/swing/plaf/metal/MetalLookAndFeel.java, classpath/javax/swing/plaf/metal/MetalCheckBoxUI.java, classpath/javax/swing/plaf/metal/MetalSeparatorUI.java, classpath/javax/swing/plaf/metal/MetalBorders.java, classpath/javax/swing/plaf/metal/MetalSplitPaneDivider.java, classpath/javax/swing/plaf/metal/MetalScrollBarUI.java, classpath/javax/swing/plaf/metal/MetalRootPaneUI.java, classpath/javax/swing/plaf/metal/MetalInternalFrameUI.java, classpath/javax/swing/plaf/metal/MetalRadioButtonUI.java, classpath/javax/swing/plaf/metal/MetalToolTipUI.java, classpath/javax/swing/plaf/metal/MetalInternalFrameTitlePane.java, classpath/javax/swing/plaf/metal/MetalFileChooserUI.java, classpath/javax/swing/plaf/metal/MetalUtils.java, classpath/javax/swing/plaf/metal/MetalComboBoxButton.java, classpath/javax/swing/plaf/metal/MetalPopupMenuSeparatorUI.java, classpath/javax/swing/plaf/metal/MetalButtonUI.java, classpath/javax/swing/JPopupMenu.java, classpath/javax/swing/JProgressBar.java, classpath/javax/swing/WindowConstants.java, classpath/javax/swing/JFrame.java, classpath/javax/swing/JFileChooser.java, classpath/javax/swing/JComboBox.java, classpath/javax/swing/event/EventListenerList.java, classpath/javax/swing/ListSelectionModel.java, classpath/javax/swing/JScrollBar.java, classpath/java/text/SimpleDateFormat.java, classpath/java/text/NumberFormat.java, classpath/java/text/class-dependencies.conf, classpath/java/awt/image/ColorModel.java, classpath/java/awt/image/BufferedImage.java, classpath/java/awt/Window.java, classpath/java/awt/ContainerOrderFocusTraversalPolicy.java, classpath/java/awt/LightweightDispatcher.java, classpath/java/awt/EventDispatchThread.java, classpath/java/awt/BasicStroke.java, classpath/java/awt/ColorPaintContext.java, classpath/java/awt/Container.java, classpath/java/awt/TexturePaint.java, classpath/java/awt/Component.java, classpath/java/awt/Font.java, classpath/java/awt/GraphicsConfiguration.java, classpath/java/awt/DefaultKeyboardFocusManager.java, classpath/java/awt/print/PrinterJob.java, classpath/java/awt/im/InputContext.java, classpath/java/awt/dnd/DragGestureRecognizer.java, classpath/java/awt/Toolkit.java, classpath/java/awt/font/GraphicAttribute.java, classpath/java/awt/font/ImageGraphicAttribute.java, classpath/java/awt/font/GlyphVector.java, classpath/java/awt/font/GlyphMetrics.java, classpath/java/awt/font/ShapeGraphicAttribute.java, classpath/java/awt/Graphics2D.java, classpath/include/gnu_java_awt_peer_gtk_GdkGraphicsEnvironment.h, classpath/include/gnu_java_awt_peer_gtk_ComponentGraphics.h, classpath/include/gnu_java_awt_peer_gtk_CairoGraphics2D.h, classpath/include/gnu_java_awt_peer_gtk_FreetypeGlyphVector.h, classpath/include/gnu_java_awt_peer_gtk_GtkCanvasPeer.h, classpath/include/config.h.in, classpath/include/gnu_java_awt_peer_gtk_GdkTextLayout.h, classpath/include/gnu_java_awt_peer_gtk_GtkComponentPeer.h, classpath/include/gnu_java_awt_peer_gtk_GdkFontPeer.h, classpath/include/gnu_java_awt_peer_gtk_ComponentGraphicsCopy.h, classpath/include/gnu_java_awt_peer_gtk_GtkVolatileImage.h, classpath/include/gnu_java_awt_peer_gtk_GtkImage.h, classpath/include/gnu_java_awt_peer_gtk_CairoSurface.h, classpath/include/gnu_java_awt_peer_gtk_GdkScreenGraphicsDevice.h: Merge from GNU Classpath HEAD. From-SVN: r114510
This commit is contained in:
Thomas Fitzsimmons
Thomas Fitzsimmons
parent
6c65d7577c
commit
02440ca432
360 changed files with 34743 additions and 9337 deletions
|
|
@ -1,5 +1,5 @@
|
|||
/* ListSelectionModel.java --
|
||||
Copyright (C) 2002 Free Software Foundation, Inc.
|
||||
Copyright (C) 2002, 2006, Free Software Foundation, Inc.
|
||||
|
||||
This file is part of GNU Classpath.
|
||||
|
||||
|
|
@ -38,59 +38,295 @@ exception statement from your version. */
|
|||
|
||||
package javax.swing;
|
||||
|
||||
import javax.swing.event.ListSelectionEvent;
|
||||
import javax.swing.event.ListSelectionListener;
|
||||
|
||||
/**
|
||||
* The model that is used in {@link JList} to define the selected/not-selected
|
||||
* cells of that list.
|
||||
* A model that tracks the selection status of a list of items. Each item in
|
||||
* the list is identified by a zero-based index only, so the model can be used
|
||||
* to track the selection status of any type of list. The model
|
||||
* supports three modes:
|
||||
* <ul>
|
||||
* <li><code>SINGLE_SELECTION</code> - only one item in the list may be
|
||||
* selected;</li>
|
||||
* <li><code>SINGLE_INTERVAL_SELECTION</code> - only one interval in the list
|
||||
* may be selected;</li>
|
||||
* <li><code>MULTIPLE_INTERVAL_SELECTION</code> - any combination of items in
|
||||
* the list may be selected.</li>
|
||||
* </ul>
|
||||
* The model uses an event notification mechanism to notify listeners (see
|
||||
* {@link ListSelectionListener}) about updates to the selection model.
|
||||
* <p>
|
||||
* This model is used to track row selections in the {@link JList} component,
|
||||
* and row and column selections in the {@link JTable} component.
|
||||
*/
|
||||
public interface ListSelectionModel
|
||||
{
|
||||
|
||||
|
||||
/**
|
||||
* A selection mode in which only one item can be selected.
|
||||
*
|
||||
* @see #setSelectionMode(int)
|
||||
*/
|
||||
int SINGLE_SELECTION = 0;
|
||||
|
||||
/**
|
||||
* A selection mode in which a single interval can be selected (an interval
|
||||
* is a range containing one or more contiguous items).
|
||||
*
|
||||
* @see #setSelectionMode(int)
|
||||
*/
|
||||
int SINGLE_INTERVAL_SELECTION = 1;
|
||||
|
||||
/**
|
||||
* A selection mode in which any combination of items can be selected.
|
||||
*
|
||||
* @see #setSelectionMode(int)
|
||||
*/
|
||||
int MULTIPLE_INTERVAL_SELECTION = 2;
|
||||
|
||||
void setSelectionMode(int a);
|
||||
/**
|
||||
* Sets the selection mode.
|
||||
* <p>
|
||||
* FIXME: The spec is silent about what happens to existing selections, for
|
||||
* example when changing from an interval selection to single selection.
|
||||
*
|
||||
* @param mode one of {@link #SINGLE_SELECTION},
|
||||
* {@link #SINGLE_INTERVAL_SELECTION} and
|
||||
* {@link #MULTIPLE_INTERVAL_SELECTION}.
|
||||
*
|
||||
* @see #getSelectionMode()
|
||||
*
|
||||
* @throws IllegalArgumentException if <code>mode</code> is not one of the
|
||||
* specified values.
|
||||
*/
|
||||
void setSelectionMode(int mode);
|
||||
|
||||
/**
|
||||
* Returns the selection mode, which is one of {@link #SINGLE_SELECTION},
|
||||
* {@link #SINGLE_INTERVAL_SELECTION} and
|
||||
* {@link #MULTIPLE_INTERVAL_SELECTION}.
|
||||
*
|
||||
* @return The selection mode.
|
||||
*
|
||||
* @see #setSelectionMode(int)
|
||||
*/
|
||||
int getSelectionMode();
|
||||
|
||||
/**
|
||||
* Clears the current selection from the model. If the selection state
|
||||
* changes (that is, the existing selection is non-empty) a
|
||||
* {@link ListSelectionEvent} should be sent to all registered listeners.
|
||||
* <p>
|
||||
* FIXME: what happens to the anchor and lead selection indices (the spec
|
||||
* is silent about this)? See:
|
||||
* <p>
|
||||
* http://bugs.sun.com/bugdatabase/view_bug.do?bug_id=4334792
|
||||
*/
|
||||
void clearSelection();
|
||||
|
||||
/**
|
||||
* Returns the lowest selected index, or <code>-1</code> if there is no
|
||||
* selection.
|
||||
*
|
||||
* @return The lowest selected index.
|
||||
*
|
||||
* @see #getMaxSelectionIndex()
|
||||
*/
|
||||
int getMinSelectionIndex();
|
||||
|
||||
/**
|
||||
* Returns the highest selected index, or <code>-1</code> if there is no
|
||||
* selection.
|
||||
*
|
||||
* @return The highest selected index.
|
||||
*
|
||||
* @see #getMinSelectionIndex()
|
||||
*/
|
||||
int getMaxSelectionIndex();
|
||||
|
||||
boolean isSelectedIndex(int a);
|
||||
/**
|
||||
* Returns <code>true</code> if the specified item is selected, and
|
||||
* <code>false</code> otherwise. Special note: if <code>index</code> is
|
||||
* negative, this method should return <code>false</code> (no exception
|
||||
* should be thrown).
|
||||
*
|
||||
* @param index the item index (zero-based).
|
||||
*
|
||||
* @return <code>true</code> if the specified item is selected, and
|
||||
* <code>false</code> otherwise.
|
||||
*/
|
||||
boolean isSelectedIndex(int index);
|
||||
|
||||
/**
|
||||
* Returns <code>true</code> if there is no selection, and <code>false</code>
|
||||
* otherwise.
|
||||
*
|
||||
* @return <code>true</code> if there is no selection, and
|
||||
* <code>false</code> otherwise.
|
||||
*/
|
||||
boolean isSelectionEmpty();
|
||||
|
||||
void setSelectionInterval(int index0, int index1);
|
||||
/**
|
||||
* Sets the selection interval to the specified range (note that
|
||||
* <code>anchor</code> can be less than, equal to, or greater than
|
||||
* <code>lead</code>). If this results in the selection being changed,
|
||||
* a {@link ListSelectionEvent} is sent to all registered listeners.
|
||||
* <p>
|
||||
* If the selection mode is {@link #SINGLE_SELECTION}, only the
|
||||
* <code>lead</code> item is selected.
|
||||
*
|
||||
* @param anchor the anchor index.
|
||||
* @param lead the lead index.
|
||||
*/
|
||||
void setSelectionInterval(int anchor, int lead);
|
||||
|
||||
void addSelectionInterval(int index0, int index1);
|
||||
/**
|
||||
* Marks the items in the specified interval as selected. The behaviour of
|
||||
* this method depends on the selection mode:
|
||||
* <ul>
|
||||
* <li><code>SINGLE_SELECTION</code> - only the <code>lead</code> item is
|
||||
* selected;</li>
|
||||
* <li><code>SINGLE_INTERVAL_SELECTION</code> - the existing selection
|
||||
* interval is replaced by the specified interval;</li>
|
||||
* <li><code>MULTIPLE_INTERVAL_SELECTION</code> - the specified interval is
|
||||
* merged into the currently selected intervals.</li>
|
||||
* </ul>
|
||||
* Note that <code>anchor</code> can be less than, equal to, or greater than
|
||||
* <code>lead</code>.
|
||||
*
|
||||
* @param anchor the index of the anchor item
|
||||
* @param lead the index of the lead item.
|
||||
*/
|
||||
void addSelectionInterval(int anchor, int lead);
|
||||
|
||||
void removeSelectionInterval(int index0, int index1);
|
||||
/**
|
||||
* Marks the items in the specified interval as not selected. The behaviour
|
||||
* of this method depends on the selection mode:
|
||||
* <ul>
|
||||
* <li><code>SINGLE_SELECTION</code> - XXX;</li>
|
||||
* <li><code>SINGLE_INTERVAL_SELECTION</code> - XXX;</li>
|
||||
* <li><code>MULTIPLE_INTERVAL_SELECTION</code> - XXX.</li>
|
||||
* </ul>
|
||||
* Note that <code>anchor</code> can be less than, equal to, or greater than
|
||||
* <code>lead</code>.
|
||||
*
|
||||
* @param anchor the index of the anchor item
|
||||
* @param lead the index of the lead item.
|
||||
*/
|
||||
void removeSelectionInterval(int anchor, int lead);
|
||||
|
||||
/**
|
||||
* Inserts a new interval containing <code>length</code> items at the
|
||||
* specified <code>index</code> (the <code>before</code> flag indicates
|
||||
* whether the range is inserted before or after the existing item at
|
||||
* <code>index</code>).
|
||||
*
|
||||
* FIXME: What is the selection status of the new items? Bug 4870694.
|
||||
* FIXME: What event is generated?
|
||||
*
|
||||
* @param index the index of the item.
|
||||
* @param length the number of items in the interval to be inserted.
|
||||
* @param before if <code>true</code>, the interval should be inserted
|
||||
* before <code>index</code>, otherwise it is inserted after.
|
||||
*
|
||||
* @see #removeIndexInterval(int, int)
|
||||
*/
|
||||
void insertIndexInterval(int index, int length, boolean before);
|
||||
|
||||
/**
|
||||
* Removes the items in the specified range (inclusive) from the selection
|
||||
* model. This method should be called when an interval is deleted from
|
||||
* the underlying list.
|
||||
*
|
||||
* FIXME: what happens to the lead and anchor indices if they are part of
|
||||
* the range that is removed?
|
||||
* FIXME: what event is generated
|
||||
*
|
||||
* @param index0 XXX
|
||||
* @param index1 XXX
|
||||
*
|
||||
* @see #insertIndexInterval(int, int, boolean)
|
||||
*/
|
||||
void removeIndexInterval(int index0, int index1);
|
||||
|
||||
/**
|
||||
* Returns the index of the anchor item.
|
||||
*
|
||||
* @return The index of the anchor item.
|
||||
*
|
||||
* @see #setAnchorSelectionIndex(int)
|
||||
*/
|
||||
int getAnchorSelectionIndex();
|
||||
|
||||
/**
|
||||
* Sets the index of the anchor item.
|
||||
*
|
||||
* @param index the item index.
|
||||
*
|
||||
* @see #getAnchorSelectionIndex()
|
||||
*/
|
||||
void setAnchorSelectionIndex(int index);
|
||||
|
||||
/**
|
||||
* Returns the index of the lead item.
|
||||
*
|
||||
* @return The index of the lead item.
|
||||
*
|
||||
* @see #setLeadSelectionIndex(int)
|
||||
*/
|
||||
int getLeadSelectionIndex();
|
||||
|
||||
/**
|
||||
* Sets the index of the lead item.
|
||||
*
|
||||
* @param index the item index.
|
||||
*
|
||||
* @see #getLeadSelectionIndex()
|
||||
*/
|
||||
void setLeadSelectionIndex(int index);
|
||||
|
||||
/**
|
||||
* Sets the flag that is passed to listeners for each change notification.
|
||||
* If a sequence of changes is made to the selection model, this flag should
|
||||
* be set to <code>true</code> at the start of the sequence, and
|
||||
* <code>false</code> for the last change - this gives listeners the option
|
||||
* to ignore interim changes if that is more efficient.
|
||||
*
|
||||
* @param valueIsAdjusting the flag value.
|
||||
*
|
||||
* @see #getValueIsAdjusting()
|
||||
*/
|
||||
void setValueIsAdjusting(boolean valueIsAdjusting);
|
||||
|
||||
/**
|
||||
* Returns a flag that is passed to registered listeners when changes are
|
||||
* made to the model. See the description for
|
||||
* {@link #setValueIsAdjusting(boolean)} for more information.
|
||||
*
|
||||
* @return The flag.
|
||||
*/
|
||||
boolean getValueIsAdjusting();
|
||||
|
||||
/**
|
||||
* Registers a listener with the model so that it receives notification
|
||||
* of changes to the model.
|
||||
*
|
||||
* @param listener the listener (<code>null</code> ignored).
|
||||
*
|
||||
* @see #removeListSelectionListener(ListSelectionListener)
|
||||
*/
|
||||
void addListSelectionListener(ListSelectionListener listener);
|
||||
|
||||
/**
|
||||
* Deregisters a listener so that it no longer receives notification of
|
||||
* changes to the model. If the specified listener is not registered with
|
||||
* the model, or is <code>null</code>, this method does nothing.
|
||||
*
|
||||
* @param listener the listener (<code>null</code> ignored).
|
||||
*
|
||||
* @see #addListSelectionListener(ListSelectionListener)
|
||||
*/
|
||||
void removeListSelectionListener(ListSelectionListener listener);
|
||||
|
||||
}
|
||||
|
|
|
|||
Loading…
Add table
Add a link
Reference in a new issue