Package org.apache.batik.bridge
Interface UserAgent
-
- All Known Implementing Classes:
JSVGCanvas.CanvasUserAgent,JSVGComponent.BridgeUserAgent,JSVGComponent.BridgeUserAgentWrapper,SVGAbstractTranscoder.SVGAbstractTranscoderUserAgent,SVGOnLoadExceptionTest.TestUserAgent,UserAgentAdapter
public interface UserAgentAn interface that provides access to the User Agent informations needed by the bridge.- Version:
- $Id: UserAgent.java 1808023 2017-09-11 12:43:22Z ssteiner $
-
-
Method Summary
All Methods Instance Methods Abstract Methods Modifier and Type Method Description voidcheckLoadExternalResource(ParsedURL resourceURL, ParsedURL docURL)This method throws a SecurityException if the resource found at url and referenced from docURL should not be loaded.voidcheckLoadScript(java.lang.String scriptType, ParsedURL scriptURL, ParsedURL docURL)This method throws a SecurityException if the script of given type, found at url and referenced from docURL should not be loaded.voiddeselectAll()Informs the user agent that the text selection should be cleared.voiddisplayError(java.lang.Exception ex)Displays an error resulting from the specified Exception.voiddisplayMessage(java.lang.String message)Displays a message in the User Agent interface.java.lang.StringgetAlternateStyleSheet()Returns this user agent's alternate style-sheet title.floatgetBolderFontWeight(float f)Returns a bolder font-weight.org.w3c.dom.svg.SVGDocumentgetBrokenLinkDocument(org.w3c.dom.Element e, java.lang.String url, java.lang.String message)This method should return an image to be displayed when an image can't be loaded.java.awt.PointgetClientAreaLocationOnScreen()Returns the location on the screen of the client area in the UserAgent.java.lang.StringgetDefaultFontFamily()Returns the default font family.EventDispatchergetEventDispatcher()Returns the event dispatcher to use.ExternalResourceSecuritygetExternalResourceSecurity(ParsedURL resourceURL, ParsedURL docURL)Returns the security settings for the given resource url and document urlFontFamilyResolvergetFontFamilyResolver()Returns the Font Family Resolverjava.lang.StringgetLanguages()Returns the language settings.floatgetLighterFontWeight(float f)Returns a lighter font-weight.java.lang.StringgetMedia()Returns this user agent's CSS media.floatgetMediumFontSize()Returns the medium font size.floatgetPixelToMM()Returns the size of a px CSS unit in millimeters.floatgetPixelUnitToMillimeter()Returns the size of a px CSS unit in millimeters.ScriptSecuritygetScriptSecurity(java.lang.String scriptType, ParsedURL scriptURL, ParsedURL docURL)Returns the security settings for the given script type, script url and document urljava.awt.geom.AffineTransformgetTransform()Returns theAffineTransformcurrently applied to the drawing by the UserAgent.java.lang.StringgetUserStyleSheetURI()Returns the user stylesheet uri.java.awt.geom.Dimension2DgetViewportSize()Returns the default size of the viewport.java.lang.StringgetXMLParserClassName()Returns the class name of the XML parser.voidhandleElement(org.w3c.dom.Element elt, java.lang.Object data)Notifies the UserAgent that the input element has been found in the document.booleanhasFeature(java.lang.String s)Tells whether the given feature is supported by this user agent.booleanisXMLParserValidating()Returns true if the XML parser must be in validation mode, false otherwise.voidloadDocument(java.lang.String url)This method should load a new document described by the supplied URL.voidopenLink(org.w3c.dom.svg.SVGAElement elt)Opens a link.voidregisterExtension(BridgeExtension ext)Lets the bridge tell the user agent that the following extension is supported by the bridge.voidsetSVGCursor(java.awt.Cursor cursor)Informs the user agent to change the cursor.voidsetTextSelection(Mark start, Mark end)Informs the user agent that the text selection has changed.voidsetTransform(java.awt.geom.AffineTransform at)Sets theAffineTransformcurrently applied to the drawing by the UserAgent.voidshowAlert(java.lang.String message)Shows an alert dialog box.booleanshowConfirm(java.lang.String message)Shows a confirm dialog box.java.lang.StringshowPrompt(java.lang.String message)Shows a prompt dialog box.java.lang.StringshowPrompt(java.lang.String message, java.lang.String defaultValue)Shows a prompt dialog box.booleansupportExtension(java.lang.String s)Tells whether the given extension is supported by this user agent.
-
-
-
Method Detail
-
getEventDispatcher
EventDispatcher getEventDispatcher()
Returns the event dispatcher to use.
-
getViewportSize
java.awt.geom.Dimension2D getViewportSize()
Returns the default size of the viewport.
-
displayError
void displayError(java.lang.Exception ex)
Displays an error resulting from the specified Exception.
-
displayMessage
void displayMessage(java.lang.String message)
Displays a message in the User Agent interface.
-
showAlert
void showAlert(java.lang.String message)
Shows an alert dialog box.
-
showPrompt
java.lang.String showPrompt(java.lang.String message)
Shows a prompt dialog box.
-
showPrompt
java.lang.String showPrompt(java.lang.String message, java.lang.String defaultValue)Shows a prompt dialog box.
-
showConfirm
boolean showConfirm(java.lang.String message)
Shows a confirm dialog box.
-
getPixelUnitToMillimeter
float getPixelUnitToMillimeter()
Returns the size of a px CSS unit in millimeters.
-
getPixelToMM
float getPixelToMM()
Returns the size of a px CSS unit in millimeters. This will be removed after next release.- See Also:
getPixelUnitToMillimeter()
-
getMediumFontSize
float getMediumFontSize()
Returns the medium font size.
-
getLighterFontWeight
float getLighterFontWeight(float f)
Returns a lighter font-weight.
-
getBolderFontWeight
float getBolderFontWeight(float f)
Returns a bolder font-weight.
-
getDefaultFontFamily
java.lang.String getDefaultFontFamily()
Returns the default font family.
-
getLanguages
java.lang.String getLanguages()
Returns the language settings.
-
getUserStyleSheetURI
java.lang.String getUserStyleSheetURI()
Returns the user stylesheet uri.- Returns:
- null if no user style sheet was specified.
-
openLink
void openLink(org.w3c.dom.svg.SVGAElement elt)
Opens a link.- Parameters:
elt- The activated link element.
-
setSVGCursor
void setSVGCursor(java.awt.Cursor cursor)
Informs the user agent to change the cursor.- Parameters:
cursor- the new cursor
-
setTextSelection
void setTextSelection(Mark start, Mark end)
Informs the user agent that the text selection has changed.- Parameters:
start- The Mark for the start of the selection.end- The Mark for the end of the selection.
-
deselectAll
void deselectAll()
Informs the user agent that the text selection should be cleared.
-
getXMLParserClassName
java.lang.String getXMLParserClassName()
Returns the class name of the XML parser.
-
isXMLParserValidating
boolean isXMLParserValidating()
Returns true if the XML parser must be in validation mode, false otherwise.
-
getTransform
java.awt.geom.AffineTransform getTransform()
Returns theAffineTransformcurrently applied to the drawing by the UserAgent.
-
setTransform
void setTransform(java.awt.geom.AffineTransform at)
Sets theAffineTransformcurrently applied to the drawing by the UserAgent.
-
getMedia
java.lang.String getMedia()
Returns this user agent's CSS media.
-
getAlternateStyleSheet
java.lang.String getAlternateStyleSheet()
Returns this user agent's alternate style-sheet title.
-
getClientAreaLocationOnScreen
java.awt.Point getClientAreaLocationOnScreen()
Returns the location on the screen of the client area in the UserAgent.
-
hasFeature
boolean hasFeature(java.lang.String s)
Tells whether the given feature is supported by this user agent.
-
supportExtension
boolean supportExtension(java.lang.String s)
Tells whether the given extension is supported by this user agent.
-
registerExtension
void registerExtension(BridgeExtension ext)
Lets the bridge tell the user agent that the following extension is supported by the bridge.
-
handleElement
void handleElement(org.w3c.dom.Element elt, java.lang.Object data)Notifies the UserAgent that the input element has been found in the document. This is sometimes called, for example, to handle <a> or <title> elements in a UserAgent-dependant way.
-
getScriptSecurity
ScriptSecurity getScriptSecurity(java.lang.String scriptType, ParsedURL scriptURL, ParsedURL docURL)
Returns the security settings for the given script type, script url and document url- Parameters:
scriptType- type of script, as found in the type attribute of the <script> element.scriptURL- url for the script, as defined in the script's xlink:href attribute. If that attribute was empty, then this parameter should be nulldocURL- url for the document into which the script was found.
-
checkLoadScript
void checkLoadScript(java.lang.String scriptType, ParsedURL scriptURL, ParsedURL docURL) throws java.lang.SecurityExceptionThis method throws a SecurityException if the script of given type, found at url and referenced from docURL should not be loaded. This is a convenience method to call checkLoadScript on the ScriptSecurity strategy returned by getScriptSecurity.- Parameters:
scriptType- type of script, as found in the type attribute of the <script> element.scriptURL- url for the script, as defined in the script's xlink:href attribute. If that attribute was empty, then this parameter should be nulldocURL- url for the document into which the script was found.- Throws:
java.lang.SecurityException
-
getExternalResourceSecurity
ExternalResourceSecurity getExternalResourceSecurity(ParsedURL resourceURL, ParsedURL docURL)
Returns the security settings for the given resource url and document url- Parameters:
resourceURL- url for the resource, as defined in the resource's xlink:href attribute. If that attribute was empty, then this parameter should be nulldocURL- url for the document into which the resource was found.
-
checkLoadExternalResource
void checkLoadExternalResource(ParsedURL resourceURL, ParsedURL docURL) throws java.lang.SecurityException
This method throws a SecurityException if the resource found at url and referenced from docURL should not be loaded. This is a convenience method to call checkLoadExternalResource on the ExternalResourceSecurity strategy returned by getExternalResourceSecurity.- Parameters:
resourceURL- url for the resource, as defined in the resource's xlink:href attribute. If that attribute was empty, then this parameter should be nulldocURL- url for the document into which the resource was found.- Throws:
java.lang.SecurityException
-
getBrokenLinkDocument
org.w3c.dom.svg.SVGDocument getBrokenLinkDocument(org.w3c.dom.Element e, java.lang.String url, java.lang.String message)This method should return an image to be displayed when an image can't be loaded. If it returns 'null' then a BridgeException will be thrown.- Parameters:
e- The <image> element that can't be loaded.url- The resolved url that can't be loaded.message- As best as can be determined the reason it can't be loaded (not available, corrupt, unknown format, ...).
-
loadDocument
void loadDocument(java.lang.String url)
This method should load a new document described by the supplied URL.- Parameters:
url- The url to be loaded as a string.
-
getFontFamilyResolver
FontFamilyResolver getFontFamilyResolver()
Returns the Font Family Resolver
-
-