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
|
/* -*- Mode: C++; tab-width: 4; indent-tabs-mode: nil; c-basic-offset: 4 -*- */
/*************************************************************************
*
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
*
* Copyright 2000, 2010 Oracle and/or its affiliates.
*
* OpenOffice.org - a multi-platform office productivity suite
*
* This file is part of OpenOffice.org.
*
* OpenOffice.org is free software: you can redistribute it and/or modify
* it under the terms of the GNU Lesser General Public License version 3
* only, as published by the Free Software Foundation.
*
* OpenOffice.org 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 Lesser General Public License version 3 for more details
* (a copy is included in the LICENSE file that accompanied this code).
*
* You should have received a copy of the GNU Lesser General Public License
* version 3 along with OpenOffice.org. If not, see
* <http://www.openoffice.org/license.html>
* for a copy of the LGPLv3 License.
*
************************************************************************/
#ifndef DBACCESS_IMAGEPROVIDER_HXX
#define DBACCESS_IMAGEPROVIDER_HXX
#include <vcl/image.hxx>
/** === begin UNO includes === **/
#include <com/sun/star/sdbc/XConnection.hpp>
#include <com/sun/star/sdb/application/DatabaseObject.hpp>
/** === end UNO includes === **/
#include <tools/string.hxx>
#include <boost/shared_ptr.hpp>
//........................................................................
namespace dbaui
{
//........................................................................
// for convenience of our clients
namespace DatabaseObject = ::com::sun::star::sdb::application::DatabaseObject;
//====================================================================
//= ImageProvider
//====================================================================
struct ImageProvider_Data;
/** provides images for database objects such as tables, queries, forms, reports ...
At the moment, this class cares for small icons only, that is, icons which can be used
in a tree control. On the medium term, we should extend it with support for different-sized
icons.
*/
class ImageProvider
{
private:
::boost::shared_ptr< ImageProvider_Data > m_pData;
public:
/** creates a semi-functional ImageProvider instance
The resulting instance is not able to provide any concrete object images,
but only default images.
*/
ImageProvider();
/** creates an ImageProvider instance
@param _rxConnection
denotes the connection to work for. Must not be <NULL/>.
*/
ImageProvider(
const ::com::sun::star::uno::Reference< ::com::sun::star::sdbc::XConnection >& _rxConnection
);
/** returns the image to be used for a database object with the given name
@param _nDatabaseObjectType
the type of the object. Must be one of the css.sdb.application.DatabaseObject
constants.
@param _rName
the name of the object
@param _out_rImage
the normal image to use for the object
@return
the image to be used for the object.
*/
void getImages(
const String& _rName,
const sal_Int32 _nDatabaseObjectType,
Image& _out_rImage
);
/** returns the default image to be used for a database object
In opposite to getImages, this method does not check the concrete object
for its image, but returns a default image to be used for all objects of the given
type.
@param _nDatabaseObjectType
the type of the object. Must be one of the css.sdb.application.DatabaseObject
constants.
@return
the image to be used for the object type.
*/
Image getDefaultImage(
sal_Int32 _nDatabaseObjectType
);
/** returns the resource ID for the default image to be used for a database object
In opposite to getImages, this method does not check the concrete object
for its image, but returns a default image to be used for all objects of the given
type.
@param _nDatabaseObjectType
the type of the object. Must be one of the css.sdb.application.DatabaseObject
constants.
@return
the resource ID image to be used for the object type. Must be fed into a
ModuleRes instance to actually load the image.
*/
sal_uInt16 getDefaultImageResourceID(
sal_Int32 _nDatabaseObjectType
);
/** retrieves the image to be used for folders of database objects
@param _nDatabaseObjectType
the type of the object. Must be one of the css.sdb.application.DatabaseObject
constants.
@param _rName
the name of the object
@return
the image to be used for folders of the given type
*/
Image getFolderImage(
sal_Int32 _nDatabaseObjectType
);
/** retrieves the image to be used for a database as a whole.
@return
the image to be used for folders of this type
*/
Image getDatabaseImage();
};
//........................................................................
} // namespace dbaui
//........................................................................
#endif // DBACCESS_IMAGEPROVIDER_HXX
/* vim:set shiftwidth=4 softtabstop=4 expandtab: */
|
