public class HtmlImage extends HtmlElement
HtmlElement.DisplayStyle
DomElement.ChildElementsIterator
DomNode.ChildIterator, DomNode.DescendantElementsIterator<T extends DomNode>
Modifier and Type | Field and Description |
---|---|
static String |
TAG_NAME
The HTML tag represented by this element.
|
static String |
TAG_NAME2
Another HTML tag represented by this element.
|
TAB_INDEX_OUT_OF_BOUNDS
ATTRIBUTE_NOT_DEFINED, ATTRIBUTE_VALUE_EMPTY
AS_TEXT_BLANK, AS_TEXT_BLOCK_SEPARATOR, AS_TEXT_NEW_LINE, AS_TEXT_TAB, PROPERTY_ELEMENT, READY_STATE_COMPLETE, READY_STATE_INTERACTIVE, READY_STATE_LOADED, READY_STATE_LOADING, READY_STATE_UNINITIALIZED
ATTRIBUTE_NODE, CDATA_SECTION_NODE, COMMENT_NODE, DOCUMENT_FRAGMENT_NODE, DOCUMENT_NODE, DOCUMENT_POSITION_CONTAINED_BY, DOCUMENT_POSITION_CONTAINS, DOCUMENT_POSITION_DISCONNECTED, DOCUMENT_POSITION_FOLLOWING, DOCUMENT_POSITION_IMPLEMENTATION_SPECIFIC, DOCUMENT_POSITION_PRECEDING, DOCUMENT_TYPE_NODE, ELEMENT_NODE, ENTITY_NODE, ENTITY_REFERENCE_NODE, NOTATION_NODE, PROCESSING_INSTRUCTION_NODE, TEXT_NODE
Modifier and Type | Method and Description |
---|---|
Page |
click()
Simulates clicking this element at the position (0, 0).
|
Page |
click(int x,
int y)
Simulates clicking this element at the specified position.
|
protected boolean |
doClickStateUpdate()
Performs the click action on the enclosing A tag (if any).
|
void |
doOnLoad()
INTERNAL API - SUBJECT TO CHANGE AT ANY TIME - USE AT YOUR OWN RISK.
|
String |
getAlignAttribute()
Returns the value of the attribute "align".
|
String |
getAltAttribute()
Returns the value of the attribute "alt".
|
String |
getBorderAttribute()
Returns the value of the attribute "border".
|
boolean |
getComplete() |
HtmlElement.DisplayStyle |
getDefaultStyleDisplay()
INTERNAL API - SUBJECT TO CHANGE AT ANY TIME - USE AT YOUR OWN RISK.
Returns the default display style. |
int |
getHeight()
Returns the image's actual height (not the image's
height attribute ). |
String |
getHeightAttribute()
Returns the value of the attribute "height".
|
String |
getHspaceAttribute()
Returns the value of the attribute "hspace".
|
ImageReader |
getImageReader()
Returns the ImageReader which can be used to read the image contained by this image element.
|
String |
getIsmapAttribute()
Returns the value of the attribute "ismap".
|
String |
getLocalName() |
String |
getLongDescAttribute()
Returns the value of the attribute "longdesc".
|
String |
getNameAttribute()
Returns the value of the attribute "name".
|
String |
getOriginalQualifiedName()
Returns the original element qualified name,
this is needed to differentiate between img and image.
|
String |
getSrcAttribute()
Returns the value of the attribute "src".
|
String |
getUseMapAttribute()
Returns the value of the attribute "usemap".
|
String |
getVspaceAttribute()
Returns the value of the attribute "vspace".
|
WebResponse |
getWebResponse(boolean downloadIfNeeded)
Returns the WebResponse for the image contained by this image element.
|
int |
getWidth()
Returns the image's actual width (not the image's
width attribute ). |
String |
getWidthAttribute()
Returns the value of the attribute "width".
|
boolean |
isDisplayed()
Returns true if this node is displayed and can be visible to the user
(ignoring screen size, scrolling limitations, color, font-size, or overlapping nodes).
|
void |
markAsCreatedByJavascript()
INTERNAL API - SUBJECT TO CHANGE AT ANY TIME - USE AT YOUR OWN RISK.
Marks this frame as created by javascript. |
protected void |
onAddedToPage()
Lifecycle method invoked whenever a node is added to a page.
|
void |
saveAs(File file)
Saves this image as the specified file.
|
void |
setAttributeNS(String namespaceURI,
String qualifiedName,
String value)
Sets the value of the specified attribute.
|
boolean |
wasCreatedByJavascript()
INTERNAL API - SUBJECT TO CHANGE AT ANY TIME - USE AT YOUR OWN RISK.
Returns true if this frame was created by javascript. |
addHtmlAttributeChangeListener, appendChildIfNoneExists, blur, checkChildHierarchy, click, click, dblClick, dblClick, doClickFireChangeEvent, doClickFireClickEvent, doType, fireEvent, fireEvent, fireHtmlAttributeAdded, fireHtmlAttributeRemoved, fireHtmlAttributeReplaced, focus, getCanonicalXPath, getElementsByAttribute, getEnclosingElement, getEnclosingForm, getEnclosingFormOrDie, getEventTargetElement, getHtmlElementsByTagName, getHtmlElementsByTagNames, getLangAttribute, getNodeName, getOnClickAttribute, getOnDblClickAttribute, getOneHtmlElementByAttribute, getOnKeyDownAttribute, getOnKeyPressAttribute, getOnKeyUpAttribute, getOnMouseDownAttribute, getOnMouseMoveAttribute, getOnMouseOutAttribute, getOnMouseOverAttribute, getOnMouseUpAttribute, getSrcAttributeNormalized, getTabIndex, getTextDirectionAttribute, getXmlLangAttribute, hasEventHandlers, isAttributeCaseSensitive, isStateUpdateFirst, isSubmittableByEnter, mouseDown, mouseDown, mouseMove, mouseMove, mouseOut, mouseOut, mouseOver, mouseOver, mouseUp, mouseUp, preventDefault, propagateClickStateUpdateToParent, querySelector, querySelectorAll, removeAttribute, removeChild, removeEventHandler, removeHtmlAttributeChangeListener, rightClick, rightClick, setAttributeNode, setEventHandler, setEventHandler, setId, toString, type, type, type, type, type, type
cloneNode, getAttribute, getAttributeNode, getAttributeNodeNS, getAttributeNS, getAttributes, getAttributesMap, getChildElementCount, getChildElements, getElementsByTagName, getElementsByTagNameNS, getFirstElementChild, getId, getLastElementChild, getNextElementSibling, getNodeType, getPreviousElementSibling, getSchemaTypeInfo, getTagName, hasAttribute, hasAttributeNS, hasAttributes, isEmptyXmlTagExpanded, namespaces, printOpeningTagContentAsXml, printXml, removeAttributeNode, removeAttributeNS, setAttribute, setAttributeNodeNS, setIdAttribute, setIdAttributeNode, setIdAttributeNS
getNamespaceURI, getPrefix, getQualifiedName, processImportNode, setPrefix
addDomChangeListener, appendChild, asText, asXml, compareDocumentPosition, detach, fireNodeAdded, fireNodeDeleted, getAncestors, getBaseURI, getByXPath, getByXPath, getChildNodes, getChildren, getDescendants, getEndColumnNumber, getEndLineNumber, getFeature, getFirstByXPath, getFirstByXPath, getFirstChild, getHtmlElementDescendants, getHtmlPageOrNull, getIndex, getLastChild, getNextSibling, getNodeValue, getOwnerDocument, getPage, getParentNode, getPreviousSibling, getReadyState, getScriptObject, getStartColumnNumber, getStartLineNumber, getTextContent, getUserData, hasChildNodes, hasFeature, insertBefore, insertBefore, isAncestorOf, isAncestorOfAny, isBlock, isDefaultNamespace, isDescendant, isDirectlyAttachedToPage, isEqualNode, isSameNode, isSupported, isTrimmedText, lookupNamespaceURI, lookupPrefix, mayBeDisplayed, normalize, notifyIncorrectness, onAddedToDocumentFragment, onAllChildrenAddedToPage, printChildrenAsXml, remove, removeAllChildren, removeChild, removeDomChangeListener, replace, replaceChild, setNextSibling, setNodeValue, setParentNode, setPreviousSibling, setReadyState, setScriptObject, setTextContent, setUserData
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait
appendChild, compareDocumentPosition, getBaseURI, getChildNodes, getFeature, getFirstChild, getLastChild, getNamespaceURI, getNextSibling, getNodeValue, getOwnerDocument, getParentNode, getPrefix, getPreviousSibling, getTextContent, getUserData, hasChildNodes, insertBefore, isDefaultNamespace, isEqualNode, isSameNode, isSupported, lookupNamespaceURI, lookupPrefix, normalize, removeChild, replaceChild, setNodeValue, setPrefix, setTextContent, setUserData
public static final String TAG_NAME
public static final String TAG_NAME2
protected void onAddedToPage()
onAddedToPage
in class DomNode
public void setAttributeNS(String namespaceURI, String qualifiedName, String value)
setAttributeNS
in interface Element
setAttributeNS
in class HtmlElement
namespaceURI
- the URI that identifies an XML namespacequalifiedName
- the qualified name of the attributevalue
- the value of the attributepublic void doOnLoad()
INTERNAL API - SUBJECT TO CHANGE AT ANY TIME - USE AT YOUR OWN RISK.
Executes this element's onload handler if it has one. This method also downloads the image if this element has an onload handler (prior to invoking said handler), because applications sometimes use images to send information to the server and use the onload handler to get notified when the information has been received by the server.
See here and here for the discussion which lead up to this method.
This method may be called multiple times, but will only attempt to execute the onload handler the first time it is invoked.
public final String getSrcAttribute()
public final String getAltAttribute()
public final String getNameAttribute()
public final String getLongDescAttribute()
public final String getHeightAttribute()
public final String getWidthAttribute()
public final String getUseMapAttribute()
public final String getIsmapAttribute()
public final String getAlignAttribute()
public final String getBorderAttribute()
public final String getHspaceAttribute()
public final String getVspaceAttribute()
public int getHeight() throws IOException
Returns the image's actual height (not the image's height attribute
).
POTENTIAL PERFORMANCE KILLER - DOWNLOADS THE IMAGE - USE AT YOUR OWN RISK
If the image has not already been downloaded, this method triggers a download and caches the image.
IOException
- if an error occurs while downloading or reading the imagepublic int getWidth() throws IOException
Returns the image's actual width (not the image's width attribute
).
POTENTIAL PERFORMANCE KILLER - DOWNLOADS THE IMAGE - USE AT YOUR OWN RISK
If the image has not already been downloaded, this method triggers a download and caches the image.
IOException
- if an error occurs while downloading or reading the imagepublic ImageReader getImageReader() throws IOException
Returns the ImageReader which can be used to read the image contained by this image element.
POTENTIAL PERFORMANCE KILLER - DOWNLOADS THE IMAGE - USE AT YOUR OWN RISK
If the image has not already been downloaded, this method triggers a download and caches the image.
IOException
- if an error occurs while downloading or reading the imagepublic WebResponse getWebResponse(boolean downloadIfNeeded) throws IOException
Returns the WebResponse for the image contained by this image element.
POTENTIAL PERFORMANCE KILLER - DOWNLOADS THE IMAGE - USE AT YOUR OWN RISK
If the image has not already been downloaded and downloadIfNeeded is true, this method triggers a download and caches the image.
downloadIfNeeded
- whether or not the image should be downloaded (if it hasn't already been downloaded)IOException
- if an error occurs while downloading the imagepublic Page click(int x, int y) throws IOException
x
- the x position of the clicky
- the y position of the clickIOException
- if an IO error occurspublic Page click() throws IOException
click
in class HtmlElement
IOException
- if an IO error occursprotected boolean doClickStateUpdate() throws IOException
The default implementation only calls doClickStateUpdate on parent's HtmlElement (if any).
Subclasses requiring different behavior (like HtmlSubmitInput
) will override this method.
doClickStateUpdate
in class HtmlElement
IOException
- if an IO error occurredpublic void saveAs(File file) throws IOException
file
- the file to save toIOException
- if an IO error occurspublic HtmlElement.DisplayStyle getDefaultStyleDisplay()
getDefaultStyleDisplay
in class HtmlElement
public boolean getComplete()
public boolean isDisplayed()
Returns true if this node is displayed and can be visible to the user (ignoring screen size, scrolling limitations, color, font-size, or overlapping nodes).
NOTE: If CSS is
disabled
, this method
does not take this element's style into consideration!
isDisplayed
in class HtmlElement
DomNode.mayBeDisplayed()
public void markAsCreatedByJavascript()
public boolean wasCreatedByJavascript()
public String getOriginalQualifiedName()
public String getLocalName()
getLocalName
in interface Node
getLocalName
in class DomNamespaceNode
Copyright © 2002–2015 Gargoyle Software Inc.. All rights reserved.