blob: a9d5947a99391cae2be7a6a8cdf80b570344a82e (
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
|
/* -*- 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_SD_SOURCE_UI_INC_WINDOWUPDATER_HXX
#define INCLUDED_SD_SOURCE_UI_INC_WINDOWUPDATER_HXX
#include <svl/ctloptions.hxx>
#include <vcl/vclptr.hxx>
#include <sddllapi.h>
#include <vector>
namespace vcl { class Window; }
class OutputDevice;
class SdDrawDocument;
namespace sd {
/** The purpose of the <type>WindowUpdater</type> is to update output
devices to take care of modified global values. These values are
monitored for changes. At the moment this is
the digit language that defines the glyphs to use to render digits.
Other values may be added in the future.
<p>The methods of this class have not been included into the
<type>ViewShell</type> class in order to not clutter its interface any
further. This class accesses some of <type>ViewShell</type> data
members directly and thus is declared as its friend.</p>
<p>Windows that are to be kept up-to-date have to be registered via the
<member>RegisterWindow()</member> method. When a document is given then
this document is reformatted when the monitored option changes.</p>
*/
class WindowUpdater : public utl::ConfigurationListener
{
public:
explicit WindowUpdater();
virtual ~WindowUpdater() throw() override;
/** Add the given device to the list of devices which will be updated
when one of the monitored values changes.
@param pWindow
This device is added to the device list if it is not <null/> and
when it is not already a member of that list.
*/
void RegisterWindow (vcl::Window* pWindow);
/** Remove the given device from the list of devices which will be updated
when one of the monitored values changes.
@param pWindow
This device is removed from the device list when it is a member
of that list.
*/
void UnregisterWindow (vcl::Window* pWindow);
/** Set the document so that it is reformatted when one of the monitored
values changes.
@param pDocument
When <null/> is given document reformatting will not take
place in the future.
*/
void SetDocument (SdDrawDocument* pDocument);
/** Update the given output device and update all text objects of the
view shell if not told otherwise.
@param pWindow
The device to update. When the given pointer is NULL then
nothing is done.
*/
void Update (OutputDevice* pDevice) const;
/** Callback that waits for notifications of a
<type>SvtCTLOptions</type> object.
*/
virtual void ConfigurationChanged ( utl::ConfigurationBroadcaster*, ConfigurationHints nHint) override;
private:
/// Options to monitor for changes.
SvtCTLOptions maCTLOptions;
/// The document rendered in the output devices.
SdDrawDocument* mpDocument;
WindowUpdater (const WindowUpdater& rUpdater) = delete;
WindowUpdater operator= (const WindowUpdater& rUpdater) = delete;
/** Type and data member for a list of devices that have to be kept
up-to-date.
*/
typedef ::std::vector< VclPtr<vcl::Window> > tWindowList;
tWindowList maWindowList;
/** The central method of this class. Update the given output device.
It is the task of the caller to initiate a reformatting of the
document that is rendered on this device to reflect the changes.
@param pWindow
The output device to update. When it is <null/> then the call
is ignored.
*/
void UpdateWindow (OutputDevice* pDevice) const;
};
} // end of namespace sd
#endif
/* vim:set shiftwidth=4 softtabstop=4 expandtab: */
|
