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
174
175
176
177
178
179
180
181
182
|
/* -*- 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 .
*/
module com { module sun { module star { module inspection {
interface XPropertyControl;
/** describes the appearance of a line representing a single property in an ObjectInspector.
Such a line consists of
<ul><li>a label with a human-readable name for the property</li>
<li>a control which is used for user interaction - i.e. it displays the current property
value, and allows the user entering a new one.</li>
<li>(optional) one or two buttons which, when clicked, can start a more complex, interactive
property value input. For instance, if you have a property whose value is a path in the
file system, such a button could be used to let the user browse for a path with a
usual file picker.</li>
</ul>
@see XPropertyHandler::describePropertyLine
@see PropertyLineElement
@since OOo 2.0.3
*/
struct LineDescriptor
{
/** denotes the human-readable display name used to present a property to the user
*/
string DisplayName;
/** denotes the control which should be used to represent the property at the UI.
@see XPropertyControlFactory
*/
XPropertyControl Control;
/** specifies the URL to the help topic to be associated with the property
*/
string HelpURL;
/** determines whether a button exists which can be used for a more complex, interactive
property value input.
<p>If no image for the primary button is specified, but a primary button is present,
the three dots will be displayed on the button.</p>
@see XPropertyHandler::onInteractivePropertySelection
@see HasSecondaryButton
@see PrimaryButtonImageURL
@see PrimaryButtonImage
*/
boolean HasPrimaryButton;
/** describes a unique id to associate with the primary button
<p>In OpenOffice.org, UI elements sometimes require a so-called UniqueID, which can be
used to uniquely (within the whole application) identify this UI element. For instance,
automating the OpenOffice.org UI via a dedicated separate application ("TestTool") requires
such IDs.</p>
<p>If a primary button exists for a property's UI representation (#HasPrimaryButton),
it gets the ID specified herein.</p>
*/
string PrimaryButtonId;
/** describes the URL of an image to display on the primary button, if any.
<p>This URL will be used to obtain an actual com::sun::star::graphic::XGraphic
object from a com::sun::star::graphic::GraphicProvider.</p>
<p>The property will be ignored if #HasPrimaryButton is `FALSE`.</p>
<p>If you need to specify a graphic which does not have a URL, but is available as
com::sun::star::graphic::XGraphic only, then you must leave
<code>PrimaryButtonImageURL</code> empty, and use the #PrimaryButtonImage property.
@see PrimaryButtonImage
*/
string PrimaryButtonImageURL;
/** describes a graphics to display at the primary button, if any.
<p>The property will be ignored if #HasPrimaryButton is `FALSE`, or
if #PrimaryButtonImageURL is a non-empty string.</p>
@see HasPrimaryButton
@see PrimaryButtonImageURL
*/
com::sun::star::graphic::XGraphic PrimaryButtonImage;
/** determines whether a secondary button exists which can be used for a more complex, interactive
property value input.
<p>A secondary button subordinated to the primary button. If no primary button exists
(#HasPrimaryButton), this member is ignored.</p>
@see XPropertyHandler::onInteractivePropertySelection
@see HasSecondaryButton
*/
boolean HasSecondaryButton;
/** describes a unique id to associate with the primary button
<p>If a secondary button exists for a property's UI representation (#HasSecondaryButton),
it gets the ID specified herein.</p>
@see PrimaryButtonId
*/
string SecondaryButtonId;
/** describes the URL of an image to display on the secondary button, if any.
<p>This URL will be used to obtain an actual com::sun::star::graphic::XGraphic
object from a com::sun::star::graphic::GraphicProvider.</p>
<p>The property will be ignored if #HasSecondaryButton is `FALSE`.</p>
<p>If you need to specify a graphic which does not have a URL, but is available as
com::sun::star::graphic::XGraphic only, then you must leave
<code>SecondaryButtonImageURL</code> empty, and use the #SecondaryButtonImage property.
@see SecondaryButtonImage
*/
string SecondaryButtonImageURL;
/** describes a graphics to display at the secondary button, if any.
<p>The property will be ignored if #HasSecondaryButton is `FALSE`, or
if #SecondaryButtonImageURL is a non-empty string.</p>
@see HasSecondaryButton
@see SecondaryButtonImageURL
*/
com::sun::star::graphic::XGraphic SecondaryButtonImage;
/** describes the indent level for the property
<p>If a given property semantically depends on another one, the indent level
can be used to visually represent this fact. For this, the dependent property's
indent level would be one larger than the indent level of the other property.</p>
<p>Normally, XPropertyHandlers will set this to <code>0</code> when describing
the UI for a normal property.
*/
short IndentLevel;
/** describes the category into which the property should be sorted by the ObjectInspector.
<p>An ObjectInspector can visually group properties which semantically belong
together (for instance using tab pages). The decision which properties actually belong together
is made using this #Category attribute.</p>
<p>For your implementation of XPropertyHandler, it's recommended that you document the programmatic
names used for property categories. This way, your handler might be re-used in
different contexts, where only the XObjectInspectorModel needs to provide consistent
UI names for the categories.</p>
@see XObjectInspectorModel::describeCategories
*/
string Category;
};
}; }; }; };
/* vim:set shiftwidth=4 softtabstop=4 expandtab: */
|
