Javadoc/Nitpick のバックアップ(No.2)

TITLE:翻訳元から - Javadoc

Posted by aterai at 2010-10-05

翻訳元から？

翻訳元から？
コメント

Htmlの表がずれている

http://java.sun.com/javase/ja/6/docs/ja/api/java/awt/Container.html#setFocusTraversalKeys(int,%20java.util.Set)
http://download.oracle.com/javase/6/docs/api/java/awt/Container.html#setFocusTraversalKeys(int,%20java.util.Set)
- KeyboardFocusManager.DOWN_CYCLE_TRAVERSAL_KEYS, 1 つ下のフォーカストラバーサルサイクルに移動 none
Bug ID: 4470006 Table shown for Traversal Keys in setDefaultFocusTraversalKeys() not proper
- Submit Date 14-JUN-2001

サンプルコードが一行になっている

http://java.sun.com/javase/ja/6/docs/ja/api/java/awt/BasicStroke.html
http://download.oracle.com/javase/6/docs/api/java/awt/BasicStroke.html
- // sets the Graphics2D object's Transform attirbute g2d.scale(10, 10); // sets the Graphics2D object's Storoke attribute g2d.setStroke(new BasicStroke(1.5f));

文字化け？

http://java.sun.com/javase/ja/6/docs/ja/technotes/guides/swing/1.4/w2k_props.html
http://download.oracle.com/javase/6/docs/technotes/guides/swing/1.4/w2k_props.html
- "win.frame.textColor?????"
- 「メッセージボックスのフォントカラー」のプロパティー名が文字化け？
- http://java.sun.com/j2se/1.5.0/ja/docs/ja/guide/swing/1.4/w2k_props.html は、「ウィンドウのフォントカラー」と同じ値になっている

本来は、"win.messagebox.textColor" とか、全然別の値なのか、あるいは、このページの先頭付近に載っているサンプルコード

String propnames[] = (String[])Toolkit.getDefaultToolkit().getDesktopProperty("win.propNames");

で、プロパティー一覧を取得しても、"win.messagebox.textColor" は存在しないので、「メッセージボックスのフォントカラー」自体が設定できないのかもしれない。

他にも同様に、?がついて重複するプロパティー名が存在する。

「アイコンのサイズ」 "win.icon.hspacing" "win.icon.vspacing"???
「アイコンの横の間隔」 "win.icon.hspacing"
「アイコンの縦の間隔」 "win.icon.vspacing"

dataModelとnewModel

http://java.sun.com/javase/ja/6/docs/ja/api/javax/swing/JTable.html#setModel(javax.swing.table.TableModel)
http://download.oracle.com/javase/6/docs/api/javax/swing/JTable.html#setModel(javax.swing.table.TableModel)
- 引数のdataModelとnewModelが混ざっている？

public void setModel(TableModel dataModel)
このテーブルのデータモデルを newModel に設定し、それに新しいデータモデルからのリスナー通知を登録します。 
パラメータ:
dataModel - このテーブルの新しいデータソース 
例外: 
IllegalArgumentException - newModel が null の場合

ピクセルの色調を明るくする場合は true

http://java.sun.com/javase/ja/6/docs/ja/api/javax/swing/GrayFilter.html#GrayFilter(boolean,%20int)
- b - boolean 型 -- ピクセルの色調を明るくする場合は true
- p - グレーの割合を指定する 0 ～ 100 の範囲の int。 100 はもっとも暗いグレー、0 はもっとも明るいグレー
http://download.oracle.com/javase/6/docs/api/javax/swing/GrayFilter.html#GrayFilter(boolean,%20int)
- b - a boolean -- true if the pixels should be brightened
- p - an int in the range 0..100 that determines the percentage of gray, where 100 is the darkest gray, and 0 is the lightest

import java.awt.*;
import java.awt.image.*;
import java.net.*;
import javax.swing.*;
public class GrayFilterTest {
  public JComponent makeUI() {
    URL url = null;
    try {
      url = new URL("http://lh4.ggpht.com/_9Z4BYR88imo/TRD2KGq73BI/AAAAAAAAAwA/N8-6EXongNk/s800/webstart.png");
    } catch (MalformedURLException e) {
      throw new InternalError();
    }
    ImageIcon original = new ImageIcon(url);
    ImageProducer ip = original.getImage().getSource();
    Box box = Box.createVerticalBox();
    box.add(makeLabel("original  ", original));
    box.add(makeLabel("false,   0", makeGrayImageIcon(ip, false, 0)));
    box.add(makeLabel("false,  50", makeGrayImageIcon(ip, false, 50)));
    box.add(makeLabel("false, 100", makeGrayImageIcon(ip, false, 100)));
    box.add(makeLabel("true,    0", makeGrayImageIcon(ip, true,  0)));
    box.add(makeLabel("true,   50", makeGrayImageIcon(ip, true,  50)));
    box.add(makeLabel("true,  100", makeGrayImageIcon(ip, true,  100)));
    return box;
  }
  private JLabel makeLabel(String title, Icon icon) {
    return new JLabel(title, icon, SwingConstants.HORIZONTAL);
  }
  private Icon makeGrayImageIcon(ImageProducer ip, boolean b, int p) {
    return new ImageIcon(Toolkit.getDefaultToolkit().createImage(
        new FilteredImageSource(ip, new GrayFilter(b, p))));
  }
  public static void main(String[] args) {
    EventQueue.invokeLater(new Runnable() {
      public void run() { createAndShowGUI(); }
    });
  }
  public static void createAndShowGUI() {
    JFrame f = new JFrame();
    f.setDefaultCloseOperation(WindowConstants.EXIT_ON_CLOSE);
    f.getContentPane().add(new GrayFilterTest().makeUI());
    f.pack();
    f.setLocationRelativeTo(null);
    f.setVisible(true);
  }
}

TableModel#isCellEditable(...)

https://java.sun.com/javase/ja/6/docs/ja/api/javax/swing/table/TableModel.html#isCellEditable(int,%20int)
http://download.oracle.com/javase/6/docs/api/javax/swing/table/TableModel.html#isCellEditable(int,%20int)
- rowIndex および columnIndex に位置するセルが編集可能な場合に true を返します。そうでない場合は、セルの setValueAt はそのセルの値を変更しません。
- Bug ID: 4292804 DefaultTableModel doc confusion between isCellEditable and setValueAt
  - DefaultTableModel は修正されている？、TableModel は関係ない？

Component.AccessibleAWTComponent.getAccessibleIndexInParent()

http://java.sun.com/javase/ja/6/docs/ja/api/javax/swing/SwingUtilities.html
- 注:Java 2 プラットフォーム v1.3 以降、開発者はこのメソッドを使用する代わりに、Component.AccessibleAWTComponent.getAccessibleIndexInParent() を呼び出すことをお勧めします。
http://download.oracle.com/javase/6/docs/api/javax/swing/SwingUtilities.html
- Note: as of the Java 2 platform v1.3, it is recommended that developers call Component.AccessibleAWTComponent.getAccessibleIndexInParent() instead of using this method.

コピペして、修正し忘れてるようで、注:が全部getAccessibleIndexInParentのものと同じになっている。