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_chart_AccessibleChartDocumentView_idl__ 29*cdf0e10cSrcweir#define __com_sun_star_chart_AccessibleChartDocumentView_idl__ 30*cdf0e10cSrcweir 31*cdf0e10cSrcweir#ifndef __com_sun_star_accessibility_XAccessible_idl__ 32*cdf0e10cSrcweir#include <com/sun/star/accessibility/XAccessible.idl> 33*cdf0e10cSrcweir#endif 34*cdf0e10cSrcweir#ifndef __com_sun_star_accessibility_XAccessibleContext_idl__ 35*cdf0e10cSrcweir#include <com/sun/star/accessibility/XAccessibleContext.idl> 36*cdf0e10cSrcweir#endif 37*cdf0e10cSrcweir#ifndef __com_sun_star_accessibility_XAccessibleComponent_idl__ 38*cdf0e10cSrcweir#include <com/sun/star/accessibility/XAccessibleComponent.idl> 39*cdf0e10cSrcweir#endif 40*cdf0e10cSrcweir 41*cdf0e10cSrcweirmodule com { module sun { module star { module chart { 42*cdf0e10cSrcweir 43*cdf0e10cSrcweir/** The <type>AccessibleChartDocumentView</type> service is supported 44*cdf0e10cSrcweir by a Component that represents the view of a Chart document to 45*cdf0e10cSrcweir provide an entry point to the document tree for accessibility. 46*cdf0e10cSrcweir 47*cdf0e10cSrcweir <p>An object that implements the <type>AccessibleChartDocumentView</type> 48*cdf0e10cSrcweir service provides information about itself and about the chart 49*cdf0e10cSrcweir subcomponents contained in the chart document displayed in a 50*cdf0e10cSrcweir window. This service gives a simplified view on the underlying 51*cdf0e10cSrcweir implementation. It tries both to keep the structure of the 52*cdf0e10cSrcweir accessibility representation tree as simple as possible and 53*cdf0e10cSrcweir provide as much relevant information as possible.</p> 54*cdf0e10cSrcweir 55*cdf0e10cSrcweir @since OOo 1.1.2 56*cdf0e10cSrcweir*/ 57*cdf0e10cSrcweirpublished service AccessibleChartDocumentView 58*cdf0e10cSrcweir{ 59*cdf0e10cSrcweir /** Base interface for being accessible. It gives access to the 60*cdf0e10cSrcweir <type scope="::com::sun::star::accessibility">XAccessibleContext</type> 61*cdf0e10cSrcweir interface. 62*cdf0e10cSrcweir */ 63*cdf0e10cSrcweir interface ::com::sun::star::accessibility::XAccessible; 64*cdf0e10cSrcweir 65*cdf0e10cSrcweir /** Provide access to a Chart document's view. 66*cdf0e10cSrcweir 67*cdf0e10cSrcweir <p>You can access the following information:</p> 68*cdf0e10cSrcweir <dl> 69*cdf0e10cSrcweir <dt>Role</dt> 70*cdf0e10cSrcweir <dd>The object's role is 71*cdf0e10cSrcweir <const scope="com::sun::star::accessibility">AccessibleRole::DOCUMENT</const>.</dd> 72*cdf0e10cSrcweir <dt>Name</dt> 73*cdf0e10cSrcweir <dd>Its name is the document's name or the base name of the filename if 74*cdf0e10cSrcweir no document name has been set explicitly.</dd> 75*cdf0e10cSrcweir <dt>Description</dt> 76*cdf0e10cSrcweir <dd>The description is the document's description or the 77*cdf0e10cSrcweir full filename if no description has been set 78*cdf0e10cSrcweir explicitly.</dd> 79*cdf0e10cSrcweir <dt>Children</dt> 80*cdf0e10cSrcweir <dd>The subcomponents of a chart. This includes all kinds of 81*cdf0e10cSrcweir titles, a legend and the diagram. The diagram and the legend are 82*cdf0e10cSrcweir the only children that themselves contain children. The Chart 83*cdf0e10cSrcweir subcomponents support the service 84*cdf0e10cSrcweir <type>AccessibleChartElement</type>. Additionally, there may be 85*cdf0e10cSrcweir shapes a user added via the clipboard. For details see the 86*cdf0e10cSrcweir <type scope="::com::sun::star::drawing">AccessibleShape</type>. 87*cdf0e10cSrcweir </dd> 88*cdf0e10cSrcweir <dt>Parent</dt> 89*cdf0e10cSrcweir <dd>The parent will usually be the window that contains the 90*cdf0e10cSrcweir Chart document view. It has to be set via implementation dependent 91*cdf0e10cSrcweir ways.</dd> 92*cdf0e10cSrcweir <dt>Relations</dt> 93*cdf0e10cSrcweir <dd>At the moment relations are not supported. The method 94*cdf0e10cSrcweir <member scope="com::sun::star::accessibility">XAccessibleContext::getAccessibleRelationSet</member> 95*cdf0e10cSrcweir will always return an empty set.</dd> 96*cdf0e10cSrcweir <dt>States</dt> 97*cdf0e10cSrcweir <dd>The following states are supported: 98*cdf0e10cSrcweir <ul> 99*cdf0e10cSrcweir <li><const scope="com::sun::star::accessibility">AccessibleStateType::DEFUNC</const> 100*cdf0e10cSrcweir is set if a document view becomes obsolete like when 101*cdf0e10cSrcweir the window, which displays the view, is closed.</li> 102*cdf0e10cSrcweir <li><const scope="com::sun::star::accessibility">AccessibleStateType::ENABLED</const> 103*cdf0e10cSrcweir is always set unless the 104*cdf0e10cSrcweir <const scope="com::sun::star::accessibility">AccessibleStateType::DEFUNC</const> 105*cdf0e10cSrcweir state is set.</li> 106*cdf0e10cSrcweir <li><const scope="com::sun::star::accessibility">AccessibleStateType::OPAQUE</const> 107*cdf0e10cSrcweir is always set.</li> 108*cdf0e10cSrcweir <li><const scope="com::sun::star::accessibility">AccessibleStateType::SHOWING</const> 109*cdf0e10cSrcweir is always set unless the 110*cdf0e10cSrcweir <const scope="com::sun::star::accessibility">AccessibleStateType::DEFUNC</const> 111*cdf0e10cSrcweir state is set.</li> 112*cdf0e10cSrcweir <li><const scope="com::sun::star::accessibility">AccessibleStateType::VISIBLE</const> 113*cdf0e10cSrcweir is always set unless the 114*cdf0e10cSrcweir <const scope="com::sun::star::accessibility">AccessibleStateType::DEFUNC</const> 115*cdf0e10cSrcweir state is set.</li> 116*cdf0e10cSrcweir </ul> 117*cdf0e10cSrcweir </dd> 118*cdf0e10cSrcweir <dt>Locale</dt> 119*cdf0e10cSrcweir <dd>Is the locale set at the document.</dd> 120*cdf0e10cSrcweir <dt>Property change listeners</dt> 121*cdf0e10cSrcweir <dd>They are supported to inform the 122*cdf0e10cSrcweir listeners about changes in this object.</dd> 123*cdf0e10cSrcweir </dl> 124*cdf0e10cSrcweir */ 125*cdf0e10cSrcweir interface ::com::sun::star::accessibility::XAccessibleContext; 126*cdf0e10cSrcweir 127*cdf0e10cSrcweir /** Provide access to a Chart document's graphical representation. 128*cdf0e10cSrcweir 129*cdf0e10cSrcweir <p>The main purpose of this interface is to provide a bounding 130*cdf0e10cSrcweir box of the currently visible area and to let the user find the 131*cdf0e10cSrcweir subcomponents of a chart that cover a given test point.</p> 132*cdf0e10cSrcweir 133*cdf0e10cSrcweir <p>The accessible Chart subcomponents all support the service 134*cdf0e10cSrcweir <type>AccessibleChartElement</type></p> 135*cdf0e10cSrcweir 136*cdf0e10cSrcweir @see AccessibleChartElement 137*cdf0e10cSrcweir */ 138*cdf0e10cSrcweir interface ::com::sun::star::accessibility::XAccessibleComponent; 139*cdf0e10cSrcweir}; 140*cdf0e10cSrcweir 141*cdf0e10cSrcweir}; }; }; }; 142*cdf0e10cSrcweir 143*cdf0e10cSrcweir#endif 144