Module java.desktop
Package javax.swing.text.html

Class 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版本起:
1.4
参见:

  • Constructor Details

    • ImageView

      public ImageView(Element elem)
      创建一个表示IMG元素的新视图。
      参数:
      elem - 要为其创建视图的元素

  • Method Details

    • 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的便捷方法。
      返回:
      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 - 视图的当前分配
      返回:
      指定位置的工具提示文本
      参见:

    • setPropertiesFromAttributes

      protected void setPropertiesFromAttributes()
      更新来自属性的任何缓存值。

    • setParent

      public void setParent(View parent)
      为此视图建立父视图。在此时缓存我所在的AWT容器。
      覆盖:
      setParent 在类 View中
      参数:
      parent - 新的父级，如果视图正在从父级中移除，则为null

    • changedUpdate

      public void changedUpdate(DocumentEvent e, Shape a, ViewFactory f)
      当元素属性发生变化时调用。重新创建图像。
      覆盖:
      changedUpdate 在类 View中
      参数:
      e - 关联文档的更改信息
      a - 视图的当前分配
      f - 如果视图有子项，则用于重建的工厂
      参见:

    • paint

      public void paint(Graphics g, Shape a)
      绘制视图。
      指定者:
      paint 在类 View中
      参数:
      g - 要使用的渲染表面
      a - 要渲染到的分配区域
      参见:

    • 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
      提供从文档模型坐标空间到其映射视图的坐标空间的映射。
      Specified by:
      modelToView in class View
      Parameters:
      pos - the position to convert
      a - the allocated region to render into
      b - the bias toward the previous character or the next character represented by the offset, in case the position is a boundary of two views; b will have one of these values:
      • Position.Bias.Forward
      • Position.Bias.Backward
      Returns:
      the bounding box of the given position
      Throws:
      BadLocationException - if the given position does not represent a valid location in the associated document
      See Also:

    • viewToModel

      public int viewToModel(float x, float y, Shape a, Position.Bias[] bias)
      Provides a mapping from the view coordinate space to the logical coordinate space of the model.
      指定者:
      viewToModel 在类 View
      参数:
      x - X坐标
      y - Y坐标
      a - 分配的渲染区域
      bias - 返回的偏好
      返回:
      最能代表给定视图点的模型内位置
      参见:

    • setSize

      public void setSize(float width, float height)
      设置视图的大小。如果视图有任何布局任务，这应该导致视图的布局。
      覆盖:
      setSize 在类 View
      参数:
      width - 宽度 >= 0
      height - 高度 >= 0