Service AccessibleGraphicShape

Devguide

+ + + + + + + +

Properties' Summary

Properties' Details

+ + + + + + + + + + +

:: drafts :: com :: sun :: star :: drawing ::

service AccessibleGraphicShape

Description: The AccessibleGraphicShape service is implemented by the + graphic object shapes shapes com.sun.star.drawing.GraphicObjectShape and + com.sun.star.presentation.GraphicObjectShape. + +; It differs from the included AccessibleShape 'base' + service by the additional support of the + ::drafts::com::sun::star::accessibility::XAccessibleImage + interface.
+

Included Services
AccessibleShape	+ Description + Give access to information of generic shapes. + + + See AccessibleShape for documentation and support of + the interfaces ::XAccessible , + ::XAccessibleContext , and + ::XAccessibleComponent . + + + See also + AccessibleShape + + + +

::drafts::com::sun::star::accessibility::XAccessibleImage

Description: Give access to image specific information. + +; The support of the ::drafts::com::sun::star::accessibility::XAccessibleImage interface + requires the shape to provide a description of the displayed image + and the image's size in the screen coordinate system (pixel). At + the time being this interface does not provide information that is + not available through the AccessibleShape service: + the size returned by the + ::drafts::com::sun::star::accessibility::XAccessibleImage::getWidth and ::drafts::com::sun::star::accessibility::XAccessibleImage::getHeight functions is the same as that + returned by the ::drafts::com::sun::star::accessibility::XAccessibleComponent::getSize function; the description + returned by ::drafts::com::sun::star::accessibility::XAccessibleImage::getAccessibleImageDescription function + is the same as the one returned by the ::drafts::com::sun::star::accessibility::XAccessibleContext::getAccessibleDescription function. + This makes the additional interface for + the time being basically an indicator of graphic shapes. This may + change in the future.
+

+ + +

+ +

+ Apache "OpenOffice.org" is an effort undergoing incubation at The Apache Software Foundation (ASF), sponsored by the Apache Incubator. + Incubation is required of all newly accepted projects until a further review indicates that the infrastructure, communications, and + decision making process have stabilized in a manner consistent with other successful ASF projects. While incubation status is + not necessarily a reflection of the completeness or stability of the code, it does indicate that the project has + yet to be fully endorsed by the ASF.

+ Contact Us | + Terms of Use +
Apache and the Apache feather logos are trademarks of The Apache Software Foundation. +
OpenOffice.org and the seagull logo are registered trademarks of The Apache Software Foundation. +
Other names appearing on the site may be trademarks of their respective owners. +

+ + + Added: websites/staging/ooo-site/trunk/content/ui/accessibility/apiref/drafts/com/sun/star/drawing/AccessibleOLEShape-xref.html ============================================================================== --- websites/staging/ooo-site/trunk/content/ui/accessibility/apiref/drafts/com/sun/star/drawing/AccessibleOLEShape-xref.html (added) +++ websites/staging/ooo-site/trunk/content/ui/accessibility/apiref/drafts/com/sun/star/drawing/AccessibleOLEShape-xref.html Mon Nov 28 00:45:46 2011 @@ -0,0 +1,108 @@ + + + + + + +Uses of Service AccessibleOLEShape-xref + + + + + + + + + +

+ +

+ + + + + + + + + + + + +

Use

Devguide

+ + + + + + + +

uses of service AccessibleOLEShape

back to service AccessibleOLEShape
+
+ +Services which Include this Service
+ +Singletons which Instantiate this Service
+ +References in Developers Guide
+ +

+ + +

+ +

+ + + Added: websites/staging/ooo-site/trunk/content/ui/accessibility/apiref/drafts/com/sun/star/drawing/AccessibleOLEShape.html ============================================================================== --- websites/staging/ooo-site/trunk/content/ui/accessibility/apiref/drafts/com/sun/star/drawing/AccessibleOLEShape.html (added) +++ websites/staging/ooo-site/trunk/content/ui/accessibility/apiref/drafts/com/sun/star/drawing/AccessibleOLEShape.html Mon Nov 28 00:45:46 2011 @@ -0,0 +1,173 @@ + + + + + + +Service AccessibleOLEShape + + + + + + + + + +

+ +

+ + + + + + + + + + + + +

Devguide

+ + + + + + + +

Properties' Summary

Properties' Details

+ + + + + + + + + + +

:: drafts :: com :: sun :: star :: drawing ::

service AccessibleOLEShape

Description

The AccessibleOLEShape service is implemented by + OLE shapes. + +

This includes generic OLE shapes, frames, plugins, and applets.

+ +

This service supports the additional ::drafts::com::sun::star::accessibility::XAccessibleAction + interface.

+ +

OLE objects are handled as place holders. While not activated the + accessible OLE shape is the only indicator of the OLE objects' + existence. When an OLE object has been activated then the accessbility + tree representing it (as far as that is available) is included directly + under the accessible document view and not under the OLE object. This + is due to underlying implementation constraints and may change in the + future.

+ + +

Included Services
AccessibleShape	+ Description + Give access to information of generic shapes. + + + See AccessibleShape for basic documentation and + support of the ::drafts::com::sun::star::accessibility::XAccessibleContext , and + ::drafts::com::sun::star::accessibility::XAccessibleComponent interfaces. + + + See also + AccessibleShape + + + +

Exported Interfaces
::drafts::com::sun::star::accessibility::XAccessibleAction	+ Description + The intended purpose of the support of this interface is the + activation of the accessible OLE object. This, however, is not + realized at the moment. It therefore serves solely as indicator of + accessible OLE objects. + + +

+ + +

+ +

+ + + Added: websites/staging/ooo-site/trunk/content/ui/accessibility/apiref/drafts/com/sun/star/drawing/AccessibleShape-xref.html ============================================================================== --- websites/staging/ooo-site/trunk/content/ui/accessibility/apiref/drafts/com/sun/star/drawing/AccessibleShape-xref.html (added) +++ websites/staging/ooo-site/trunk/content/ui/accessibility/apiref/drafts/com/sun/star/drawing/AccessibleShape-xref.html Mon Nov 28 00:45:46 2011 @@ -0,0 +1,119 @@ + + + + + + +Uses of Service AccessibleShape-xref + + + + + + + + + +

+ +

+ + + + + + + + + + + + +

Use

Devguide

Services which Include this Service

+ + + + + + + +

uses of service AccessibleShape

back to service AccessibleShape
+
+ +Services which Include this Service
+ +Singletons which Instantiate this Service
+ +References in Developers Guide
+ +

+ + + + + + + +

AccessibleGraphicShape
+AccessibleOLEShape
+

+ + +

+ +

+ + + Added: websites/staging/ooo-site/trunk/content/ui/accessibility/apiref/drafts/com/sun/star/drawing/AccessibleShape.html ============================================================================== --- websites/staging/ooo-site/trunk/content/ui/accessibility/apiref/drafts/com/sun/star/drawing/AccessibleShape.html (added) +++ websites/staging/ooo-site/trunk/content/ui/accessibility/apiref/drafts/com/sun/star/drawing/AccessibleShape.html Mon Nov 28 00:45:46 2011 @@ -0,0 +1,268 @@ + + + + + + +Service AccessibleShape + + + + + + + + + +

+ +

+ + + + + + + + + + + + +

Devguide

+ + + + + + + +

Included Services

+ + + + + + + + + + + + + + + + + + + + +

Properties' Summary

Properties' Details

+ + + + + + + + + + +

:: drafts :: com :: sun :: star :: drawing ::

service AccessibleShape

Description

The AccessibleShape service is implemented by UNO shapes to + provide accessibility information that describe the shapes' features. + A UNO shape is any object that implements the ::com::sun::star::drawing::XShape interface. + +

The content of a draw page is modeled as tree of accessible shapes + and accessible text paragraphs. The root of this (sub-)tree is the + accessible draw document view. An accessible shape implements either + this service or one of the 'derived' services + AccessibleGraphicShape or AccessibleOLEShape . + See the section Children in the description of the + ::XAccessibleContext interface support for more details.

+ +

There are two services that extend this one: the + AccessibleGraphicShape and the + AccessibleOLEShape services provide additional interfaces. + See there for details.

+ +

A shape object is either fully or partially visible on the screen or + has set the state DEFUNC to indicate that it is no longer actively + supported by its parent.

+ +

Each shape object that has not set the DEFUNC state has a valid + parent. That is either the containing draw page or a group shape or a + 3D scene object.

Exported Interfaces
::drafts::com::sun::star::accessibility::XAccessible	+ Description + Base interface for being accessible. It gives access to the + ::XAccessibleContext interface. + + +
::drafts::com::sun::star::accessibility::XAccessibleContext	+ Description + Give access to the structural information of a shape. + + + You can access the following information for the shape being made + accessible: + + Role: The role of all shapes is AccessibleRole::SHAPE . + Name: The name of a shape is its localized type name. + Description: Descriptions are localized and start with the + shape's type and style. After that follow some properties that + differ from the defaults with respect to the style. + Children: The children of a shape are either other accessible + shapes or accessible text paragraphs. Only group shapes, 3D scene + shapes, and OLE shapes may contain other shapes as children. + Some of the shapes may have text paragraphs as (additional) + children. See to be written) for details of + how this text is represented. + Parent: The parent is either the document view as represented by + AccessibleDrawDocumentView or a group shape, 3D + scene shape, or OLE shape. + Relations: Are set and maintained from the outside. See the + service description of the object that has accessible shapes as + children for details. + States: The states supported by this service are: + + AccessibleStateType::DEFUNC is set if an accessible + shape is not visible but still existent for some reason. + This should not really happen and is a sign that someone, + e.g. an AT-Tool holds references to such a shape. The + reason for this is that either the owner of the accessible + shape did not remove it from its list of children or that + the AT-Tool does not care for the events indicating + this. + Usually an object that has the AccessibleStateType::DEFUNC state set has already + been disposed and subsequent calls to this object result in + ::DisposedException exceptions. + If this state is set then no other of the states below is + set. This is also true for the states that are otherwise + allways set (which makes 'allways' more of a sort of + 'normally'). + AccessibleStateType::EDITABLE is always set. + This state is interpreted to mean that not only text but + also other, graphical, properties of a shape can be modified. + AccessibleStateType::ENABLED is always set. + AccessibleStateType::FOCUSABLE is always set. + AccessibleStateType::FOCUSED is set according to + whether the shape currently has the focus. + AccessibleStateType::MULTILINE is set if a shape + supports the ::XAccessibleText interface. + AccessibleStateType::OPAQUE is set for certain shapes + with certain attributes like for a filled rectangle. + AccessibleStateType::RESIZABLE is always set. + AccessibleStateType::SELECTABLE is always set. + AccessibleStateType::SELECTED is set according to + whether the shape is currently selected. + AccessibleStateType::SHOWING is always set. + AccessibleStateType::VISIBLE is always set. + + Locale: The shape returns the locale of its parent. + Property change listeners: Property change listeners that are + registered with a shape are informed of the usual events. + + + +
::drafts::com::sun::star::accessibility::XAccessibleComponent	+ Description + Give access to the graphical representation of a shape. + + + The bounding box returned by the ::drafts::com::sun::star::accessibility::XAccessibleComponent::getBounds function returns the + shape's bounding box clipped at its parent's bounding box + + An accessible shape tries as best as it can to return proper + values for calls to the + ::drafts::com::sun::star::accessibility::XAccessibleExtendedComponent::getForeground and + ::drafts::com::sun::star::accessibility::XAccessibleExtendedComponent::getBackground functions. + If the shape is painted with a uniform and non-transparent color + then the returned colors may differ from the ones visible on the + screen. + + Key bindings are not supported at the moment + + +
::drafts::com::sun::star::accessibility::XAccessibleExtendedComponent	+ [ OPTIONAL ] + Description + Give extended access to the graphical representation of a shape. + + + The functions ::drafts::com::sun::star::accessibility::XAccessibleExtendedComponent::getFont , + ::drafts::com::sun::star::accessibility::XAccessibleExtendedComponent::getTitledBorderText , and + ::drafts::com::sun::star::accessibility::XAccessibleExtendedComponent::getToolTipText are not + supported and return empty references respectively empty + strings. + + The support of this interface is optional to reduce overhead in + case that no text is displayed and color information can not be + determined with an acceptable cost. + + +

+ + +

+ +

+ + + Added: websites/staging/ooo-site/trunk/content/ui/accessibility/apiref/drafts/com/sun/star/drawing/AccessibleSlideView-xref.html ============================================================================== --- websites/staging/ooo-site/trunk/content/ui/accessibility/apiref/drafts/com/sun/star/drawing/AccessibleSlideView-xref.html (added) +++ websites/staging/ooo-site/trunk/content/ui/accessibility/apiref/drafts/com/sun/star/drawing/AccessibleSlideView-xref.html Mon Nov 28 00:45:46 2011 @@ -0,0 +1,108 @@ + + + + + + +Uses of Service AccessibleSlideView-xref + + + + + + + + + +

+ +

+ + + + + + + + + + + + +

Use

Devguide

+ + + + + + + +

uses of service AccessibleSlideView

back to service AccessibleSlideView
+
+ +Services which Include this Service
+ +Singletons which Instantiate this Service
+ +References in Developers Guide
+ +

+ + +

+ +

+ + + Added: websites/staging/ooo-site/trunk/content/ui/accessibility/apiref/drafts/com/sun/star/drawing/AccessibleSlideView.html ============================================================================== --- websites/staging/ooo-site/trunk/content/ui/accessibility/apiref/drafts/com/sun/star/drawing/AccessibleSlideView.html (added) +++ websites/staging/ooo-site/trunk/content/ui/accessibility/apiref/drafts/com/sun/star/drawing/AccessibleSlideView.html Mon Nov 28 00:45:46 2011 @@ -0,0 +1,164 @@ + + + + + + +Service AccessibleSlideView + + + + + + + + + +

+ +

+ + + + + + + + + + + + +

Devguide

+ + + + + + + +

Included Services

+ + + + + + + + + + + + + + + + + + + + + + + + +

Properties' Summary

Properties' Details

+ + + + + + + + + + +

:: drafts :: com :: sun :: star :: drawing ::

service AccessibleSlideView

Description: The AccessibleSlideView service is implemented by + slide views of Impress documents. + +; An accessible slide view gives access to all visible slides of a + slide view.
+

Exported Interfaces
::drafts::com::sun::star::accessibility::XAccessible	+ This interface has to be implemented by any class that wants to be + accessible. + +
::drafts::com::sun::star::accessibility::XAccessibleContext	+ Implement this interface for exposing various aspects of a class' + content. + +
::drafts::com::sun::star::accessibility::XAccessibleEventBroadcaster	+ makes it possible to register listeners which are called whenever + an accessibility event (see ::drafts::com::sun::star::accessibility::AccessibleEventObject ) occurs. + +
::drafts::com::sun::star::accessibility::XAccessibleComponent	+ The ::drafts::com::sun::star::accessibility::XAccessibleComponent interface should be supported by + any class that can be rendered on the screen. + +
::drafts::com::sun::star::accessibility::XAccessibleSelection	+ Implement this interface to represent a selection of accessible objects. + +

+ + +

+ +

+ + + Added: websites/staging/ooo-site/trunk/content/ui/accessibility/apiref/drafts/com/sun/star/drawing/AccessibleSlideViewObject-xref.html ============================================================================== --- websites/staging/ooo-site/trunk/content/ui/accessibility/apiref/drafts/com/sun/star/drawing/AccessibleSlideViewObject-xref.html (added) +++ websites/staging/ooo-site/trunk/content/ui/accessibility/apiref/drafts/com/sun/star/drawing/AccessibleSlideViewObject-xref.html Mon Nov 28 00:45:46 2011 @@ -0,0 +1,108 @@ + + + + + + +Uses of Service AccessibleSlideViewObject-xref + + + + + + + + + +

+ +

+ + + + + + + + + + + + +

Use

Devguide

+ + + + + + + +

uses of service AccessibleSlideViewObject

back to service AccessibleSlideViewObject
+
+ +Services which Include this Service
+ +Singletons which Instantiate this Service
+ +References in Developers Guide
+ +

+ + +

+ +

+ + + Added: websites/staging/ooo-site/trunk/content/ui/accessibility/apiref/drafts/com/sun/star/drawing/AccessibleSlideViewObject.html ============================================================================== --- websites/staging/ooo-site/trunk/content/ui/accessibility/apiref/drafts/com/sun/star/drawing/AccessibleSlideViewObject.html (added) +++ websites/staging/ooo-site/trunk/content/ui/accessibility/apiref/drafts/com/sun/star/drawing/AccessibleSlideViewObject.html Mon Nov 28 00:45:46 2011 @@ -0,0 +1,157 @@ + + + + + + +Service AccessibleSlideViewObject + + + + + + + + + +

+ +

+ + + + + + + + + + + + +

Devguide

+ + + + + + + +

Included Services

+ + + + + + + + + + + + + + + + + + + + +

Properties' Summary

Properties' Details

+ + + + + + + + + + +

:: drafts :: com :: sun :: star :: drawing ::

service AccessibleSlideViewObject

Description: The AccessibleSlideViewObject service is implemented by + the slides of the slide view of Impress documents. + +; An accessible slide view object gives access to one of the visible + slides of a slide view.
+

Exported Interfaces
::drafts::com::sun::star::accessibility::XAccessible	+ This interface has to be implemented by any class that wants to be + accessible. + +
::drafts::com::sun::star::accessibility::XAccessibleContext	+ Implement this interface for exposing various aspects of a class' + content. + +
::drafts::com::sun::star::accessibility::XAccessibleEventBroadcaster	+ makes it possible to register listeners which are called whenever + an accessibility event (see ::drafts::com::sun::star::accessibility::AccessibleEventObject ) occurs. + +
::drafts::com::sun::star::accessibility::XAccessibleComponent	+ The ::drafts::com::sun::star::accessibility::XAccessibleComponent interface should be supported by + any class that can be rendered on the screen. + +

+ + +

+ +

+ + + Added: websites/staging/ooo-site/trunk/content/ui/accessibility/apiref/drafts/com/sun/star/drawing/module-ix.html ============================================================================== --- websites/staging/ooo-site/trunk/content/ui/accessibility/apiref/drafts/com/sun/star/drawing/module-ix.html (added) +++ websites/staging/ooo-site/trunk/content/ui/accessibility/apiref/drafts/com/sun/star/drawing/module-ix.html Mon Nov 28 00:45:46 2011 @@ -0,0 +1,163 @@ + + + + + + +Module drawing + + + + + + + + + +

+ +

+ + + + + + + + + + + + +

Module

Use

Devguide

+ + + + + + + + + + + + + + + + + + + + + + + + + + + + +

+ + + + + + + + + + + + +

Nested Modules

Services

Singletons

Interfaces

Structs

Exceptions

Enums

Typedefs

Constant Groups

+ + + + + + + + + +

:: drafts :: com :: sun :: star ::

module drawing

Services
AccessibleDrawDocumentView	The AccessibleDrawDocumentView service is implemented by + views of Draw and Impress documents. + +
AccessibleGraphicShape	The AccessibleGraphicShape service is implemented by the + graphic object shapes shapes com.sun.star.drawing.GraphicObjectShape and + com.sun.star.presentation.GraphicObjectShape. + +
AccessibleOLEShape	The AccessibleOLEShape service is implemented by + OLE shapes. + +
AccessibleShape	The AccessibleShape service is implemented by UNO shapes to + provide accessibility information that describe the shapes' features. + A UNO shape is any object that implements the ::com::sun::star::drawing::XShape interface. + +
AccessibleSlideView	The AccessibleSlideView service is implemented by + slide views of Impress documents. + +
AccessibleSlideViewObject	The AccessibleSlideViewObject service is implemented by + the slides of the slide view of Impress documents. + +

+ + +

+ +

+ + + Added: websites/staging/ooo-site/trunk/content/ui/accessibility/apiref/drafts/com/sun/star/formula/AccessibleFormulaText-xref.html ============================================================================== --- websites/staging/ooo-site/trunk/content/ui/accessibility/apiref/drafts/com/sun/star/formula/AccessibleFormulaText-xref.html (added) +++ websites/staging/ooo-site/trunk/content/ui/accessibility/apiref/drafts/com/sun/star/formula/AccessibleFormulaText-xref.html Mon Nov 28 00:45:46 2011 @@ -0,0 +1,108 @@ + + + + + + +Uses of Service AccessibleFormulaText-xref + + + + + + + + + +

+ +

+ + + + + + + + + + + + +

Use

Devguide

+ + + + + + + +

uses of service AccessibleFormulaText

back to service AccessibleFormulaText
+
+ +Services which Include this Service
+ +Singletons which Instantiate this Service
+ +References in Developers Guide
+ +