diff options
Diffstat (limited to 'third_party/isimpledom/ISimpleDOMText.idl')
-rw-r--r-- | third_party/isimpledom/ISimpleDOMText.idl | 113 |
1 files changed, 113 insertions, 0 deletions
diff --git a/third_party/isimpledom/ISimpleDOMText.idl b/third_party/isimpledom/ISimpleDOMText.idl new file mode 100644 index 0000000..b68d30d --- /dev/null +++ b/third_party/isimpledom/ISimpleDOMText.idl @@ -0,0 +1,113 @@ +/* -*- Mode: C++; tab-width: 2; indent-tabs-mode: nil; c-basic-offset: 2 -*- + * + * ***** BEGIN LICENSE BLOCK ***** + * Version: MPL 1.1/GPL 2.0/LGPL 2.1 + * + * The contents of this file are subject to the Mozilla Public License Version + * 1.1 (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.mozilla.org/MPL/ + * + * Software distributed under the License is distributed on an "AS IS" basis, + * WITHOUT WARRANTY OF ANY KIND, either express or implied. See the License + * for the specific language governing rights and limitations under the + * License. + * + * The Original Code is the Mozilla browser. + * + * The Initial Developer of the Original Code is + * Netscape Communications Corporation. + * Portions created by the Initial Developer are Copyright (C) 1999 + * the Initial Developer. All Rights Reserved. + * + * Contributor(s): + * + * Alternatively, the contents of this file may be used under the terms of + * either of the GNU General Public License Version 2 or later (the "GPL"), + * or the GNU Lesser General Public License Version 2.1 or later (the "LGPL"), + * in which case the provisions of the GPL or the LGPL are applicable instead + * of those above. If you wish to allow use of your version of this file only + * under the terms of either the GPL or the LGPL, and not to allow others to + * use your version of this file under the terms of the MPL, indicate your + * decision by deleting the provisions above and replace them with the notice + * and other provisions required by the GPL or the LGPL. If you do not delete + * the provisions above, a recipient may use your version of this file under + * the terms of any one of the MPL, the GPL or the LGPL. + * + * ***** END LICENSE BLOCK ***** */ + +import "objidl.idl"; +import "oaidl.idl"; + +cpp_quote("///////////////////////////////////////////////////////////////////////////////////////////////////////") +cpp_quote("//") +cpp_quote("// ISimpleDOMText") +cpp_quote("// ---------------------------------------------------------------------------------------------------=") +cpp_quote("// An interface that extends MSAA's IAccessible to provide important additional capabilities on text nodes") +cpp_quote("//") +cpp_quote("// @STATUS UNDER_REVIEW") +cpp_quote("//") +cpp_quote("// [propget] domText(/* out,retval */ BSTR *domText") +cpp_quote("// ---------------------------------------------------------------------------------------------------=") +cpp_quote("// Similar to IAccessible::get_accName, but does not strip out whitespace characters.") +cpp_quote("// Important for retrieving the correct start/end substring indices to use with other") +cpp_quote("// methods in ISimpleDOMText.") +cpp_quote("//") +cpp_quote("//") +cpp_quote("// get_[un]clippedSubstringBounds(") +cpp_quote("// /* [in] */ unsigned int startIndex,") +cpp_quote("// /* [in] */ unsigned int endIndex,") +cpp_quote("// /* [out] */ int *x,") +cpp_quote("// /* [out] */ int *y,") +cpp_quote("// /* [out] */ int *width,") +cpp_quote("// /* [out] */ int *height);") +cpp_quote("// ---------------------------------------------------------------------------------------------------=") +cpp_quote("// Both methods get_clippedSubstringBounds and get_unclippedSubstringBounds return the screen pixel") +cpp_quote("// coordinates of the given text substring. The in parameters for start and end indices refer") +cpp_quote("// to the string returned by ISimpleDOMText::get_domText().") +cpp_quote("//") +cpp_quote("//") +cpp_quote("// scrollToSubstring(") +cpp_quote("// /* [in] */ unsigned int startIndex,") +cpp_quote("// /* [in] */ unsigned int endIndex);") +cpp_quote("// ---------------------------------------------------------------------------------------------------=") +cpp_quote("// In scrollable views, scrolls to ensure that the specified substring is visible onscreen.") +cpp_quote("// The in parameters for start and end indices refer to the string returned") +cpp_quote("// by ISimpleDOMText::get_domText().") +cpp_quote("//") +cpp_quote("//") +cpp_quote("// [propget] fontFamily(/* out,retval */ BSTR *fontFamily);") +cpp_quote("// ---------------------------------------------------------------------------------------------------=") +cpp_quote("// Return a single computed font family name, which is better than the comma delineated list") +cpp_quote("// that is returned by the ISimpleDOMNode computed style methods for font-family.") +cpp_quote("// In other words, return something like 'Arial' instead of 'Arial, Helvetica, Sans-serif'.") +cpp_quote("///////////////////////////////////////////////////////////////////////////////////////////////////////") +cpp_quote("") +cpp_quote("") + +[object, uuid(4e747be5-2052-4265-8af0-8ecad7aad1c0)] +interface ISimpleDOMText: IUnknown +{ + // Includes whitespace in DOM + [propget] HRESULT domText([out, retval] BSTR *domText); + + HRESULT get_clippedSubstringBounds([in] unsigned int startIndex, + [in] unsigned int endIndex, + [out] int *x, + [out] int *y, + [out] int *width, + [out] int *height); + + HRESULT get_unclippedSubstringBounds([in] unsigned int startIndex, + [in] unsigned int endIndex, + [out] int *x, + [out] int *y, + [out] int *width, + [out] int *height); + + HRESULT scrollToSubstring([in] unsigned int startIndex, + [in] unsigned int endIndex); + + [propget] HRESULT fontFamily([out, retval] BSTR *fontFamily); +}; + |