SwingConstants
public class ImageView extends View
ALT
attribute will be rendered. While this class has been part of swing for a while now, it is public as of 1.4.
BadBreakWeight, ExcellentBreakWeight, ForcedBreakWeight, GoodBreakWeight, X_AXIS, Y_AXIS
BOTTOM, CENTER, EAST, HORIZONTAL, LEADING, LEFT, NEXT, NORTH, NORTH_EAST, NORTH_WEST, PREVIOUS, RIGHT, SOUTH, SOUTH_EAST, SOUTH_WEST, TOP, TRAILING, VERTICAL, WEST
Constructor | Description |
---|---|
ImageView |
Creates a new view that represents an IMG element. |
Modifier and Type | Method | Description |
---|---|---|
void |
changedUpdate |
Invoked when the Elements attributes have changed. |
float |
getAlignment |
Determines the desired alignment for this view along an axis. |
String |
getAltText() |
Returns the text to display if the image cannot be loaded. |
AttributeSet |
getAttributes() |
Fetches the attributes to use when rendering. |
Image |
getImage() |
Returns the image to render. |
URL |
getImageURL() |
Return a URL for the image source, or null if it could not be determined. |
Icon |
getLoadingImageIcon() |
Returns the icon to use while in the process of loading the image. |
boolean |
getLoadsSynchronously() |
Returns true if the image should be loaded when first asked for. |
Icon |
getNoImageIcon() |
Returns the icon to use if the image could not be found. |
float |
getPreferredSpan |
Determines the preferred span for this view along an axis. |
protected StyleSheet |
getStyleSheet() |
Convenient method to get the StyleSheet. |
String |
getToolTipText |
For images the tooltip text comes from text specified with the ALT attribute. |
Shape |
modelToView |
Provides a mapping from the document model coordinate space to the coordinate space of the view mapped to it. |
void |
paint |
Paints the View. |
void |
setLoadsSynchronously |
Sets how the image is loaded. |
void |
setParent |
Establishes the parent view for this view. |
protected void |
setPropertiesFromAttributes() |
Update any cached values that come from attributes. |
void |
setSize |
Sets the size of the view. |
int |
viewToModel |
Provides a mapping from the view coordinate space to the logical coordinate space of the model. |
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
public ImageView(Element elem)
elem
- the element to create a view forpublic String getAltText()
HTML.Attribute.ALT
.public URL getImageURL()
public Icon getNoImageIcon()
public Icon getLoadingImageIcon()
public Image getImage()
public void setLoadsSynchronously(boolean newValue)
newValue
is true, the image will be loaded when first asked for, otherwise it will be loaded asynchronously. The default is to not load synchronously, that is to load the image asynchronously.newValue
- if true
the image will be loaded when first asked for, otherwise it will be asynchronously.public boolean getLoadsSynchronously()
true
if the image should be loaded when first asked for.true
if the image should be loaded when first asked for.protected StyleSheet getStyleSheet()
public AttributeSet getAttributes()
getAttributes
in class View
public String getToolTipText(float x, float y, Shape allocation)
ALT
attribute. This is overridden to return getAltText
.getToolTipText
in class View
x
- the x coordinatey
- the y coordinateallocation
- current allocation of the View.protected void setPropertiesFromAttributes()
public void setParent(View parent)
public void changedUpdate(DocumentEvent e, Shape a, ViewFactory f)
changedUpdate
in class View
e
- the change information from the associated documenta
- the current allocation of the viewf
- the factory to use to rebuild if the view has childrenpublic void paint(Graphics g, Shape a)
public float getPreferredSpan(int axis)
getPreferredSpan
in class View
axis
- may be either X_AXIS or Y_AXISpublic float getAlignment(int axis)
getAlignment
in class View
axis
- may be either X_AXIS or Y_AXISpublic Shape modelToView(int pos, Shape a, Position.Bias b) throws BadLocationException
modelToView
in class View
pos
- the position to converta
- the allocated region to render intob
- 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
BadLocationException
- if the given position does not represent a valid location in the associated documentpublic int viewToModel(float x, float y, Shape a, Position.Bias[] bias)
viewToModel
in class View
x
- the X coordinatey
- the Y coordinatea
- the allocated region to render intobias
- the returned biaspublic void setSize(float width, float height)
© 1993, 2023, Oracle and/or its affiliates. All rights reserved.
Documentation extracted from Debian's OpenJDK Development Kit package.
Licensed under the GNU General Public License, version 2, with the Classpath Exception.
Various third party code in OpenJDK is licensed under different licenses (see Debian package).
Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.
https://docs.oracle.com/en/java/javase/21/docs/api/java.desktop/javax/swing/text/html/ImageView.html