BoxRenderer (xhtmlrenderer 3.0.0-M1 API)

java.lang.Object
- org.docx4j.org.xhtmlrenderer.swing.BoxRenderer

```
public class BoxRenderer
extends Object
```
Renders an XML files, formatted with CSS, as an Box. Input is a document in the form of file or URL, and output is the root of the Box model. A BoxRenderer is not intended to be re-used for multiple document sources; just create new BoxRenderers for each one you need. BoxRenderer is not thread-safe. Standard usage pattern is
```
 File xhtml = ...
 BoxRenderer rend = new BoxRenderer(xhtml);
 Box rootBox = rend.render();
 
```
The document is not loaded, and layout and render don't take place, until render() is called. Subsequent calls to render() don't result in a reload; create a new BoxRenderer instance to do so.

As with RootPanel, you can access the SharedContext instance that will be used by this renderer and change settings to control the rendering process; use getSharedContext().

Not thread-safe.
另请参阅:

ITextRenderer

构造器概要

构造器
构造器和说明
`BoxRenderer(File file, int width)` Creates a new instance for a given File.
`BoxRenderer(File file, int width, int height)` Creates a new instance for a given File.
`BoxRenderer(String url, int width)` Renderer for a given URL (which is also used as the base) and a specified width; height is calculated automatically.
`BoxRenderer(String url, int width, int height)` Renderer for a given URL and a specified width; height is calculated automatically.
`BoxRenderer(String url, String baseurl, int width)` Renderer for a given URL and a specified width; height is calculated automatically.
`BoxRenderer(String url, String baseUrl, int width, int height)` Creates a new instance for a given URL.

方法概要

所有方法实例方法具体方法
限定符和类型	方法和说明
`protected BufferedImage`	`createBufferedImage(int width, int height)` Returns a BufferedImage using the specified width and height.
`LayoutContext`	`getLayoutContext()` Returns the LayoutContext to be used by renderer.
`SharedContext`	`getSharedContext()` Returns the SharedContext to be used by renderer.
`Box`	`render()` Renders the XML document if necessary and returns the root Box.
`void`	`setRenderingHints(Map hints)` Sets the rendering hints to apply to the Graphics2D instance used by the renderer; see `Graphics2D.setRenderingHints(java.util.Map)`.

从类继承的方法 java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- 构造器详细资料
  - BoxRenderer
```
public BoxRenderer(String url,
                   String baseUrl,
                   int width,
                   int height)
```
    Creates a new instance for a given URL. Does not render until render() is called for the first time.
    
    参数:
    
    url - The location of the document to be rendered.
    
    baseUrl - The base url for the document, against which relative paths are resolved.
    
    width - Target width, in pixels, for the image; required to provide horizontal bounds for the layout.
  - BoxRenderer
```
public BoxRenderer(File file,
                   int width,
                   int height)
            throws IOException
```
    Creates a new instance for a given File. Does not render until render() is called for the first time.
    
    参数:
    
    file - The file to be rendered.
    
    width - Target width, in pixels, for the image; required to provide horizontal bounds for the layout.
    
    height - Target height, in pixels, for the image
    
    抛出:
    
    IOException
  - BoxRenderer
```
public BoxRenderer(File file,
                   int width)
            throws IOException
```
    Creates a new instance for a given File. Does not render until render() is called for the first time.
    
    参数:
    
    file - The file to be rendered.
    
    width - Target width, in pixels, for the image; required to provide horizontal bounds for the layout. Heght is calculated based on content
    
    抛出:
    
    IOException
  - BoxRenderer
```
public BoxRenderer(String url,
                   int width)
```
    Renderer for a given URL (which is also used as the base) and a specified width; height is calculated automatically.
    
    参数:
    
    url - The location of the document to be rendered.
    
    width - Target width, in pixels, for the image; required to provide horizontal bounds for the layout. Heght is calculated based on content
  - BoxRenderer
```
public BoxRenderer(String url,
                   String baseurl,
                   int width)
```
    Renderer for a given URL and a specified width; height is calculated automatically.
    
    参数:
    
    url - The location of the document to be rendered.
    
    baseurl - The base url for the document, against which relative paths are resolved.
    
    width - Target width, in pixels, for the image; required to provide horizontal bounds for the layout. Heght is calculated based on content
  - BoxRenderer
```
public BoxRenderer(String url,
                   int width,
                   int height)
```
    Renderer for a given URL and a specified width; height is calculated automatically.
    
    参数:
    
    url - The location of the document to be rendered.
    
    width - Target width, in pixels, for the image; required to provide horizontal bounds for the layout.
    
    height - Target height, in pixels, for the image
- 方法详细资料
  - setRenderingHints
```
public void setRenderingHints(Map hints)
```
    Sets the rendering hints to apply to the Graphics2D instance used by the renderer; see Graphics2D.setRenderingHints(java.util.Map). The Map need not specify values for all properties; any settings in this map will be applied as override to the default settings, and will not replace the entire Map for the Graphics2D instance.
    
    参数:
    
    hints - values to override in default rendering hints for Graphics2D we are rendering to
  - getSharedContext
```
public SharedContext getSharedContext()
```
    Returns the SharedContext to be used by renderer. Is instantiated along with the class, so can be accessed before render() is called to tune the rendering process.
    
    返回:
    
    the SharedContext instance that will be used by this renderer
  - getLayoutContext
```
public LayoutContext getLayoutContext()
```
    Returns the LayoutContext to be used by renderer. Is instantiated along with the class, so can be accessed before render() is called to tune the rendering process.
    
    返回:
    
    the LayoutContext instance that will be used by this renderer
  - render
```
public Box render()
```
    Renders the XML document if necessary and returns the root Box. If already rendered, same Box reference will be returned.
    
    返回:
    
    The XML rendered as a Box.
  - createBufferedImage
```
protected BufferedImage createBufferedImage(int width,
                                            int height)
```
    Returns a BufferedImage using the specified width and height. By default this returns an image compatible with the screen (if not in "headless" mode) formatted for RGB.
    
    参数:
    
    width - target width
    
    height - target height
    
    返回:
    
    new BI

类 BoxRenderer

构造器概要

方法概要

从类继承的方法 java.lang.Object

构造器详细资料

BoxRenderer

BoxRenderer

BoxRenderer

BoxRenderer

BoxRenderer

BoxRenderer

方法详细资料

setRenderingHints

getSharedContext

getLayoutContext

render

createBufferedImage