クラスFormView

java.lang.Object
javax.swing.text.View
javax.swing.text.ComponentView
javax.swing.text.html.FormView
すべての実装されたインタフェース:
ActionListener, EventListener, SwingConstants
public class FormView extends ComponentView implements ActionListener
フォーム要素<input>、<textarea>、および<select>のためのビュー・インタフェースを実装するコンポーネント・デコレータです。 コンポーネントのモデルは、要素(StyleConstants.ModelAttributeを使って)の属性として格納され、ビューのコンポーネントの作成に使用されます。 モデルのタイプは、HTMLDocument.HTMLReader.FormActionが設定するタイプであると想定されます。 ドキュメントにマップされるビューが複数ある場合、各ビューは、埋め込まれたコンポーネント・モデルを共有することになります。

次の表はこのビューでどのコンポーネントを構築するかを示します。

このビューによって構築されるコンポーネントを示します。
要素タイプ 構築されるコンポーネント
入力、タイプはbutton JButton
入力、タイプはcheckbox JCheckBox
入力、タイプはimage JButton
入力、タイプはpassword JPasswordField
入力、タイプはradio JRadioButton
入力、タイプはreset JButton
入力、タイプはsubmit JButton
入力、タイプはtext JTextField
選択、サイズは> 1、または複数の属性を定義 JScrollPane内のJList
選択、サイズは指定なし、または1 JComboBox
textarea JScrollPane内のJTextArea
入力、タイプはfile JTextField

  • ネストされたクラスのサマリー

    ネストされたクラス
    修飾子と型
    クラス
    説明
    protected class 
    FormView.MouseEventListener
    タイプがイメージである入力がクリックされたときにフォーム送信を扱うMouseEventListenerクラスです。

  • フィールドのサマリー

    フィールド
    修飾子と型
    フィールド
    説明
    static final String
    RESET
    非推奨。
    1.3から、値はUIManager UIManagerプロパティFormView.resetButtonTextから取得されます
    static final String
    SUBMIT
    非推奨。
    1.3で、値はUIManagerプロパティFormView.submitButtonTextから取得されるようになりました

    クラスビューで宣言されたフィールド

    BadBreakWeight, ExcellentBreakWeight, ForcedBreakWeight, GoodBreakWeight, X_AXIS, Y_AXIS
    修飾子と型
    フィールド
    説明
    static final int
    BadBreakWeight
    フォーマット目的とするには不完全な分割の機会であるビューを示すウエイトです。
    static final int
    ExcellentBreakWeight
    分割をサポートしているビューを示すウエイトで、分割するのに適した位置であることを表わしています。
    static final int
    ForcedBreakWeight
    分割をサポートしているビューを示すウエイトで、子を分割することで子をフォーマットするビューに配置されている場合に、ビューを正しく表わすには分割しなければいけません。
    static final int
    GoodBreakWeight
    分割をサポートしているビューを示すウエイトですが、もっと良い機会が存在する可能性があります。
    static final int
    X_AXIS
    フォーマット/分割処理の軸です。
    static final int
    Y_AXIS
    フォーマット/分割処理の軸です。

    インタフェースで宣言されたフィールド SwingConstants

    BOTTOM, CENTER, EAST, HORIZONTAL, LEADING, LEFT, NEXT, NORTH, NORTH_EAST, NORTH_WEST, PREVIOUS, RIGHT, SOUTH, SOUTH_EAST, SOUTH_WEST, TOP, TRAILING, VERTICAL, WEST
    修飾子と型
    フィールド
    説明
    static final int
    BOTTOM
    ボックスの下端を指定するために使用するボックス配置定数です。
    static final int
    CENTER
    領域内の中央位置です。
    static final int
    EAST
    東(右)の方角です。
    static final int
    HORIZONTAL
    水平方向です。
    static final int
    LEADING
    左から右に記述する言語および右から左に記述する言語で使用するテキストのリーディング・エッジを指定します。
    static final int
    LEFT
    ボックスの左端を指定するために使用するボックス配置定数です。
    static final int
    NEXT
    シーケンス内の次の方向を指定します。
    static final int
    NORTH
    北(上)の方角です。
    static final int
    NORTH_EAST
    北東(右上)の方角です。
    static final int
    NORTH_WEST
    北西(左上)の方角です。
    static final int
    PREVIOUS
    シーケンス内の前の方向を指定します。
    static final int
    RIGHT
    ボックスの右端を指定するために使用するボックス配置定数です。
    static final int
    SOUTH
    南(下)の方角です。
    static final int
    SOUTH_EAST
    南東(右下)の方角です。
    static final int
    SOUTH_WEST
    南西(左下)の方角です。
    static final int
    TOP
    ボックスの上端を指定するために使用するボックス配置定数です。
    static final int
    TRAILING
    左から右に記述する言語および右から左に記述する言語で使用するテキストのトレーリング・エッジを指定します。
    static final int
    VERTICAL
    垂直方向です。
    static final int
    WEST
    西(左)の方角です。

  • コンストラクタのサマリー

    コンストラクタ
    コンストラクタ
    説明
    FormView(Element elem)
    新しいFormViewオブジェクトを作成します。

  • メソッドのサマリー

    修飾子と型
    メソッド
    説明
    void
    actionPerformed(ActionEvent evt)
    ActionEventを処理します。
    protected Component
    createComponent()
    コンポーネントを作成します。
    float
    getMaximumSpan(int axis)
    このビューの最大スパンを軸に沿って指定します。
    protected void
    imageSubmit(String imageData)
    イメージをクリックすると、フォームを送信するために呼び出されます。すなわち、タイプが「image」の<INPUT>フォーム要素がクリックされたときに呼び出されます。
    protected void
    submitData(String data)
    このメソッドは、フォーム・データの送信を行います。

    クラスで宣言されたメソッド ComponentView

    getAlignment, getComponent, getMinimumSpan, getPreferredSpan, modelToView, paint, setParent, viewToModel
    修飾子と型
    メソッド
    説明
    float
    getAlignment(int axis)
    軸に沿ったこのビューの望ましいレイアウトを決定します。
    final Component
    getComponent()
    ビューに関連付けられたコンポーネントを取得します。
    float
    getMinimumSpan(int axis)
    このビューの最小スパンを軸に沿って指定します。
    float
    getPreferredSpan(int axis)
    このビューに適切なスパンを軸に沿って指定します。
    Shape
    modelToView(int pos, Shape a, Position.Bias b)
    モデルの座標空間から、ビューの座標空間へのマッピングを提供します。
    void
    paint(Graphics g, Shape a)
    実際のペイントの動作は通常、コンポーネントがその親コンテナ(このビューを収容するコンテナ)との関連付けから発生します。
    void
    setParent(View p)
    子ビューの親を設定します。
    int
    viewToModel(float x, float y, Shape a, Position.Bias[] bias)
    ビューの座標空間からモデルの論理座標空間へのマッピングを提供します。

    Viewクラスで宣言されたメソッド

    append, breakView, changedUpdate, createFragment, forwardUpdate, forwardUpdateToView, getAttributes, getBreakWeight, getChildAllocation, getContainer, getDocument, getElement, getEndOffset, getGraphics, getNextVisualPositionFrom, getParent, getResizeWeight, getStartOffset, getToolTipText, getView, getViewCount, getViewFactory, getViewIndex, getViewIndex, insert, insertUpdate, isVisible, modelToView, modelToView, preferenceChanged, remove, removeAll, removeUpdate, replace, setSize, updateChildren, updateLayout, viewToModel
    修飾子と型
    メソッド
    説明
    void
    append(View v)
    1つの子ビューを追加します。
    View
    breakView(int axis, int offset, float pos, float len)
    指定された軸でこのビューの分割を試みます。
    void
    changedUpdate(DocumentEvent e, Shape a, ViewFactory f)
    このビューが扱う位置で属性が変更されたことをドキュメントから通知します。
    View
    createFragment(int p0, int p1)
    要素の一部分を表すビューを作成します。
    protected void
    forwardUpdate(DocumentEvent.ElementChange ec, DocumentEvent e, Shape a, ViewFactory f)
    指定されたDocumentEventを、モデルへの変更について通知する必要のある子ビューに転送します。
    protected void
    forwardUpdateToView(View v, DocumentEvent e, Shape a, ViewFactory f)
    指定された子ビューにDocumentEventを転送します。
    AttributeSet
    getAttributes()
    描画するときに使用する属性を取得します。
    int
    getBreakWeight(int axis, float pos, float len)
    このビューで分割のウエイトがどのくらい適切かを示します。
    Shape
    getChildAllocation(int index, Shape a)
    指定された子ビューの割り当てを取得します。
    Container
    getContainer()
    ビューを収容するコンテナを取得します。
    Document
    getDocument()
    ビューに関連したモデルを取り出します。
    Element
    getElement()
    このビューがマッピングされる対象の構造部分を取り出します。
    int
    getEndOffset()
    このビューが扱うモデルの一部を取り出します。
    Graphics
    getGraphics()
    レンダリングのためのGraphicsを取得します。
    int
    getNextVisualPositionFrom(int pos, Position.Bias b, Shape a, int direction, Position.Bias[] biasRet)
    キャレットが配置される可能性のある、視覚的に表された次のモデル位置を決定する手段を提供します。
    View
    getParent()
    ビューの親を返します。
    int
    getResizeWeight(int axis)
    指定された軸に沿ってビューのサイズを変更できるかどうかを指定します。
    int
    getStartOffset()
    このビューが扱うモデルの一部を取り出します。
    String
    getToolTipText(float x, float y, Shape allocation)
    指定された位置にあるツールヒントのテキストを返します。
    View
    getView(int n)
    n番目の子ビューを取得します。
    int
    getViewCount()
    このビュー内のビューの数を返します。
    ViewFactory
    getViewFactory()
    ビュー階層を供給しているViewFactoryの実装を取り出します。
    int
    getViewIndex(float x, float y, Shape allocation)
    ビュー内の指定された位置を表す子ビュー・インデックスを返します。
    int
    getViewIndex(int pos, Position.Bias b)
    モデル内の指定された位置を表す子ビューのインデックスを返します。
    void
    insert(int offs, View v)
    1つの子ビューを挿入します。
    void
    insertUpdate(DocumentEvent e, Shape a, ViewFactory f)
    このビューが扱う位置でドキュメントに何かが挿入されたことを通知します。
    boolean
    isVisible()
    ビューが可視かどうかを示すboolean型の値を返します。
    Shape
    modelToView(int pos, Shape a)
    非推奨。 
    Shape
    modelToView(int p0, Position.Bias b0, int p1, Position.Bias b1, Shape a)
    指定した範囲について、ドキュメント・モデル座標空間からビュー座標空間へのマッピングを提供します。
    void
    preferenceChanged(View child, boolean width, boolean height)
    子ビューは親でこのメソッドを呼び出し、設定が変更されたこと、および再度レイアウトが考慮されなければならないことを示すことができます。
    void
    remove(int i)
    指定された位置にある子を1つ削除します。
    void
    removeAll()
    すべての子を削除します。
    void
    removeUpdate(DocumentEvent e, Shape a, ViewFactory f)
    このビューが扱うドキュメント内の位置から何かが削除されたということを通知します。
    void
    replace(int offset, int length, View[] views)
    子ビューを置換します。
    void
    setSize(float width, float height)
    ビューのサイズを設定します。
    protected boolean
    updateChildren(DocumentEvent.ElementChange ec, DocumentEvent e, ViewFactory f)
    モデルが変更されたという通知を受け取ると、子ビューを更新します。このビューが扱う要素の変更記録があります。
    protected void
    updateLayout(DocumentEvent.ElementChange ec, DocumentEvent e, Shape a)
    モデルから変更の通知を受け取った場合に、レイアウトを更新します。
    int
    viewToModel(float x, float y, Shape a)
    非推奨。 

    クラスオブジェクトで宣言されたメソッド

    clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
    修飾子と型
    メソッド
    説明
    protected Object
    clone()
    このオブジェクトのコピーを作成して、返します。
    boolean
    equals(Object obj)
    このオブジェクトと他のオブジェクトが等しいかどうかを示します。
    protected void
    finalize()
    削除予定のため非推奨: このAPI要素は、将来のバージョンで削除される可能性があります。
    最終決定は非推奨であり、将来のリリースで削除される可能性があります。
    final Class<?>
    getClass()
    このObjectの実行時クラスを返します。
    int
    hashCode()
    このオブジェクトに対するハッシュ・コード値を返します。
    final void
    notify()
    このオブジェクトのモニターで待機中のスレッドを1つ再開します。
    final void
    notifyAll()
    このオブジェクトのモニターで待機中のすべてのスレッドを再開します。
    String
    toString()
    オブジェクトの文字列表現を返します。
    final void
    wait()
    現在のスレッドが目覚めるまで待機します。通常、notifiedまたはinterruptedです。
    final void
    wait(long timeoutMillis)
    現在のスレッドは、通常、notifiedまたはinterruptedであるか、一定のリアルタイムが経過するまで、目覚めるまで待機します。
    final void
    wait(long timeoutMillis, int nanos)
    現在のスレッドは、通常、notifiedまたはinterruptedであるか、一定のリアルタイムが経過するまで、目覚めるまで待機します。

  • フィールド詳細

    • SUBMIT

      @Deprecated public static final String SUBMIT
      非推奨。
      1.3で、値はUIManagerプロパティFormView.submitButtonTextから取得されるようになりました
      タイプがsubmitであるFORMの入力要素で属性値が指定されていない場合に、このデフォルト文字列が使用されます。

    • RESET

      @Deprecated public static final String RESET
      非推奨。
      1.3から、値はUIManager UIManagerプロパティFormView.resetButtonTextから取得されます
      タイプがresetであるFORMの入力要素で属性値が指定されていない場合に、このデフォルト文字列が使用されます。

  • コンストラクタの詳細

    • FormView

      public FormView(Element elem)
      新しいFormViewオブジェクトを作成します。
      パラメータ:
      elem - デコレートされる要素

  • メソッドの詳細

    • createComponent

      protected Component createComponent()
      コンポーネントを作成します。 これは、基本的には大規模なswitch文であり、関連した要素のタグの種類と、htmlの属性に基づいて処理を分岐します。
      オーバーライド:
      createComponent、クラスComponentView
      戻り値:
      このビューに関連付けられているコンポーネント

    • getMaximumSpan

      public float getMaximumSpan(int axis)
      このビューの最大スパンを軸に沿って指定します。 コンポーネントの中には、最大スパンと適切なスパンが同一であるものがあります。 そのほかのコンポーネントでは、このメソッドは、該当する軸に沿って、Component.getMaximumSizeによって返された値を返します。
      オーバーライド:
      getMaximumSpan、クラスComponentView
      パラメータ:
      axis - View.X_AXISまたはView.Y_AXIS
      戻り値:
      ビューの描画先のスパン>= 0。 通常、ビューは返されたスパン内に描画されるよう求められるが、その保証はない。 親はビューのサイズの変更や分割を行う可能性がある。
      スロー:
      IllegalArgumentException - 軸が無効な場合
      関連項目:

    • actionPerformed

      public void actionPerformed(ActionEvent evt)
      ActionEventを処理します。 FormViewに関連した要素のタイプがsubmit、reset、text、またはpasswordのいずれかである場合に、アクションを処理します。 submitの場合は、フォームを送信します。 resetの場合は、フォームを元の状態にリセットします。 textまたはpasswordの場合は、その要素がtextまたはpasswordのタイプを持つ最後の要素であれば、フォームが送信されます。 それ以外の場合は、フォーム内の次のコンポーネントにフォーカスを移動します。
      定義:
      actionPerformed、インタフェースActionListener
      パラメータ:
      evt - ActionEvent。

    • submitData

      protected void submitData(String data)
      このメソッドは、フォーム・データの送信を行います。 送信を実行するためにスレッドが1つフォークされます。
      パラメータ:
      data - 送信するデータ

    • imageSubmit

      protected void imageSubmit(String imageData)
      イメージをクリックすると、フォームを送信するために呼び出されます。すなわち、タイプが「image」の<INPUT>フォーム要素がクリックされたときに呼び出されます。
      パラメータ:
      imageData - マウス・クリックの座標。