:: com :: sun :: star :: frame ::

interface XFramesSupplier
Base Interfaces
::com::sun::star::uno::XInterface
  |  
  +--::com::sun::star::lang::XComponent
       |  
       +--::com::sun::star::frame::XFrame
            |  
            +--XFramesSupplier
::com::sun::star::frame::XFrame
(referenced interface's summary:)
a frame object can be considered to be an "anchor" object where a component can be attached to.
Description
provides access to sub frames of current one
See also
::com::sun::star::frame::XFrames
Developers Guide
6.1.3 Office Development - OpenOffice.org Application Environment - Using the Component Framework - Frames - XFramesSupplier
6.1.4 Office Development - OpenOffice.org Application Environment - Creating Frames Manually - Setting Components into Frame Hierarchies

Methods' Summary
getFrames provides access to this container and to all other ::com::sun::star::frame::XFramesSupplier which are available from this node of frame tree  
getActiveFrame gets the current active frame of this container (not of any other available supplier)  
setActiveFrame is called on activation of a direct sub-frame.  
Methods' Details
getFrames
::com::sun::star::frame::XFrames
getFrames();

Description
provides access to this container and to all other ::com::sun::star::frame::XFramesSupplier which are available from this node of frame tree
Returns
the collection of frames which is represented by a ::com::sun::star::frame::FramesContainer .
getActiveFrame
::com::sun::star::frame::XFrame
getActiveFrame();

Description
gets the current active frame of this container (not of any other available supplier)

This may be the frame itself. The active frame is defined as the frame which contains (recursively) the window with the focus. If no window within the frame contains the focus, this method returns the last frame which had the focus. If no containing window ever had the focus, the first frame within this frame is returned.

Returns
the ::com::sun::star::frame::Frame which is active within this frame.
setActiveFrame
void
setActiveFrame( [in] ::com::sun::star::frame::XFrame  Frame );

Description
is called on activation of a direct sub-frame.

This method is only allowed to be called by a sub-frame according to ::com::sun::star::frame::XFrame::activate() or ::com::sun::star::frame::XFramesSupplier::setActiveFrame() . After this call ::com::sun::star::frame::XFramesSupplier::getActiveFrame() will return the frame specified by Frame .

In general this method first calls the method ::com::sun::star::frame::XFramesSupplier::setActiveFrame() at the creator frame with this as the current argument. Then it broadcasts the ::com::sun::star::frame::FrameActionEvent FrameAction::FRAME_ACTIVATED .

Note: Given parameter Frame must already exist inside the container (e.g., inserted by using ::com::sun::star::frame::XFrames::append() )

Parameter Frame
the new active child frame inside this container
Top of Page