public class HtmlImage extends ClickableElement
HtmlElement.ChildElementsIterator
DomNode.ChildIterator, DomNode.DescendantElementsIterator
Modifier and Type | Field and Description |
---|---|
static String |
TAG_NAME
The 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 Page |
doClickAction(Page defaultPage)
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".
|
int |
getHeight()
POTENIAL PERFORMANCE KILLER - DOWNLOADS THE IMAGE - USE AT YOUR OWN RISK.
If the image is not already downloaded it triggers a download. |
String |
getHeightAttribute()
Returns the value of the attribute "height".
|
String |
getHspaceAttribute()
Returns the value of the attribute "hspace".
|
ImageReader |
getImageReader()
POTENIAL PERFORMANCE KILLER - DOWNLOADS THE IMAGE - USE AT YOUR OWN RISK.
If the image is not already downloaded it triggers a download. |
String |
getIsmapAttribute()
Returns the value of the attribute "ismap".
|
String |
getLongDescAttribute()
Returns the value of the attribute "longdesc".
|
String |
getNameAttribute()
Returns the value of the attribute "name".
|
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)
POTENIAL PERFORMANCE KILLER - DOWNLOADS THE IMAGE - USE AT YOUR OWN RISK.
If the image is not already downloaded it triggers a download. |
int |
getWidth()
POTENIAL PERFORMANCE KILLER - DOWNLOADS THE IMAGE - USE AT YOUR OWN RISK.
If the image is not already downloaded it triggers a download. |
String |
getWidthAttribute()
Returns the value of the attribute "width".
|
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.
|
getClassAttribute, getIdAttribute, getStyleAttribute, getTitleAttribute
addHtmlAttributeChangeListener, appendChildIfNoneExists, blur, checkChildHierarchy, click, click, dblClick, dblClick, doType, fireEvent, fireEvent, fireHtmlAttributeAdded, fireHtmlAttributeRemoved, fireHtmlAttributeReplaced, focus, getChildElements, getElementById, getElementsByAttribute, getEnclosingElement, getEnclosingForm, getEnclosingFormOrDie, getEventHandler, getHtmlElementsByTagName, getHtmlElementsByTagNames, getId, getLangAttribute, getNodeName, getOnClickAttribute, getOnDblClickAttribute, getOneHtmlElementByAttribute, getOnKeyDownAttribute, getOnKeyPressAttribute, getOnKeyUpAttribute, getOnMouseDownAttribute, getOnMouseMoveAttribute, getOnMouseOutAttribute, getOnMouseOverAttribute, getOnMouseUpAttribute, getTabIndex, getTextDirectionAttribute, getXmlLangAttribute, hasHtmlElementWithId, isAttributeCaseSensitive, isStateUpdateFirst, isSubmittableByEnter, mouseDown, mouseDown, mouseMove, mouseMove, mouseOut, mouseOut, mouseOver, mouseOver, mouseUp, mouseUp, preventDefault, removeAttribute, removeChild, removeEventHandler, removeHtmlAttributeChangeListener, rightClick, rightClick, setAttributeNS, setEventHandler, setEventHandler, setId, toString, type, type, type, type
cloneNode, getAttribute, getAttributeNode, getAttributeNodeNS, getAttributeNS, getAttributes, getAttributesMap, getElementsByTagName, getElementsByTagNameNS, getNodeType, getSchemaTypeInfo, getTagName, hasAttribute, hasAttributeNS, hasAttributes, isEmptyXmlTagExpanded, namespaces, printOpeningTagContentAsXml, printXml, removeAttributeNode, removeAttributeNS, setAttribute, setAttributeNode, setAttributeNodeNS, setIdAttribute, setIdAttributeNode, setIdAttributeNS
getLocalName, getNamespaceURI, getPrefix, getQualifiedName, setPrefix
addDomChangeListener, appendChild, asText, asXml, compareDocumentPosition, fireNodeAdded, fireNodeDeleted, getAllHtmlChildElements, getAncestors, getBaseURI, getByXPath, getCanonicalXPath, getChildNodes, getChildren, getEndColumnNumber, getEndLineNumber, getFeature, getFirstByXPath, getFirstChild, getLastChild, getNextSibling, getNodeValue, getOwnerDocument, getPage, getParentNode, getPreviousSibling, getReadyState, getScriptObject, getStartColumnNumber, getStartLineNumber, getTextContent, getUserData, hasChildNodes, insertBefore, insertBefore, isAncestorOf, isBlock, isDefaultNamespace, isDisplayed, isEqualNode, isSameNode, isSupported, isTrimmedText, lookupNamespaceURI, lookupPrefix, normalize, notifyIncorrectness, onAllChildrenAddedToPage, printChildrenAsXml, remove, removeAllChildren, removeChild, removeDomChangeListener, replace, replaceChild, selectNodes, selectSingleNode, 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, getLocalName, 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
protected void onAddedToPage()
onAddedToPage
in class DomNode
public 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
IOException
- if an error occurs while downloading the image or reading itpublic int getWidth() throws IOException
IOException
- if an error occurs while downloading the image or reading itpublic ImageReader getImageReader() throws IOException
IOException
- if an error occurs while downloading the image and if its of an unsupported content-typepublic WebResponse getWebResponse(boolean downloadIfNeeded) throws IOException
downloadIfNeeded
- indicates if a request should be performed this hasn't been done previouslynull
if no download should be performed and when this wasn't already done; the response
received when performing a request for the image referenced by this tag otherwiseIOException
- 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 Page doClickAction(Page defaultPage) throws IOException
doClickAction
in class HtmlElement
defaultPage
- the default page to return if the action does not load a new pageIOException
- if an IO error occurredpublic void saveAs(File file) throws IOException
file
- the file to save toIOException
- if an IO error occursCopyright © 2002–2014 Gargoyle Software Inc.. All rights reserved.