blob: 14be8b0499ac81b3dc5ebbda30ad20c420d5e9e8 (
plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
|
/* -*- Mode: C++; tab-width: 4; indent-tabs-mode: nil; c-basic-offset: 4 -*- */
/*
* This file is part of the LibreOffice project.
*
* This Source Code Form is subject to the terms of the Mozilla Public
* License, v. 2.0. If a copy of the MPL was not distributed with this
* file, You can obtain one at http://mozilla.org/MPL/2.0/.
*
* This file incorporates work covered by the following license notice:
*
* 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 .
*/
#ifndef INCLUDED_SVX_IACCESSIBLEVIEWFORWARDER_HXX
#define INCLUDED_SVX_IACCESSIBLEVIEWFORWARDER_HXX
#include <sal/types.h>
#include <tools/gen.hxx>
namespace accessibility {
/** <p>This interface provides the means to transform between internal
coordinates in 100th of mm and screen coordinates without giving direct
access to the underlying view. Each view forwarder represents a
specific real or virtual window. A call to
<method>GetVisibleArea</method> returns the visible rectangle that
corresponds to this window.</p>
<p>This interface is similar to the SvxViewForwarder but
differs in two important points: Firstly the <member>GetVisArea</member>
method returns a rectangle in internal coordinates and secondly the
transformation methods do not require explicit mapmodes. These have to
be provided implicitly by the classes that implement this
interface. A third, less important, difference are the additional
transfomation methods for sizes. The reasons for their existence are
convenience and improved performance.</p>
@attention
Note, that modifications of the underlying view that lead to
different transformations between internal and screen coordinates or
change the validity of the forwarder have to be signaled separately.
*/
class IAccessibleViewForwarder
{
public:
virtual ~IAccessibleViewForwarder(){};
/** This method informs you about the state of the forwarder. Do not
use it when the returned value is <false/>.
@return
Return <true/> if the view forwarder is valid and <false/> else.
*/
virtual bool IsValid() const = 0;
/** Returns the area of the underlying document that is visible in the
* corresponding window.
@return
The rectangle of the visible part of the document. The values
are, contrary to the base class, in internal coordinates of
100th of mm.
*/
virtual Rectangle GetVisibleArea() const = 0;
/** Transform the specified point from internal coordinates in 100th of
mm to an absolute screen position.
@param rPoint
Point in internal coordinates (100th of mm).
@return
The same point but in screen coordinates relative to the upper
left corner of the (current) screen.
*/
virtual Point LogicToPixel (const Point& rPoint) const = 0;
/** Transform the specified size from internal coordinates in 100th of
mm to a screen oriented pixel size.
@param rSize
Size in internal coordinates (100th of mm).
@return
The same size but in screen coordinates.
*/
virtual Size LogicToPixel (const Size& rSize) const = 0;
/** Transform the specified point from absolute screen coordinates to
internal coordinates (100th of mm).
@param rPoint
Point in screen coordinates relative to the upper left corner of
the (current) screen.
@return
The same point but in internal coordinates (100th of mm).
*/
virtual Point PixelToLogic (const Point& rPoint) const = 0;
/** Transform the specified size from screen coordinates to internal
coordinates (100th of mm).
@param rSize
Size in screen coordinates.
@return
The same size but in internal coordinates (100th of mm).
*/
virtual Size PixelToLogic (const Size& rSize) const = 0;
};
} // end of namespace accessibility
#endif
/* vim:set shiftwidth=4 softtabstop=4 expandtab: */
|
