blob: 861c4364e1f0285072fbaa5f30a721a0c6c555bd (
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
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
|
/*************************************************************************
*
* 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 __com_sun_star_frame_StatusbarController_idl__
#define __com_sun_star_frame_StatusbarController_idl__
#ifndef __com_sun_star_lang_XInitialization_idl__
#include <com/sun/star/lang/XInitialization.idl>
#endif
#ifndef __com_sun_star_util_XUpdatable_idl__
#include <com/sun/star/util/XUpdatable.idl>
#endif
#ifndef __com_sun_star_frame_XStatusListener_idl__
#include <com/sun/star/frame/XStatusListener.idl>
#endif
#ifndef __com_sun_star_frame_XStatusbarController_idl__
#include <com/sun/star/frame/XStatusbarController.idl>
#endif
//=============================================================================
module com { module sun { module star { module frame {
//=============================================================================
/** is an abstract service for a component which offers a more complex user
interface to users within a status bar.
<p>
A generic status bar function is represented as a text field which
provides status information to the user. A status bar controller can be
added to a status bar and provides information or functions with a more
sophisticated user interface.<br/>
A typical example for a status bar controller is the zoom level chooser
within the statusbar. It provides an option to change the zoom level of
an application.
<p>
@see com::sun::star::frame::XDispatchProvider
@see com::sun::star::frame::XStatusbarController
@since OOo 2.0.0
*/
service StatusbarController
{
//-------------------------------------------------------------------------
/** with this interface a component can receive events if a feature has
changed.
<p>
The status bar controller implementation should register itself as a
listener when its <member scope="com::sun::star::util">XUpdatable</member>
interface has been called.
</p>
*/
interface com::sun::star::frame::XStatusListener;
/** used to initialize a component with required arguments.
<b>A status bar controller needs at least three additional arguments
provided as <type scope="com::sun::star::beans">PropertyValue</type>:
<ul>
<li><b>Frame</b><br>a
<type scope="com::sun::star::frame">XFrame</type> instance
to which the status bar controller belongs.</li>
<li><b>CommandURL</b><br>a string which specifies the command
associated with the statusbar controller. The command is
used to identify the status bar controller
implementation.</li>
<li><b>ServiceManager</b><br>a <type scope="com::sun::star::lang">
XMultiServiceFactory</type> instance which can be used to
create additional UNO services.</li>
<li><b>Parent</b><br>a <type scope="com::sun::star::awt">Window</type>
instance which represents the parent window (status bar
window).</li>
<li><b>Identifier</b><br>an integer value which is the unique id
used by the status bar implementation to identify a status
bar entry. This value is currently only used by internal
OpenOffice.org status bar controller implementations.</li>
</ul>
*/
interface com::sun::star::lang::XInitialization;
/** used to notify an implementation that it needs to add its listener or
remove and add them again.
<p>
A status bar controller instance is ready for use after this call has
been made the first time. The status bar implementation guarentees that
the controller's item window has been added to the status bar and its
reference is held by it.
</p>
*/
interface com::sun::star::util::XUpdatable;
//-------------------------------------------------------------------------
/** used to notify changed features and requests for additional user
interface items.
<p>
Mostly used by a status bar implementation to forward information to
and request services from a status bar controller component. This
interface must be useable after
<member scope="com::sun::star::lang">XInitialitation::initialize</member>
has been called. The behavior of the interface is undefined if the
controller component hasn't been initialized.
</p>
*/
interface com::sun::star::frame::XStatusbarController;
};
//=============================================================================
}; }; }; };
#endif
|
