SHOW Signed
 

net.rim.device.api.browser.field
Interface BrowserContent

All Known Implementing Classes:
BrowserContentBaseImpl

public interface BrowserContent

Field in which internet resource content (URLs) can be rendered.

Applications wishing to use browser fields to render web content should retrieve them from a rendering session (by invoking RenderingSession.getBrowserContent) rather than directly instantiating them.

When a browser content gets created it won't actually render any of its associated content until you invoke finishLoading().

Category:
Signed: This element is only accessible by signed applications. If you intend to use this element, please visit http://www.blackberry.com/go/codesigning to obtain a set of code signing keys. Code signing is only required for applications running on BlackBerry smartphones; development on BlackBerry Smartphone Simulators can occur without code signing.

Since:
JDE 4.0.0

Method Summary
 Category: Signed  void finishLoading()
          Complete loading by rendering content.
 Category: Signed  BrowserPageContext getBrowserPageContext()
          Retrieves page context for this browser content.
 Category: Signed  Field getDisplayableContent()
          Returns a displayable UI field.
 Category: Signed  String getError()
          Retrieves error (if any) received when requesting content URL.
 Category: Signed  EncodedImage getIcon()
          Retrieves the title icon for this content.
 Category: Signed  RenderingApplication getRenderingApplication()
          Retrieves handle to this content's rendering application.
 Category: Signed  int getRenderingFlags()
          Returns the rendering flags for this content.
 Category: Signed  RenderingOptions getRenderingOptions()
          Retrieves handle to this content's rendering options.
 Category: Signed  String getTitle()
          Retrieves this content's title.
 Category: Signed  String getURL()
          Retrieves the URL for this content.
 Category: Signed  String resolveUrl(String relative)
          Resolves provided relative URL.
 Category: Signed  void resourceReady(RequestedResource resource)
          Indicates resource is ready to render.
 Category: Signed  void setError(String string)
          Indicates to the browser content class that some type of error has occurred.
 

Method Detail

finishLoading

public void finishLoading()
                   throws RenderingException
Complete loading by rendering content.

A content object may do incremental rendering inside of this method. That is an application can call getDisplayableContent first and display the field to the user; and then call finishLoading on a background thread to actually display content to the user. This method must not be invoked on a UI Event Dispatch Thread.

Throws:
RenderingException - If this browser content was unable to render its content resource.
Since:
JDE 4.0.0
Category:
Signed: This element is only accessible by signed applications. If you intend to use this element, please visit http://www.blackberry.com/go/codesigning to obtain a set of code signing keys. Code signing is only required for applications running on BlackBerry smartphones; development on BlackBerry Smartphone Simulators can occur without code signing.

getBrowserPageContext

public BrowserPageContext getBrowserPageContext()
Retrieves page context for this browser content.

Third parties can overwrite this method to direct the way the rendering library displays this content within the browser application.

Returns:
Null (third parties that implement their own browser contents can return a browser page context object, if they require special handling).
Since:
JDE 4.0.0
Category:
Signed: This element is only accessible by signed applications. If you intend to use this element, please visit http://www.blackberry.com/go/codesigning to obtain a set of code signing keys. Code signing is only required for applications running on BlackBerry smartphones; development on BlackBerry Smartphone Simulators can occur without code signing.

getDisplayableContent

public Field getDisplayableContent()
Returns a displayable UI field.

This method is the main mechanism for retrieving or providing a UI widget. Third parties that provide their own BrowserContent objects should always return a non-null object from this method.

Returns:
Returns a displayable UI field.
Since:
JDE 4.0.0
Category:
Signed: This element is only accessible by signed applications. If you intend to use this element, please visit http://www.blackberry.com/go/codesigning to obtain a set of code signing keys. Code signing is only required for applications running on BlackBerry smartphones; development on BlackBerry Smartphone Simulators can occur without code signing.

getError

public String getError()
Retrieves error (if any) received when requesting content URL.
Returns:
Error received when attempting to fetch resource content at URL.
Since:
JDE 4.0.0
Category:
Signed: This element is only accessible by signed applications. If you intend to use this element, please visit http://www.blackberry.com/go/codesigning to obtain a set of code signing keys. Code signing is only required for applications running on BlackBerry smartphones; development on BlackBerry Smartphone Simulators can occur without code signing.

getIcon

public EncodedImage getIcon()
Retrieves the title icon for this content.
Returns:
image
Since:
JDE 4.0.0
Category:
Signed: This element is only accessible by signed applications. If you intend to use this element, please visit http://www.blackberry.com/go/codesigning to obtain a set of code signing keys. Code signing is only required for applications running on BlackBerry smartphones; development on BlackBerry Smartphone Simulators can occur without code signing.

getRenderingApplication

public RenderingApplication getRenderingApplication()
Retrieves handle to this content's rendering application.
Returns:
This content's rendering application.
Since:
JDE 4.0.0
Category:
Signed: This element is only accessible by signed applications. If you intend to use this element, please visit http://www.blackberry.com/go/codesigning to obtain a set of code signing keys. Code signing is only required for applications running on BlackBerry smartphones; development on BlackBerry Smartphone Simulators can occur without code signing.

getRenderingFlags

public int getRenderingFlags()
Returns the rendering flags for this content.

Rendering flags can be found in the RenderingConstants class. The flags are composed by ORing together the constants in the referenced class.

Returns:
Retrieves rendering flags for this content.
Since:
JDE 4.0.0
Category:
Signed: This element is only accessible by signed applications. If you intend to use this element, please visit http://www.blackberry.com/go/codesigning to obtain a set of code signing keys. Code signing is only required for applications running on BlackBerry smartphones; development on BlackBerry Smartphone Simulators can occur without code signing.

getRenderingOptions

public RenderingOptions getRenderingOptions()
Retrieves handle to this content's rendering options.
Returns:
This content's rendering options.
Since:
JDE 4.0.0
Category:
Signed: This element is only accessible by signed applications. If you intend to use this element, please visit http://www.blackberry.com/go/codesigning to obtain a set of code signing keys. Code signing is only required for applications running on BlackBerry smartphones; development on BlackBerry Smartphone Simulators can occur without code signing.

getTitle

public String getTitle()
Retrieves this content's title.
Returns:
This content's title.
Since:
JDE 4.0.0
Category:
Signed: This element is only accessible by signed applications. If you intend to use this element, please visit http://www.blackberry.com/go/codesigning to obtain a set of code signing keys. Code signing is only required for applications running on BlackBerry smartphones; development on BlackBerry Smartphone Simulators can occur without code signing.

getURL

public String getURL()
Retrieves the URL for this content.
Returns:
URL for this content.
Since:
JDE 4.0.0
Category:
Signed: This element is only accessible by signed applications. If you intend to use this element, please visit http://www.blackberry.com/go/codesigning to obtain a set of code signing keys. Code signing is only required for applications running on BlackBerry smartphones; development on BlackBerry Smartphone Simulators can occur without code signing.

resolveUrl

public String resolveUrl(String relative)
Resolves provided relative URL.

Use this method to expand a relative URL and retrieve its canonical form.

Parameters:
relative - URL to resolve.
Returns:
Canonical form of provided URL.
Since:
JDE 4.0.0
Category:
Signed: This element is only accessible by signed applications. If you intend to use this element, please visit http://www.blackberry.com/go/codesigning to obtain a set of code signing keys. Code signing is only required for applications running on BlackBerry smartphones; development on BlackBerry Smartphone Simulators can occur without code signing.

resourceReady

public void resourceReady(RequestedResource resource)
Indicates resource is ready to render.

The rendering application invokes this call-back method after the resource is requested and the HTTP Connection is ready.

Parameters:
resource - Resource that was requested, which the HTTP connection set.
Since:
JDE 4.0.0
Category:
Signed: This element is only accessible by signed applications. If you intend to use this element, please visit http://www.blackberry.com/go/codesigning to obtain a set of code signing keys. Code signing is only required for applications running on BlackBerry smartphones; development on BlackBerry Smartphone Simulators can occur without code signing.

setError

public void setError(String string)
Indicates to the browser content class that some type of error has occurred. The implementation may display this error string to the user.
Parameters:
string - Error string.
Since:
JDE 4.0.0
Category:
Signed: This element is only accessible by signed applications. If you intend to use this element, please visit http://www.blackberry.com/go/codesigning to obtain a set of code signing keys. Code signing is only required for applications running on BlackBerry smartphones; development on BlackBerry Smartphone Simulators can occur without code signing.



Copyright 1999-2008 Research In Motion Limited. 295 Phillip Street, Waterloo, Ontario, Canada, N2L 3W8. All Rights Reserved.
Copyright 1993-2003 Sun Microsystems, Inc. 901 San Antonio Road, Palo Alto, California, 94303, U.S.A.
Copyright 2002-2003 Nokia Corporation All Rights Reserved.
Java is a trademark or registered trademark of Sun Microsystems, Inc. in the US and other countries.