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()