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
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
|
// -*- c++ -*-
// Generated by gtkmmproc -- DO NOT MODIFY!
#ifndef _ATKMM_IMAGE_H
#define _ATKMM_IMAGE_H
#include <glibmm.h>
/* $Id$ */
/* Copyright (C) 2002 The gtkmm Development Team
*
* This library is free software; you can redistribute it and/or
* modify it under the terms of the GNU Library General Public
* License as published by the Free Software Foundation; either
* version 2 of the License, or (at your option) any later version.
*
* This library is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
* Library General Public License for more details.
*
* You should have received a copy of the GNU Library General Public
* License along with this library; if not, write to the Free
* Software Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
*/
#include <atkmm/component.h> /* for Atk::CoordType */
#ifndef DOXYGEN_SHOULD_SKIP_THIS
extern "C"
{
typedef struct _AtkImageIface AtkImageIface;
typedef struct _AtkImage AtkImage;
}
#endif /* DOXYGEN_SHOULD_SKIP_THIS */
#ifndef DOXYGEN_SHOULD_SKIP_THIS
typedef struct _AtkImage AtkImage;
typedef struct _AtkImageClass AtkImageClass;
#endif /* DOXYGEN_SHOULD_SKIP_THIS */
namespace Atk
{ class Image_Class; } // namespace Atk
namespace Atk
{
/** The ATK Interface implemented by components which expose image or pixmap content on-screen.
* This should be implemented by Atk::Object subtypes on behalf of components which display image/pixmap information
* onscreen, and which provide information (other than just widget borders, etc.) via that image content. For instance,
* icons, buttons with icons, toolbar elements, and image viewing panes typically should implement AtkImage.
*
* Atk::Image primarily provides two types of information: coordinate information (useful for screen review mode of
* screenreaders, and for use by onscreen magnifiers), and descriptive information. The descriptive information is
* provided for alternative, text-only presentation of the most significant information present in the image.
*/
class Image : public Glib::Interface
{
#ifndef DOXYGEN_SHOULD_SKIP_THIS
public:
typedef Image CppObjectType;
typedef Image_Class CppClassType;
typedef AtkImage BaseObjectType;
typedef AtkImageIface BaseClassType;
private:
friend class Image_Class;
static CppClassType image_class_;
// noncopyable
Image(const Image&);
Image& operator=(const Image&);
protected:
Image(); // you must derive from this class
explicit Image(AtkImage* castitem);
#endif /* DOXYGEN_SHOULD_SKIP_THIS */
public:
virtual ~Image();
static void add_interface(GType gtype_implementer);
#ifndef DOXYGEN_SHOULD_SKIP_THIS
static GType get_type() G_GNUC_CONST;
static GType get_base_type() G_GNUC_CONST;
#endif
///Provides access to the underlying C GObject.
AtkImage* gobj() { return reinterpret_cast<AtkImage*>(gobject_); }
///Provides access to the underlying C GObject.
const AtkImage* gobj() const { return reinterpret_cast<AtkImage*>(gobject_); }
private:
public:
/** Sets the textual description for this image.
* @param description A string description to set for @a image .
* @return Boolean <tt>true</tt>, or <tt>false</tt> if operation could
* not be completed.
*/
bool set_image_description(const Glib::ustring& description);
/** Get a textual description of this image.
* @return A string representing the image description.
*/
Glib::ustring get_image_description() const;
/** Get the width and height in pixels for the specified image.
* The values of @a width and @a height are returned as -1 if the
* values cannot be obtained.
* @param width Filled with the image width.
* @param height Filled with the image height.
*/
void get_image_size(int& width, int& height) const;
/** Gets the position of the image in the form of a point specifying the
* images top-left corner. The values of @a x and @a y are returned as -1
* if the values cannot be obtained.
* @param x Address of <tt>int</tt> to put x coordinate position.
* @param y Address of <tt>int</tt> to put y coordinate position.
* @param coord_type Specifies whether the coordinates are relative to the screen
* or to the components top level window.
*/
void get_image_position(int& x, int& y, CoordType coord_type) const;
protected:
virtual bool set_image_description_vfunc(const Glib::ustring& description);
virtual const char* get_image_description_vfunc() const;
virtual void get_image_position_vfunc(int& x, int& y, CoordType coord_type) const;
virtual void get_image_size_vfunc(int& width, int& height) const;
public:
public:
//C++ methods used to invoke GTK+ virtual functions:
protected:
//GTK+ Virtual Functions (override these to change behaviour):
//Default Signal Handlers::
};
} // namespace Atk
namespace Glib
{
/** @relates Atk::Image
* @param object The C instance
* @param take_copy False if the result should take ownership of the C instance. True if it should take a new copy or ref.
* @result A C++ instance that wraps this C instance.
*/
Glib::RefPtr<Atk::Image> wrap(AtkImage* object, bool take_copy = false);
} // namespace Glib
#endif /* _ATKMM_IMAGE_H */
|
