1*cdf0e10cSrcweir/************************************************************************* 2*cdf0e10cSrcweir * 3*cdf0e10cSrcweir * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. 4*cdf0e10cSrcweir * 5*cdf0e10cSrcweir * Copyright 2000, 2010 Oracle and/or its affiliates. 6*cdf0e10cSrcweir * 7*cdf0e10cSrcweir * OpenOffice.org - a multi-platform office productivity suite 8*cdf0e10cSrcweir * 9*cdf0e10cSrcweir * This file is part of OpenOffice.org. 10*cdf0e10cSrcweir * 11*cdf0e10cSrcweir * OpenOffice.org is free software: you can redistribute it and/or modify 12*cdf0e10cSrcweir * it under the terms of the GNU Lesser General Public License version 3 13*cdf0e10cSrcweir * only, as published by the Free Software Foundation. 14*cdf0e10cSrcweir * 15*cdf0e10cSrcweir * OpenOffice.org is distributed in the hope that it will be useful, 16*cdf0e10cSrcweir * but WITHOUT ANY WARRANTY; without even the implied warranty of 17*cdf0e10cSrcweir * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the 18*cdf0e10cSrcweir * GNU Lesser General Public License version 3 for more details 19*cdf0e10cSrcweir * (a copy is included in the LICENSE file that accompanied this code). 20*cdf0e10cSrcweir * 21*cdf0e10cSrcweir * You should have received a copy of the GNU Lesser General Public License 22*cdf0e10cSrcweir * version 3 along with OpenOffice.org. If not, see 23*cdf0e10cSrcweir * <http://www.openoffice.org/license.html> 24*cdf0e10cSrcweir * for a copy of the LGPLv3 License. 25*cdf0e10cSrcweir * 26*cdf0e10cSrcweir ************************************************************************/ 27*cdf0e10cSrcweir 28*cdf0e10cSrcweir#ifndef __com_sun_star_ui_UIElementSettings_idl__ 29*cdf0e10cSrcweir#define __com_sun_star_ui_UIElementSettings_idl__ 30*cdf0e10cSrcweir 31*cdf0e10cSrcweir#ifndef __com_sun_star_container_XIndexAccess_idl__ 32*cdf0e10cSrcweir#include <com/sun/star/container/XIndexAccess.idl> 33*cdf0e10cSrcweir#endif 34*cdf0e10cSrcweir 35*cdf0e10cSrcweir#ifndef __com_sun_star_lang_XSingleComponentFactory_idl__ 36*cdf0e10cSrcweir#include <com/sun/star/lang/XSingleComponentFactory.idl> 37*cdf0e10cSrcweir#endif 38*cdf0e10cSrcweir 39*cdf0e10cSrcweir//============================================================================= 40*cdf0e10cSrcweir 41*cdf0e10cSrcweirmodule com { module sun { module star { module ui { 42*cdf0e10cSrcweir 43*cdf0e10cSrcweir//============================================================================= 44*cdf0e10cSrcweir 45*cdf0e10cSrcweir/** 46*cdf0e10cSrcweir describes the internal structure of a configurable user interface element. 47*cdf0e10cSrcweir 48*cdf0e10cSrcweir <p> 49*cdf0e10cSrcweir No assumption is made about any graphical representation: 50*cdf0e10cSrcweir You could have a menu or a toolbar working with the same UIElementSettings 51*cdf0e10cSrcweir although limitations based on the real user interface element may be visible. 52*cdf0e10cSrcweir </p> 53*cdf0e10cSrcweir 54*cdf0e10cSrcweir @since OOo 2.0 55*cdf0e10cSrcweir*/ 56*cdf0e10cSrcweirservice UIElementSettings 57*cdf0e10cSrcweir{ 58*cdf0e10cSrcweir /** provides access to the structure of the user interface element. 59*cdf0e10cSrcweir 60*cdf0e10cSrcweir <p> 61*cdf0e10cSrcweir The container contains the items of the user interface element. Every 62*cdf0e10cSrcweir item is stored as a sequence of <type scope="com::sun::star::beans">PropertyValue</type>. 63*cdf0e10cSrcweir The properties insides the sequence are defined by the service <type scope="com::sun::star::ui">ItemDescriptor</type>. 64*cdf0e10cSrcweir It depends on the function which provides these service if the container is shareable read-only or exclusive writeable. 65*cdf0e10cSrcweir 66*cdf0e10cSrcweir @see com::sun::star::ui::ItemDescriptor 67*cdf0e10cSrcweir @see com::sun::star::ui::ItemType 68*cdf0e10cSrcweir @see com::sun::star::ui::ItemStyle 69*cdf0e10cSrcweir </p> 70*cdf0e10cSrcweir */ 71*cdf0e10cSrcweir interface ::com::sun::star::container::XIndexAccess; 72*cdf0e10cSrcweir 73*cdf0e10cSrcweir 74*cdf0e10cSrcweir /** provides access to an optional factory interface to create sub container. 75*cdf0e10cSrcweir 76*cdf0e10cSrcweir <p> 77*cdf0e10cSrcweir The factory should be used to create sub container within this user interface element settings. This interface is only 78*cdf0e10cSrcweir available if the container is exclusive writable. 79*cdf0e10cSrcweir </p> 80*cdf0e10cSrcweir */ 81*cdf0e10cSrcweir [optional] interface ::com::sun::star::lang::XSingleComponentFactory; 82*cdf0e10cSrcweir 83*cdf0e10cSrcweir /** determine an optional user interface name of the user interface element. 84*cdf0e10cSrcweir 85*cdf0e10cSrcweir <p> 86*cdf0e10cSrcweir A toolbar can show a its user interface name on the window title, when it is in floating mode. 87*cdf0e10cSrcweir </p> 88*cdf0e10cSrcweir */ 89*cdf0e10cSrcweir [optional, property] string UIName; 90*cdf0e10cSrcweir}; 91*cdf0e10cSrcweir 92*cdf0e10cSrcweir}; }; }; }; 93*cdf0e10cSrcweir 94*cdf0e10cSrcweir#endif 95