モジュール java.desktop
パッケージ javax.swing.text.html

クラスImageView

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

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

    導入されたバージョン:
    1.4
    関連項目:
    IconView

    • コンストラクタの詳細

      • 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を取得するための便利なメソッド。
        戻り値:
        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

      • getPreferredSpan

        public float getPreferredSpan​(int axis)
        このビューに適切なスパンを軸に沿って指定します。
        定義:
        getPreferredSpan、クラスView
        パラメータ:
        axis - X_AXISまたはY_AXIS
        戻り値:
        ビューの描画先のスパン。通常、ビューは返されたスパン内に描画されるよう求められるが、その保証はない。親はビューのサイズの変更や分割を行う可能性がある
        関連項目:
        View.getPreferredSpan(int)

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

      • setSize

        public void setSize​(float width,
                    float height)
        ビューのサイズを設定します。 レイアウトの必要がある場合はビューのレイアウトを表示します。
        オーバーライド:
        setSize、クラスView
        パラメータ:
        width - 幅>= 0
        height - 高さ>= 0