michael@0: /************************************************************************* michael@0: * michael@0: * File Name (AccessibleComponent.idl) michael@0: * michael@0: * IAccessible2 IDL Specification michael@0: * michael@0: * Copyright (c) 2007, 2010 Linux Foundation michael@0: * Copyright (c) 2006 IBM Corporation michael@0: * Copyright (c) 2000, 2006 Sun Microsystems, Inc. michael@0: * All rights reserved. michael@0: * michael@0: * michael@0: * Redistribution and use in source and binary forms, with or without michael@0: * modification, are permitted provided that the following conditions michael@0: * are met: michael@0: * michael@0: * 1. Redistributions of source code must retain the above copyright michael@0: * notice, this list of conditions and the following disclaimer. michael@0: * michael@0: * 2. Redistributions in binary form must reproduce the above michael@0: * copyright notice, this list of conditions and the following michael@0: * disclaimer in the documentation and/or other materials michael@0: * provided with the distribution. michael@0: * michael@0: * 3. Neither the name of the Linux Foundation nor the names of its michael@0: * contributors may be used to endorse or promote products michael@0: * derived from this software without specific prior written michael@0: * permission. michael@0: * michael@0: * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND michael@0: * CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, michael@0: * INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF michael@0: * MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE michael@0: * DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR michael@0: * CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, michael@0: * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT michael@0: * NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; michael@0: * LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) michael@0: * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN michael@0: * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR michael@0: * OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, michael@0: * EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. michael@0: * michael@0: * This BSD License conforms to the Open Source Initiative "Simplified michael@0: * BSD License" as published at: michael@0: * http://www.opensource.org/licenses/bsd-license.php michael@0: * michael@0: * IAccessible2 is a trademark of the Linux Foundation. The IAccessible2 michael@0: * mark may be used in accordance with the Linux Foundation Trademark michael@0: * Policy to indicate compliance with the IAccessible2 specification. michael@0: * michael@0: ************************************************************************/ michael@0: michael@0: import "objidl.idl"; michael@0: import "oaidl.idl"; michael@0: import "oleacc.idl"; michael@0: michael@0: /** A value specifying a color in ARGB format, where each 8 bit color component michael@0: specifies alpha, red, green, and blue respectively. The alpha value is optional. michael@0: */ michael@0: typedef long IA2Color; michael@0: michael@0: /** @brief This interface is implemented by any object that can be rendered michael@0: on the screen. michael@0: michael@0: This interface provides the standard mechanism for an assistive technology michael@0: to retrieve information concerning the graphical representation of an object. michael@0: Coordinates used by the functions of this interface are specified in michael@0: different coordinate systems. Their scale is the same and is equal to michael@0: that of the screen coordinate system. In other words all coordinates michael@0: are measured in pixels. They differ in their respective origin: michael@0: michael@0: */ michael@0: [object, uuid(1546D4B0-4C98-4bda-89AE-9A64748BDDE4)] michael@0: interface IAccessibleComponent : IUnknown michael@0: { michael@0: michael@0: /** @brief Returns the location of the upper left corner of the object's michael@0: bounding box relative to the immediate parent object. michael@0: michael@0: The coordinates of the bounding box are given relative to the parent's michael@0: coordinate system. The coordinates of the returned position are relative michael@0: to this object's parent or relative to the screen on which this object michael@0: is rendered if it has no parent. If the object is not on any screen michael@0: the returned position is (0,0). michael@0: michael@0: @param [out] x michael@0: @param [out] y michael@0: @retval S_OK michael@0: */ michael@0: [propget] HRESULT locationInParent michael@0: ( michael@0: [out] long *x, michael@0: [out, retval] long *y michael@0: ); michael@0: michael@0: /** @brief Returns the foreground color of this object. michael@0: @param [out] foreground michael@0: The returned color is the foreground color of this object or, if michael@0: that is not supported, the default foreground color. michael@0: @retval S_OK michael@0: */ michael@0: [propget] HRESULT foreground michael@0: ( michael@0: [out, retval] IA2Color *foreground michael@0: ); michael@0: michael@0: /** @brief Returns the background color of this object. michael@0: @param [out] background michael@0: The returned color is the background color of this object or, if michael@0: that is not supported, the default background color. michael@0: @retval S_OK michael@0: */ michael@0: [propget] HRESULT background michael@0: ( michael@0: [out, retval] IA2Color *background michael@0: ); michael@0: }