モジュール java.desktop

パッケージ javax.swing.text.html

クラスImageView

java.lang.Object

javax.swing.text.View

javax.swing.text.html.ImageView

すべての実装されたインタフェース:

SwingConstants

public class ImageView extends View

HTMLの<IMG>タグをサポートするためのイメージのビューです。 タグのHEIGHT属性とWIDTH属性によるスケーリングをサポートしています。 イメージをロードできない場合は、ALT属性で指定したテキストが描画されます。

このクラスはしばらくのあいだswingの一部でしたが、1.4ではpublicになりました。

導入されたバージョン:

1.4

関連項目:

• IconView

フィールドのサマリー

クラス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

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

コンストラクタ

コンストラクタ	説明
ImageView(Element elem)	IMG要素を表す新しいビューを作成します。

メソッドのサマリー

修飾子と型	メソッド	説明
void	changedUpdate(DocumentEvent e, Shape a, ViewFactory f)	Elements属性の変更時に呼び出されます。
float	getAlignment(int axis)	軸に沿ったこのビューの望ましいレイアウトを決定します。
String	getAltText()	イメージをロードできない場合に表示するテキストを返します。
AttributeSet	getAttributes()	描画するときに使用する属性を取得します。
Image	getImage()	描画するイメージを返します。
URL	getImageURL()	イメージ・ソースのURLを返します。判別できない場合はnullを返します。
Icon	getLoadingImageIcon()	イメージのロード処理中に使うアイコンを返します。
boolean	getLoadsSynchronously()	イメージが最初に要求されたときにロードされる必要がある場合は、trueを返します。
Icon	getNoImageIcon()	イメージが見つからない場合に使用するアイコンを返します。
float	getPreferredSpan(int axis)	このビューに適切なスパンを軸に沿って指定します。
protected StyleSheet	getStyleSheet()	StyleSheetを取得する便利なメソッド。
String	getToolTipText(float x, float y, Shape allocation)	イメージの場合、ツールヒントのテキストは、ALT属性で指定したテキストになります。
Shape	modelToView(int pos, Shape a, Position.Bias b)	ドキュメント・モデルの座標空間からビューの座標空間へのマッピングを提供します。
void	paint(Graphics g, Shape a)	Viewをペイントします。
void	setLoadsSynchronously(boolean newValue)	イメージのロード方法を設定します。
void	setParent(View parent)	このビューの親ビューを確立します。
protected void	setPropertiesFromAttributes()	属性に由来する値がキャッシュに書き込まれていれば、それを更新します。
void	setSize(float width, float height)	ビューのサイズを設定します。
int	viewToModel(float x, float y, Shape a, Position.Bias[] bias)	ビューの座標空間からモデルの論理座標空間へのマッピングを提供します。

クラスjavax.swing.text.Viewで宣言されたメソッド

append, breakView, createFragment, forwardUpdate, forwardUpdateToView, getBreakWeight, getChildAllocation, getContainer, getDocument, getElement, getEndOffset, getGraphics, getMaximumSpan, getMinimumSpan, getNextVisualPositionFrom, getParent, getResizeWeight, getStartOffset, getView, getViewCount, getViewFactory, getViewIndex, getViewIndex, insert, insertUpdate, isVisible, modelToView, modelToView, preferenceChanged, remove, removeAll, removeUpdate, replace, updateChildren, updateLayout, viewToModel

クラスjava.lang.Objectで宣言されたメソッド

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

コンストラクタの詳細

ImageView

public ImageView(Element elem)

IMG要素を表す新しいビューを作成します。

パラメータ:

elem - ビューを作成する要素

メソッドの詳細

getAltText

public String getAltText()

イメージをロードできない場合に表示するテキストを返します。 これは、属性名HTML.Attribute.ALTを持つElements属性セットから取得されます。

戻り値:

イメージをロードできない場合に表示するテスト。

getImageURL

public URL getImageURL()

イメージ・ソースのURLを返します。判別できない場合はnullを返します。

戻り値:

イメージ・ソースのURL、または判別できなかった場合はnull。

getNoImageIcon

public Icon getNoImageIcon()

イメージが見つからない場合に使用するアイコンを返します。

戻り値:

イメージが見つからない場合に使用するアイコン。

getLoadingImageIcon

public Icon getLoadingImageIcon()

イメージのロード処理中に使うアイコンを返します。

戻り値:

イメージのロード中に使用するアイコン。

getImage

public Image getImage()

描画するイメージを返します。

戻り値:

レンダリングするイメージ。

setLoadsSynchronously

public void setLoadsSynchronously(boolean newValue)

イメージのロード方法を設定します。 newValueがtrueの場合、イメージは最初に要求されたときにロードされ、それ以外の場合は非同期でロードされます。 デフォルトでは、イメージを同期的にロードしません(非同期にロードする)。

パラメータ:

newValue - trueの場合、イメージは最初に要求されたときにロードされ、それ以外の場合は非同期でロードされます。

getLoadsSynchronously

public boolean getLoadsSynchronously()

イメージが最初に要求されたときにロードされる必要がある場合は、trueを返します。

戻り値:

イメージが最初に要求されたときにロードされる場合は、true。

getStyleSheet

protected StyleSheet getStyleSheet()

StyleSheetを取得する便利なメソッド。

戻り値:

the StyleSheet

getAttributes

public AttributeSet getAttributes()

描画するときに使用する属性を取得します。 モデル内でStyleSheetにより指定される属性を多重化するために実装されます。

オーバーライド:

getAttributes、クラスView

戻り値:

レンダリング時に使用する属性

getToolTipText

public String getToolTipText(float x, float y, Shape allocation)

イメージの場合、ツールヒントのテキストは、ALT属性で指定したテキストになります。 これは、getAltTextを返すようにオーバーライドされます。

オーバーライド:

getToolTipText、クラスView

パラメータ:

x - x座標

y - y座標

allocation - ビューの現在の割当て。

戻り値:

指定されたロケーションのツールチップ・テキスト

関連項目:

• JTextComponent.getToolTipText(java.awt.event.MouseEvent)

setPropertiesFromAttributes

protected void setPropertiesFromAttributes()

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

setParent

public void setParent(View parent)

このビューの親ビューを確立します。 内部のAWT Containerのキャッシュは、このときに行われます。

オーバーライド:

setParent、クラスView

パラメータ:

parent - 新しい親。ビューが親から削除される場合はnull

changedUpdate

public void changedUpdate(DocumentEvent e, Shape a, ViewFactory f)

Elements属性の変更時に呼び出されます。 イメージを再作成します。

オーバーライド:

changedUpdate、クラスView

パラメータ:

e - 関連するドキュメントからの変更情報

a - ビューの現在の割当て

f - ビューが子を持つ場合に再構築に使用するファクトリ

関連項目:

• View.insertUpdate(javax.swing.event.DocumentEvent, java.awt.Shape, javax.swing.text.ViewFactory)
• View.removeUpdate(javax.swing.event.DocumentEvent, java.awt.Shape, javax.swing.text.ViewFactory)

paint

public void paint(Graphics g, Shape a)

Viewをペイントします。

定義:

paint、クラスView

パラメータ:

g - 使用する描画表面

a - 描画するために割り当てられた領域

関連項目:

• View.paint(java.awt.Graphics, java.awt.Shape)

getPreferredSpan

public float getPreferredSpan(int axis)

このビューに適切なスパンを軸に沿って指定します。

定義:

getPreferredSpan、クラスView

パラメータ:

axis - X_AXISまたはY_AXIS

戻り値:

ビューの描画先のスパン。通常、ビューは返されたスパン内に描画されるよう求められるが、その保証はない。親はビューのサイズの変更や分割を行う可能性がある

getAlignment

public float getAlignment(int axis)

軸に沿ったこのビューの望ましいレイアウトを決定します。 これを実装すると、y軸に沿ってアイコンの下端を配置し、x軸に沿ってデフォルトの配置を実行できます。

オーバーライド:

getAlignment、クラスView

パラメータ:

axis - X_AXISまたはY_AXIS

戻り値:

望ましい配置。この値の範囲は0.0 - 1.0で、0は起点への配置、1.0は起点から最大に離れた配置を表す。0.5はビューの中央への配置になる

modelToView

public Shape modelToView(int pos, Shape a, Position.Bias b) throws BadLocationException

ドキュメント・モデルの座標空間からビューの座標空間へのマッピングを提供します。

定義:

modelToView、クラスView

パラメータ:

pos - 変換対象の位置

a - 描画するために割り当てられた領域

b - 位置が2つのビューの境界である場合に、オフセットによって表される直前の文字または次の文字へのバイアス。bの値は次のどれかになる。

• Position.Bias.Forward
• Position.Bias.Backward

戻り値:

指定された位置のバウンディング・ボックス

例外:

BadLocationException - 指定された位置が、関連するドキュメント内の有効な位置を示さない場合

関連項目:

• View.modelToView(int, java.awt.Shape, javax.swing.text.Position.Bias)

viewToModel

public int viewToModel(float x, float y, Shape a, Position.Bias[] bias)

ビューの座標空間からモデルの論理座標空間へのマッピングを提供します。

定義:

viewToModel、クラスView

パラメータ:

x - X座標

y - Y座標

a - 描画するために割り当てられた領域

bias - 戻りバイアス

戻り値:

指定されたビュー内の点をもっとも適切に表現するモデル内の位置

関連項目:

• View.viewToModel(float, float, java.awt.Shape, javax.swing.text.Position.Bias[])

setSize

public void setSize(float width, float height)

ビューのサイズを設定します。 レイアウトの必要がある場合はビューのレイアウトを表示します。

オーバーライド:

setSize、クラスView

パラメータ:

width - 幅>= 0

height - 高さ>= 0