LibreOffice Module winaccessibility (master) 1
AccHypertext.h
Go to the documentation of this file.
1/* -*- Mode: C++; tab-width: 4; indent-tabs-mode: nil; c-basic-offset: 4 -*- */
2/*
3 * This file is part of the LibreOffice project.
4 *
5 * This Source Code Form is subject to the terms of the Mozilla Public
6 * License, v. 2.0. If a copy of the MPL was not distributed with this
7 * file, You can obtain one at http://mozilla.org/MPL/2.0/.
8 *
9 * This file incorporates work covered by the following license notice:
10 *
11 * Licensed to the Apache Software Foundation (ASF) under one or more
12 * contributor license agreements. See the NOTICE file distributed
13 * with this work for additional information regarding copyright
14 * ownership. The ASF licenses this file to you under the Apache
15 * License, Version 2.0 (the "License"); you may not use this file
16 * except in compliance with the License. You may obtain a copy of
17 * the License at http://www.apache.org/licenses/LICENSE-2.0 .
18 */
19
20#pragma once
21
22#include "Resource.h" // main symbols
23
24#include <com/sun/star/accessibility/XAccessible.hpp>
25#include <com/sun/star/accessibility/XAccessibleHypertext.hpp>
26#include "AccTextBase.h"
27
31class ATL_NO_VTABLE CAccHypertext :
32 public CComObjectRoot,
33 public CComCoClass<CAccHypertext,&CLSID_AccHypertext>,
35 public CAccTextBase
36{
37public:
39 {
40 }
41
42 BEGIN_COM_MAP(CAccHypertext)
43 COM_INTERFACE_ENTRY(IAccessibleText)
44 COM_INTERFACE_ENTRY(IAccessibleHypertext)
45 COM_INTERFACE_ENTRY(IUNOXWrapper)
46 COM_INTERFACE_ENTRY_FUNC_BLIND(0,SmartQI_)
47#if defined __clang__
48#pragma clang diagnostic push
49#pragma clang diagnostic ignored "-Winconsistent-missing-override"
50#endif
51 END_COM_MAP()
52#if defined __clang__
53#pragma clang diagnostic pop
54#endif
55
56 static HRESULT WINAPI SmartQI_(void* pv,
57 REFIID iid, void** ppvObject, DWORD_PTR)
58 {
59 return static_cast<CAccHypertext*>(pv)->SmartQI(iid,ppvObject);
60 }
61
62 HRESULT SmartQI(REFIID iid, void** ppvObject)
63 {
64 if( m_pOuterUnknown )
65 return OuterQueryInterface(iid,ppvObject);
66 return E_FAIL;
67 }
68
69 DECLARE_NO_REGISTRY()
70
71public:
72 // IAccessibleText
73
74 // Adds a text selection.
75 STDMETHOD(addSelection)(long startOffset, long endOffset) override;//, unsigned char * success)
76
77 // Gets text attributes.
78 STDMETHOD(get_attributes)(long offset, long * startOffset, long * endOffset, BSTR * textAttributes) override;
79
80 // Gets caret offset.
81 STDMETHOD(get_caretOffset)(long * offset) override;
82
83 // Gets bounding rect containing the glyph(s) representing the character
84 // at the specified text offset
85 STDMETHOD(get_characterExtents)(long offset, IA2CoordinateType coordType, long * x, long * y, long * width, long * height) override;
86
87 // Gets number of active non-contiguous selections.
88 STDMETHOD(get_nSelections)(long * nSelections) override;
89
90 // Gets bounding rect for the glyph at a certain point.
91 STDMETHOD(get_offsetAtPoint)(long x, long y, IA2CoordinateType coordType, long * offset) override;
92
93 // Gets character offsets of N-th active text selection.
94 STDMETHOD(get_selection)(long selection, long * startOffset, long * endOffset) override;
95
96 // Gets a range of text by offset NOTE: returned string may be longer
97 // than endOffset-startOffset bytes if text contains multi-byte characters.
98 STDMETHOD(get_text)(long startOffset, long endOffset, BSTR * text) override;
99
100 // Gets a specified amount of text that ends before a specified offset.
101 STDMETHOD(get_textBeforeOffset)(long offset, IA2TextBoundaryType boundaryType, long * startOffset, long * endOffset, BSTR * text) override;
102
103 // Gets a specified amount of text that spans the specified offset.
104 STDMETHOD(get_textAfterOffset)(long offset, IA2TextBoundaryType boundaryType, long * startOffset, long * endOffset, BSTR * text) override;
105
106 // Gets a specified amount of text that starts after a specified offset.
107 STDMETHOD(get_textAtOffset)(long offset, IA2TextBoundaryType boundaryType, long * startOffset, long * endOffset, BSTR * text) override;
108
109 // Unselects a range of text.
110 STDMETHOD(removeSelection)(long selectionIndex) override;
111
112 // Moves text caret.
113 STDMETHOD(setCaretOffset)(long offset) override;
114
115 // Changes the bounds of an existing selection.
116 STDMETHOD(setSelection)(long selectionIndex, long startOffset, long endOffset) override;
117
118 // Gets total number of characters.
119 // NOTE: this may be different than the total number of bytes required
120 // to store the text, if the text contains multi-byte characters.
121 STDMETHOD(get_nCharacters)(long * nCharacters) override;
122
123 // Makes specific part of string visible on screen.
124 STDMETHOD(scrollSubstringTo)(long startIndex, long endIndex,enum IA2ScrollType scrollType) override;
125
126 STDMETHOD(scrollSubstringToPoint)(long startIndex, long endIndex,enum IA2CoordinateType coordinateType, long x, long y ) override;
127
128 STDMETHOD(get_newText)( IA2TextSegment *newText) override;
129
130 STDMETHOD(get_oldText)( IA2TextSegment *oldText) override;
131
132 //IAccessibleHypertext
133
134 // Gets the number of hyperlink.
135 STDMETHOD(get_nHyperlinks)(long *hyperlinkCount) override;
136
137 // Gets the hyperlink object via specified index.
138 STDMETHOD(get_hyperlink)(long index,IAccessibleHyperlink **hyperlink) override;
139
140 // Returns the index of the hyperlink that is associated with this
141 // character index.
142 STDMETHOD(get_hyperlinkIndex)(long charIndex, long *hyperlinkIndex) override;
143
144 // Override of IUNOXWrapper.
145 STDMETHOD(put_XInterface)(hyper pXInterface) override;
146
147private:
148
149 css::uno::Reference<css::accessibility::XAccessibleHypertext> pHyperText;
150
151};
152
153/* vim:set shiftwidth=4 softtabstop=4 expandtab: */
CAccHypertext implements IAccessibleHypertext interface.
Definition: AccHypertext.h:36
static HRESULT WINAPI SmartQI_(void *pv, REFIID iid, void **ppvObject, DWORD_PTR)
Definition: AccHypertext.h:56
HRESULT SmartQI(REFIID iid, void **ppvObject)
Definition: AccHypertext.h:62
IA2ScrollType
These constants control the scrolling of an object or substring into a window.
IA2CoordinateType
These constants define which coordinate system a point is located in.
IA2TextBoundaryType
This enum defines values which specify a text boundary type.
This interface exposes information about hypertext in a document.
This interface gives read-only access to text.
A structure containing a substring and the start and end offsets in the enclosing string.