jdk-sandbox: comparison jdk/src/share/classes/javax/swing/plaf/metal/MetalFileChooserUI.java

equal deleted inserted replaced

-:487a5e71f6dd
+:dbab904451e9
 fileNameLabel.setText(fileNameLabelText);
 fileNameLabel.setDisplayedMnemonic(fileNameLabelMnemonic);
 }
 }
-//
+/**
-// ComponentUI Interface Implementation methods
+* Constructs a new instance of {@code MetalFileChooserUI}.
-//
+*
+* @param c a component
+* @return a new instance of {@code MetalFileChooserUI}
+*/
 public static ComponentUI createUI(JComponent c) {
 return new MetalFileChooserUI((JFileChooser) c);
 }
+/**
+* Constructs a new instance of {@code MetalFileChooserUI}.
+*
+* @param filechooser a {@code JFileChooser}
+*/
 public MetalFileChooserUI(JFileChooser filechooser) {
 super(filechooser);
 }
 public void installUI(JComponent c) {
 }
 groupLabels(new AlignedLabel[] { fileNameLabel, filesOfTypeLabel });
 }
+/**
+* Returns the button panel.
+*
+* @return the button panel
+*/
 protected JPanel getButtonPanel() {
 if (buttonPanel == null) {
 buttonPanel = new JPanel();
 }
 return buttonPanel;
 }
+/**
+* Returns the bottom panel.
+*
+* @return the bottom panel
+*/
 protected JPanel getBottomPanel() {
 if(bottomPanel == null) {
 bottomPanel = new JPanel();
 }
 return bottomPanel;
 super.installListeners(fc);
 ActionMap actionMap = getActionMap();
 SwingUtilities.replaceUIActionMap(fc, actionMap);
 }
+/**
+* Returns an instance of {@code ActionMap}.
+*
+* @return an instance of {@code ActionMap}
+*/
 protected ActionMap getActionMap() {
 return createActionMap();
 }
+/**
+* Constructs an instance of {@code ActionMap}.
+*
+* @return an instance of {@code ActionMap}
+*/
 protected ActionMap createActionMap() {
 ActionMap map = new ActionMapUIResource();
 FilePane.addActionsToMap(map, filePane.getActions());
 return map;
 }
+/**
+* Constructs a details view.
+*
+* @param fc a {@code JFileChooser}
+* @return the list
+*/
 protected JPanel createList(JFileChooser fc) {
 return filePane.createList();
 }
+/**
+* Constructs a details view.
+*
+* @param fc a {@code JFileChooser}
+* @return the details view
+*/
 protected JPanel createDetailsView(JFileChooser fc) {
 return filePane.createDetailsView();
 }
 /**
 return super.createListSelectionListener(fc);
 }
 // Obsolete class, not used in this version.
 protected class SingleClickListener extends MouseAdapter {
-public  SingleClickListener(JList list) {
+/**
+* Constructs an instance of {@code SingleClickListener}.
+*
+* @param list an instance of {@code JList}
+*/
+public SingleClickListener(JList list) {
 }
 }
 // Obsolete class, not used in this version.
 @SuppressWarnings("serial") // Superclass is not serializable across versions
 }
 }
 };
 }
+/**
+* Removes control buttons from bottom panel.
+*/
 protected void removeControlButtons() {
 getBottomPanel().remove(getButtonPanel());
 }
+/**
+* Adds control buttons to bottom panel.
+*/
 protected void addControlButtons() {
 getBottomPanel().add(getButtonPanel());
 }
 public void ensureFileIsVisible(JFileChooser fc, File f) {
 approveButton.setToolTipText(getApproveButtonToolTipText(chooser));
 }
 }
 }
+/**
+* Returns the directory name.
+*
+* @return the directory name
+*/
 public String getDirectoryName() {
 // PENDING(jeff) - get the name from the directory combobox
 return null;
 }
+/**
+* Sets the directory name.
+*
+* @param dirname the directory name
+*/
 public void setDirectoryName(String dirname) {
 // PENDING(jeff) - set the name in the directory combobox
 }
+/**
+* Constructs a new instance of {@code DirectoryComboBoxRenderer}.
+*
+* @param fc a {@code JFileChooser}
+* @return a new instance of {@code DirectoryComboBoxRenderer}
+*/
 protected DirectoryComboBoxRenderer createDirectoryComboBoxRenderer(JFileChooser fc) {
 return new DirectoryComboBoxRenderer();
 }
 //
 return icon.getIconHeight();
 }
 }
-//
+/**
-// DataModel for DirectoryComboxbox
+* Constructs a new instance of {@code DataModel} for {@code DirectoryComboBox}.
-//
+*
+* @param fc a {@code JFileChooser}
+* @return a new instance of {@code DataModel} for {@code DirectoryComboBox}
+*/
 protected DirectoryComboBoxModel createDirectoryComboBoxModel(JFileChooser fc) {
 return new DirectoryComboBoxModel();
 }
 /**
 int[] depths = null;
 File selectedDirectory = null;
 JFileChooser chooser = getFileChooser();
 FileSystemView fsv = chooser.getFileSystemView();
+/**
+* Constructs an instance of {@code DirectoryComboBoxModel}.
+*/
 public DirectoryComboBoxModel() {
 // Add the current directory to the model, and make it the
 // selectedDirectory
 File dir = getFileChooser().getCurrentDirectory();
 if(dir != null) {
 }
 }
 }
 }
+/**
+* Returns the depth of {@code i}-th file.
+*
+* @param i an index
+* @return the depth of {@code i}-th file
+*/
 public int getDepth(int i) {
 return (depths != null && i >= 0 && i < depths.length) ? depths[i] : 0;
 }
 public void setSelectedItem(Object selectedDirectory) {
 public Object getElementAt(int index) {
 return directories.elementAt(index);
 }
 }
-//
+/**
-// Renderer for Types ComboBox
+* Constructs a {@code Renderer} for types {@code ComboBox}.
-//
+*
+* @return a {@code Renderer} for types {@code ComboBox}
+*/
 protected FilterComboBoxRenderer createFilterComboBoxRenderer() {
 return new FilterComboBoxRenderer();
 }
 /**
 return this;
 }
 }
-//
+/**
-// DataModel for Types Comboxbox
+* Constructs a {@code DataModel} for types {@code ComboBox}.
-//
+*
+* @return a {@code DataModel} for types {@code ComboBox}
+*/
 protected FilterComboBoxModel createFilterComboBoxModel() {
 return new FilterComboBoxModel();
 }
 /**
 * Data model for a type-face selection combo-box.
 */
 @SuppressWarnings("serial") // Same-version serialization only
 protected class FilterComboBoxModel extends AbstractListModel<Object> implements ComboBoxModel<Object>, PropertyChangeListener {
+/**
+* An array of file filters.
+*/
 protected FileFilter[] filters;
+/**
+* Constructs an instance of {@code FilterComboBoxModel}.
+*/
 protected FilterComboBoxModel() {
 super();
 filters = getFileChooser().getChoosableFileFilters();
 }
 return null;
 }
 }
 }
+/**
+* Invokes when {@code ListSelectionEvent} occurs.
+*
+* @param e an instance of {@code ListSelectionEvent}
+*/
 public void valueChanged(ListSelectionEvent e) {
 JFileChooser fc = getFileChooser();
 File f = fc.getSelectedFile();
 if (!e.getValueIsAdjusting() && f != null && !getFileChooser().isTraversable(f)) {
 setFileName(fileNameString(f));
 /**
 * Acts when DirectoryComboBox has changed the selected item.
 */
 @SuppressWarnings("serial") // Superclass is not serializable across versions
 protected class DirectoryComboBoxAction extends AbstractAction {
+/**
+* Constructs a new instance of {@code DirectoryComboBoxAction}.
+*/
 protected DirectoryComboBoxAction() {
 super("DirectoryComboBoxAction");
 }
 public void actionPerformed(ActionEvent e) {

changeset 25178	dbab904451e9
parent 24969	afa6934dd8e8
child 25565	ce603b34c98d