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 版本才開始公開。

從以下版本開始：

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。

getNoImageIcon

public Icon getNoImageIcon()

如果不能找到圖像，則返回要使用的圖標。

getLoadingImageIcon

public Icon getLoadingImageIcon()

返回載入圖像過程中要使用的圖標。

getImage

public Image getImage()

返回要呈現的圖像。

setLoadsSynchronously

public void setLoadsSynchronously(boolean newValue)

設置如何載入圖像。如果 newValue 為 true，則圖像將在首次被請求時載入，否則將非同步載入。預設是不同步載入，也即非同步載入。

getLoadsSynchronously

public boolean getLoadsSynchronously()

如果圖像應該在首次被請求時載入，則返回 true。

getStyleSheet

protected StyleSheet getStyleSheet()

獲取 StyleSheet 的便捷方法。

getAttributes

public AttributeSet getAttributes()

獲取呈現時要使用的屬性。實作它的目的是為了使用 StyleSheet 多路傳輸模型中指定的屬性。

覆寫：

類別 View 中的 getAttributes

getToolTipText

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

對於圖像，工具提示文本來自於 ALT 屬性指定的文本。對其進行覆寫以返回 getAltText。

覆寫：

類別 View 中的 getToolTipText

另請參見：

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

setPropertiesFromAttributes

protected void setPropertiesFromAttributes()

更新來自屬性的任何快取記憶體的值。

setParent

public void setParent(View parent)

建立此視圖的父視圖。此時應該快取記憶體您所在的 AWT Container。

覆寫：

類別 View 中的 setParent

參數：

parent - 新的父級，如果要從父級中移除視圖，則為 null

changedUpdate

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

當 Elements 屬性已更改時調用。重新創建圖像。

覆寫：

類別 View 中的 changedUpdate

參數：

e - 發自關聯文檔的更改資訊

a - 視圖的當前分派

f - 視圖有子級時用於重建的處理器 View#changedUpdate

paint

public void paint(Graphics g,
                  Shape a)

繪製 View。

指定者：

類別 View 中的 paint

參數：

g - 要使用的呈現表面

a - 分派的要在其中呈現的區域

另請參見：

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

getPreferredSpan

public float getPreferredSpan(int axis)

確定此視圖沿某軸的首選區域。

指定者：

類別 View 中的 getPreferredSpan

參數：

axis - 可以是 X_AXIS，也可以是 Y_AXIS

返回：

要呈現該視圖的區域。通常會告知該視圖在返回的區域中呈現，但不保證一定如此；父視圖可以選擇調整或拆分視圖

另請參見：

View.getPreferredSpan(int)

getAlignment

public float getAlignment(int axis)

確定此視圖沿某個軸所需的調整值。實作此方法以使圖標底部沿 y 軸對齊，而預設是沿 x 軸對齊。

覆寫：

類別 View 中的 getAlignment

參數：

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

提供從文檔模型坐標空間到所映射的視圖坐標空間的映射。

指定者：

類別 View 中的 modelToView

參數：

pos - 要轉換的位置

a - 分派的要在其中呈現的區域

b - 當位置是兩個視圖的邊界時，該參數是離由偏移量表示的前一個字元或者下一個字元的偏差；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)

提供從視圖坐標空間到該模型的邏輯坐標空間的映射。

指定者：

類別 View 中的 viewToModel

參數：

x - X 坐標

y - Y 坐標

a - 要在其中呈現的分派區域

返回：

模型中最能代表視圖中給定點的位置

另請參見：

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

setSize

public void setSize(float width,
                    float height)

設置視圖的大小。如果此方法有任何佈局任務，則會導致佈局視圖。

覆寫：

類別 View 中的 setSize

參數：

width - 寬度，其值 >= 0

height - 高度，其值 >= 0