/************************************************************** * * 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_chart_AccessibleChartDocumentView_idl__ #define __com_sun_star_chart_AccessibleChartDocumentView_idl__ #ifndef __com_sun_star_accessibility_XAccessible_idl__ #include #endif #ifndef __com_sun_star_accessibility_XAccessibleContext_idl__ #include #endif #ifndef __com_sun_star_accessibility_XAccessibleComponent_idl__ #include #endif module com { module sun { module star { module chart { /** The AccessibleChartDocumentView service is supported by a Component that represents the view of a Chart document to provide an entry point to the document tree for accessibility.

An object that implements the AccessibleChartDocumentView service provides information about itself and about the chart subcomponents contained in the chart document displayed in a window. This service gives a simplified view on the underlying implementation. It tries both to keep the structure of the accessibility representation tree as simple as possible and provide as much relevant information as possible.

@since OpenOffice 1.1.2 */ published service AccessibleChartDocumentView { /** Base interface for being accessible. It gives access to the XAccessibleContext interface. */ interface ::com::sun::star::accessibility::XAccessible; /** Provide access to a Chart document's view.

You can access the following information:

Role
The object's role is AccessibleRole::DOCUMENT.
Name
Its name is the document's name or the base name of the filename if no document name has been set explicitly.
Description
The description is the document's description or the full filename if no description has been set explicitly.
Children
The subcomponents of a chart. This includes all kinds of titles, a legend and the diagram. The diagram and the legend are the only children that themselves contain children. The Chart subcomponents support the service AccessibleChartElement. Additionally, there may be shapes a user added via the clipboard. For details see the AccessibleShape.
Parent
The parent will usually be the window that contains the Chart document view. It has to be set via implementation dependent ways.
Relations
At the moment relations are not supported. The method XAccessibleContext::getAccessibleRelationSet will always return an empty set.
States
The following states are supported:
  • AccessibleStateType::DEFUNC is set if a document view becomes obsolete like when the window, which displays the view, is closed.
  • AccessibleStateType::ENABLED is always set unless the AccessibleStateType::DEFUNC state is set.
  • AccessibleStateType::OPAQUE is always set.
  • AccessibleStateType::SHOWING is always set unless the AccessibleStateType::DEFUNC state is set.
  • AccessibleStateType::VISIBLE is always set unless the AccessibleStateType::DEFUNC state is set.
Locale
Is the locale set at the document.
Property change listeners
They are supported to inform the listeners about changes in this object.
*/ interface ::com::sun::star::accessibility::XAccessibleContext; /** Provide access to a Chart document's graphical representation.

The main purpose of this interface is to provide a bounding box of the currently visible area and to let the user find the subcomponents of a chart that cover a given test point.

The accessible Chart subcomponents all support the service AccessibleChartElement

@see AccessibleChartElement */ interface ::com::sun::star::accessibility::XAccessibleComponent; }; }; }; }; }; #endif