JavaTM 2
Platform
Std. Ed. v1.4.0

javax.swing.text.html
クラス BlockView

java.lang.Object
  |
  +--javax.swing.text.View
        |
        +--javax.swing.text.CompositeView
              |
              +--javax.swing.text.BoxView
                    |
                    +--javax.swing.text.html.BlockView
すべての実装インタフェース:
SwingConstants
直系の既知のサブクラス:
ListView

public class BlockView
extends BoxView

CSS 仕様を使い、ブロックをボックスとして表示するためのビューの実装です。


フィールドの概要
 
クラス javax.swing.text.View から継承したフィールド
BadBreakWeight, ExcellentBreakWeight, ForcedBreakWeight, GoodBreakWeight, X_AXIS, Y_AXIS
 
インタフェース javax.swing.SwingConstants から継承したフィールド
BOTTOM, CENTER, EAST, HORIZONTAL, LEADING, LEFT, NEXT, NORTH, NORTH_EAST, NORTH_WEST, PREVIOUS, RIGHT, SOUTH, SOUTH_EAST, SOUTH_WEST, TOP, TRAILING, VERTICAL, WEST
 
コンストラクタの概要
BlockView(Element elem, int axis)
          HTML ボックスを表す新しいビューを作成します。
 
メソッドの概要
protected  SizeRequirements calculateMajorAxisRequirements(int axis, SizeRequirements r)
          主軸 (タイリングの基準にある軸) に沿ったブロックの必要サイズを計算します。
protected  SizeRequirements calculateMinorAxisRequirements(int axis, SizeRequirements r)
          副軸 (タイリングされた軸に直角の軸) に沿ったブロックの必要サイズを計算します。
 void changedUpdate(DocumentEvent changes, Shape a, ViewFactory f)
          このビューが扱う位置でドキュメントの属性が変更されたことを通知します。
 float getAlignment(int axis)
          配置方法を返します。
 AttributeSet getAttributes()
          描画で使用する属性を取り出します。
 float getMaximumSpan(int axis)
          このビューの最大スパンを軸に沿って指定します。
 float getMinimumSpan(int axis)
          このビューの最小スパンを軸に沿って指定します。
 float getPreferredSpan(int axis)
          このビューに適切なスパンを軸に沿って指定します。
 int getResizeWeight(int axis)
          サイズ変更のウェイトを返します。
protected  StyleSheet getStyleSheet()
           
protected  void layoutMinorAxis(int targetSpan, int axis, int[] offsets, int[] spans)
          ボックスの副軸 (つまり、それが表す軸に直角の軸) をレイアウトします。
 void paint(Graphics g, Shape allocation)
          指定された描画表面とその領域を使って描画します。
 void setParent(View parent)
          このビューに使用する親ビューを確立します。
protected  void setPropertiesFromAttributes()
          属性に由来する値がキャッシュに書き込まれていれば、それを更新します。
 
クラス javax.swing.text.BoxView から継承したメソッド
baselineLayout, baselineRequirements, childAllocation, flipEastAndWestAtEnds, forwardUpdate, getAxis, getChildAllocation, getHeight, getOffset, getSpan, getViewAtPoint, getWidth, isAfter, isAllocationValid, isBefore, isLayoutValid, layout, layoutChanged, layoutMajorAxis, modelToView, paintChild, preferenceChanged, replace, setAxis, setSize, viewToModel
 
クラス javax.swing.text.CompositeView から継承したメソッド
getBottomInset, getInsideAllocation, getLeftInset, getNextEastWestVisualPositionFrom, getNextNorthSouthVisualPositionFrom, getNextVisualPositionFrom, getRightInset, getTopInset, getView, getViewAtPosition, getViewCount, getViewIndex, getViewIndexAtPosition, loadChildren, modelToView, setInsets, setParagraphInsets
 
クラス javax.swing.text.View から継承したメソッド
append, breakView, createFragment, forwardUpdateToView, getBreakWeight, getContainer, getDocument, getElement, getEndOffset, getGraphics, getParent, getStartOffset, getToolTipText, getViewFactory, getViewIndex, insert, insertUpdate, isVisible, modelToView, remove, removeAll, removeUpdate, updateChildren, updateLayout, viewToModel
 
クラス java.lang.Object から継承したメソッド
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

コンストラクタの詳細

BlockView

public BlockView(Element elem,
                 int axis)
HTML ボックスを表す新しいビューを作成します。多くの要素で使用できます。

パラメータ:
elem - ビューを作成する要素
axis - View.X_AXIS または View.Y_AXIS
メソッドの詳細

setParent

public void setParent(View parent)
このビューに使用する親ビューを確立します。親ビューが正常に機能している場合、このメソッドは他のメソッドより先に呼び出されることが保証されます。

このメソッドは、スーパークラスへの転送のために実装されます。また setPropertiesFromAttributes() メソッドを呼び出して CSS 属性から段落プロパティを設定するために実装されます。呼び出しがこのタイミングで行われるのは、上位方向のすべての親ビューの属性で解決できることを保証するためです。

オーバーライド:
クラス CompositeView 内の setParent
パラメータ:
parent - 新しい親。ビューが以前に追加された親から削除される場合は null

calculateMajorAxisRequirements

protected SizeRequirements calculateMajorAxisRequirements(int axis,
                                                          SizeRequirements r)
主軸 (タイリングの基準にある軸) に沿ったブロックの必要サイズを計算します。実装してスーパークラスの動作を提供してから、CSS の幅または高さの属性が指定されて、この軸に適用される場合は調整します。

オーバーライド:
クラス BoxView 内の calculateMajorAxisRequirements
パラメータ:
axis - 調査中の軸
r - SizeRequirements オブジェクト。null の場合、1 つ作成される
戻り値:
新しく初期化された SizeRequirements オブジェクト
関連項目:
SizeRequirements

calculateMinorAxisRequirements

protected SizeRequirements calculateMinorAxisRequirements(int axis,
                                                          SizeRequirements r)
副軸 (タイリングされた軸に直角の軸) に沿ったブロックの必要サイズを計算します。実装してスーパークラスの動作を提供してから、CSS の幅または高さの属性が指定されて、この軸に適用される場合は調整します。

オーバーライド:
クラス BoxView 内の calculateMinorAxisRequirements
パラメータ:
axis - 調査中の軸
r - SizeRequirements オブジェクト。null の場合、1 つ作成される
戻り値:
新しく初期化された SizeRequirements オブジェクト
関連項目:
SizeRequirements

layoutMinorAxis

protected void layoutMinorAxis(int targetSpan,
                               int axis,
                               int[] offsets,
                               int[] spans)
ボックスの副軸 (つまり、それが表す軸に直角の軸) をレイアウトします。レイアウトの結果は、副軸に沿った子への割り当てを表す配列に配置されなければなりません。

オーバーライド:
クラス BoxView 内の layoutMinorAxis
パラメータ:
targetSpan - ビューに指定されたスパンの合計。子をレイアウトするために使用される
axis - レイアウトされる軸
offsets - 各子ビューのビューの起点からのオフセット。これは戻り値であり、このメソッドの実装によって割り当てられる
spans - 各子ビューのスパン。これは戻り値であり、このメソッドの実装によって割り当てられる
戻り値:
offsets パラメータには各子ビューのオフセット、spans パラメータには各子ビューのスパン

paint

public void paint(Graphics g,
                  Shape allocation)
指定された描画表面とその領域を使って描画します。CSS ボックスペインタに権限を委譲して、内部より先に境界およびバックグラウンドを描画するために実装されます。

オーバーライド:
クラス BoxView 内の paint
パラメータ:
g - 使用する描画表面
allocation - 描画のために割り当てられた領域
関連項目:
View.paint(java.awt.Graphics, java.awt.Shape)

getAttributes

public AttributeSet getAttributes()
描画で使用する属性を取り出します。モデル内で StyleSheet により指定される属性を多重化するために実装されます。

オーバーライド:
クラス View 内の getAttributes

getResizeWeight

public int getResizeWeight(int axis)
サイズ変更のウェイトを返します。

オーバーライド:
クラス BoxView 内の getResizeWeight
パラメータ:
axis - X_AXIS または Y_AXIS
戻り値:
ウェイト
例外:
IllegalArgumentException - 軸が無効な場合

getAlignment

public float getAlignment(int axis)
配置方法を返します。

オーバーライド:
クラス BoxView 内の getAlignment
パラメータ:
axis - X_AXIS または Y_AXIS
戻り値:
配置方法

changedUpdate

public void changedUpdate(DocumentEvent changes,
                          Shape a,
                          ViewFactory f)
クラス View の記述:
このビューが扱う位置でドキュメントの属性が変更されたことを通知します。サブクラスへの負荷を軽くするため、この機能は、サブクラスが再実装できる以下の呼び出しに拡張されます。
  1. このビューが扱う要素に対して変更があった場合、updateChildren が呼び出される。このビューが、子の要素を示す子ビューを持つ場合、子ビューが正しくモデルを表すように、このメソッドは必要なことをすべて実行する
  2. DocumentEvent を適切な子ビューに転送するために、forwardUpdate が呼び出される
  3. ビューのレイアウトを修復、再スケジュール、または何も処理しないための機会をビューに与えるために、updateLayout が呼び出される

オーバーライド:
クラス View 内の changedUpdate
パラメータ:
changes - 関連するドキュメントからの変更情報
a - ビューの現在の割り当て
f - ビューが子を持つ場合に再構築に使用するファクトリ
関連項目:
View.changedUpdate(javax.swing.event.DocumentEvent, java.awt.Shape, javax.swing.text.ViewFactory)

getPreferredSpan

public float getPreferredSpan(int axis)
このビューに適切なスパンを軸に沿って指定します。

オーバーライド:
クラス BoxView 内の getPreferredSpan
パラメータ:
axis - View.X_AXIS または View.Y_AXIS
戻り値:
ビューの描画対象のスパン >= 0。通常、ビューは返されたスパン内に描画されることになるが、保証はない。親はビューのサイズ変更や分割を行う可能性がある
例外:
IllegalArgumentException - 軸が無効な型

getMinimumSpan

public float getMinimumSpan(int axis)
このビューの最小スパンを軸に沿って指定します。

オーバーライド:
クラス BoxView 内の getMinimumSpan
パラメータ:
axis - View.X_AXIS または View.Y_AXIS
戻り値:
ビューの描画対象のスパン >= 0。通常、ビューは返されたスパン内に描画されることになるが、保証はない。親はビューのサイズ変更や分割を行う可能性がある
例外:
IllegalArgumentException - 軸が無効な型

getMaximumSpan

public float getMaximumSpan(int axis)
このビューの最大スパンを軸に沿って指定します。

オーバーライド:
クラス BoxView 内の getMaximumSpan
パラメータ:
axis - View.X_AXIS または View.Y_AXIS
戻り値:
ビューの描画対象のスパン >= 0。通常、ビューは返されたスパン内に描画されることになるが、保証はない。親はビューのサイズ変更や分割を行う可能性がある
例外:
IllegalArgumentException - 軸が無効な型

setPropertiesFromAttributes

protected void setPropertiesFromAttributes()
属性に由来する値がキャッシュに書き込まれていれば、それを更新します。


getStyleSheet

protected StyleSheet getStyleSheet()

JavaTM 2
Platform
Std. Ed. v1.4.0

バグの報告と機能のリクエスト
これ以外の API リファレンスおよび開発者用ドキュメントについては、 Java 2 SDK SE 開発者用ドキュメントを参照してください。 開発者向けの詳細な解説、概念の概要、用語の定義、バグの回避策、 およびコード実例が含まれています。

Java、Java 2D、および JDBC は米国ならびにその他の国における米国 Sun Microsystems, Inc. の商標もしくは登録商標です。
Copyright 1993-2002 Sun Microsystems, Inc. 901 San Antonio Road
Palo Alto, California, 94303, U.S.A. All Rights Reserved.