(incubating) | The Free and Open Productivity Suite
Announcing Apache OpenOffice 3.4

Developer's Guide

API

SDK

Tips 'n' Tricks

Miscellaneous

Content for OpenOffice.org version 3.3.

:: com :: sun :: star :: ui ::

unpublished interface XDockingAreaAcceptor
Usage Restrictions
not published
Description
this interface enables developer to implement different docking area acceptors which are used by the frame based layout manager.

A docking area acceptor is responsible to control the docking area of a container window. As OLE for example supports inplace and outplace editing, there are different parts of code responsible for the container window. This interface enables developer to make support implementations for these scenarios.

Since
OOo 2.0.0
See also
::com::sun::star::frame::XFrame


Methods' Summary
getContainerWindow provide the container window where the layout manager can request border space for docking windows.  
requestDockingAreaSpace method to ask an implementation if the provided space for docking windows is available or not.  
setDockingAreaSpace method to brief an implementation that we need new border space.  
Methods' Details
getContainerWindow
::com::sun::star::awt::XWindow
getContainerWindow();

Description
provide the container window where the layout manager can request border space for docking windows.

Additionally the layout manager uses this window to create its own child windows for docking purposes.

requestDockingAreaSpace
boolean
requestDockingAreaSpace( [in] ::com::sun::star::awt::Rectangle  RequestedSpace );

Description
method to ask an implementation if the provided space for docking windows is available or not.

The ::com::sun::star::awt::Rectangle parameter is filled by the caller with pixel data. The members of ::com::sun::star::awt::Rectangle must be filled as following:

  • X = requested area on left side (in pixel)
  • Y = requested area on top side (in pixel)
  • Width = requested area on right side (in pixel)
  • Height = requested area on bottom side (in pixel)

setDockingAreaSpace
void
setDockingAreaSpace( [in] ::com::sun::star::awt::Rectangle  BorderSpace );

Description
method to brief an implementation that we need new border space.

The callee must size its document window so that we have the amount of space we have provided. The ::com::sun::star::awt::Rectangle parameter is filled by the caller with pixel data. The members of ::com::sun::star::awt::Rectangle must be filled as following:

  • X = new area on left side (in pixel)
  • Y = new area on top side (in pixel)
  • Width = new area on right side (in pixel)
  • Height = new area on bottom side (in pixel)

Top of Page

Apache Feather

Copyright & License | Privacy | Contact Us

Apache and the Apache feather logos are trademarks of The Apache Software Foundation. OpenOffice.org and the seagull logo are registered trademarks of The Apache Software Foundation. Other names appearing on the site may be trademarks of their respective owners.

Apache OpenOffice is an effort undergoing incubation at The Apache Software Foundation (ASF), sponsored by the Apache Incubator. Incubation is required of all newly accepted projects until a further review indicates that the infrastructure, communications, and decision making process have stabilized in a manner consistent with other successful ASF projects. While incubation status is not necessarily a reflection of the completeness or stability of the code, it does indicate that the project has yet to be fully endorsed by the ASF.