xref: /aoo4110/main/offapi/com/sun/star/awt/XLayoutContainer.idl (revision b1cdbd2c)

/**************************************************************
 *
 * Licensed to the Apache Software Foundation (ASF) under one
 * or more contributor license agreements.  See the NOTICE file
 * distributed with this work for additional information
 * regarding copyright ownership.  The ASF licenses this file
 * to you under the Apache License, Version 2.0 (the
 * "License"); you may not use this file except in compliance
 * with the License.  You may obtain a copy of the License at
 *
 *   http://www.apache.org/licenses/LICENSE-2.0
 *
 * Unless required by applicable law or agreed to in writing,
 * software distributed under the License is distributed on an
 * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
 * KIND, either express or implied.  See the License for the
 * specific language governing permissions and limitations
 * under the License.
 *
 *************************************************************/

#ifndef __com_sun_star_awt_XLayoutContainer_idl__
#define __com_sun_star_awt_XLayoutContainer_idl__

#ifndef __com_sun_star_awt_XLayoutConstrains_idl__
#include <com/sun/star/awt/XLayoutConstrains.idl>
#endif
#ifndef __com_sun_star_awt_Rectangle_idl__
#include <com/sun/star/awt/Rectangle.idl>
#endif
#ifndef __com_sun_star_beans_XPropertySet_idl__
#include <com/sun/star/beans/XPropertySet.idl>
#endif
#ifndef __com_sun_star_container_XChild_idl__
#include <com/sun/star/container/XChild.idl>
#endif
#ifndef __com_sun_star_awt_MaxChildrenException_idl__
#include <com/sun/star/awt/MaxChildrenException.idl>
#endif
#ifndef __com_sun_star_awt_XLayoutUnit_idl__
#include <com/sun/star/awt/XLayoutUnit.idl>
#endif

//=============================================================================

module com {  module sun {  module star {  module awt {

//=============================================================================

interface XLayoutUnit;

/** specifies the layout constraints for a surrounding container.

    @since OpenOffice 3.0
 */
interface XLayoutContainer: com::sun::star::container::XChild
{
	/** Adds a child. Some containers provide an interface for
	   adding children which you should use. */
    void addChild( [in] com::sun::star::awt::XLayoutConstrains Child )
		raises( com::sun::star::awt::MaxChildrenException );

	/** Remove a child. Some containers provide an interface for
	   adding children which you should use.
    */
    void removeChild( [in] com::sun::star::awt::XLayoutConstrains Child );

    /** Returns a sequence of the children of this container. */
    sequence< com::sun::star::awt::XLayoutConstrains > getChildren();

	/** Read/modify some child layout properties. XPropertySet provides a
	   rich API that allows, e.g., for introspection.
	   Should rarely be a need to use; containers shall provide an interface
	   for setting properties more confortably. */
    com::sun::star::beans::XPropertySet getChildProperties(
		[in] com::sun::star::awt::XLayoutConstrains Child );

	/** Set at initilization, this object should be notified when a containers state
	   changes, that may affect its size, to queue a layout re-calculation. */
	void setLayoutUnit( [in] com::sun::star::awt::XLayoutUnit Unit );

	// TEMP: no need for this...
	com::sun::star::awt::XLayoutUnit getLayoutUnit();

	/** To be used by the parent for the purpose of layout management.
	   For widgets, use XWindow::setPosSize() */
    void allocateArea( [in] com::sun::star::awt::Rectangle NewArea );

	/** Used by the layouting unit to evaluate size damage, and force a
	   re-allocation. */
	com::sun::star::awt::Size getRequestedSize();

	/** Used by the layouting unit to evaluate size damage, and force a
	   re-allocation. */
    com::sun::star::awt::Rectangle getAllocatedArea();

	/** For flow layouting (e.g. wrap-able labels). TODO: We might want to
	   re-design this approach -- check XLayoutConstrains::calcAdjustedSize(). */
	long getHeightForWidth( [in] long Width );

	/** For flow layouting (e.g. wrap-able labels). TODO: We might want to
	   re-design this approach -- check XLayoutConstrains::calcAdjustedSize(). */
	boolean hasHeightForWidth();
};

//=============================================================================

}; }; }; };

#endif