OpenShot Library | OpenShotAudio  0.2.2
juce_ChangeBroadcaster.cpp
1 /*
2  ==============================================================================
3 
4  This file is part of the JUCE library.
5  Copyright (c) 2017 - ROLI Ltd.
6 
7  JUCE is an open source library subject to commercial or open-source
8  licensing.
9 
10  The code included in this file is provided under the terms of the ISC license
11  http://www.isc.org/downloads/software-support-policy/isc-license. Permission
12  To use, copy, modify, and/or distribute this software for any purpose with or
13  without fee is hereby granted provided that the above copyright notice and
14  this permission notice appear in all copies.
15 
16  JUCE IS PROVIDED "AS IS" WITHOUT ANY WARRANTY, AND ALL WARRANTIES, WHETHER
17  EXPRESSED OR IMPLIED, INCLUDING MERCHANTABILITY AND FITNESS FOR PURPOSE, ARE
18  DISCLAIMED.
19 
20  ==============================================================================
21 */
22 
23 namespace juce
24 {
25 
27 {
28  broadcastCallback.owner = this;
29 }
30 
32 {
33 }
34 
36 {
37  // Listeners can only be safely added when the event thread is locked
38  // You can use a MessageManagerLock if you need to call this from another thread.
39  JUCE_ASSERT_MESSAGE_MANAGER_IS_LOCKED
40 
41  changeListeners.add (listener);
42  anyListeners = true;
43 }
44 
46 {
47  // Listeners can only be safely removed when the event thread is locked
48  // You can use a MessageManagerLock if you need to call this from another thread.
49  JUCE_ASSERT_MESSAGE_MANAGER_IS_LOCKED
50 
51  changeListeners.remove (listener);
52  anyListeners = changeListeners.size() > 0;
53 }
54 
56 {
57  // Listeners can only be safely removed when the event thread is locked
58  // You can use a MessageManagerLock if you need to call this from another thread.
59  JUCE_ASSERT_MESSAGE_MANAGER_IS_LOCKED
60 
61  changeListeners.clear();
62  anyListeners = false;
63 }
64 
66 {
67  if (anyListeners)
68  broadcastCallback.triggerAsyncUpdate();
69 }
70 
72 {
73  // This can only be called by the event thread.
74  JUCE_ASSERT_MESSAGE_MANAGER_IS_LOCKED
75 
76  broadcastCallback.cancelPendingUpdate();
77  callListeners();
78 }
79 
81 {
82  broadcastCallback.handleUpdateNowIfNeeded();
83 }
84 
85 void ChangeBroadcaster::callListeners()
86 {
87  changeListeners.call ([this] (ChangeListener& l) { l.changeListenerCallback (this); });
88 }
89 
90 //==============================================================================
91 ChangeBroadcaster::ChangeBroadcasterCallback::ChangeBroadcasterCallback()
92  : owner (nullptr)
93 {
94 }
95 
96 void ChangeBroadcaster::ChangeBroadcasterCallback::handleAsyncUpdate()
97 {
98  jassert (owner != nullptr);
99  owner->callListeners();
100 }
101 
102 } // namespace juce
virtual ~ChangeBroadcaster()
Destructor.
void addChangeListener(ChangeListener *listener)
Registers a listener to receive change callbacks from this broadcaster.
void removeChangeListener(ChangeListener *listener)
Unregisters a listener from the list.
void sendSynchronousChangeMessage()
Sends a synchronous change message to all the registered listeners.
ChangeBroadcaster() noexcept
Creates an ChangeBroadcaster.
Receives change event callbacks that are sent out by a ChangeBroadcaster.
void sendChangeMessage()
Causes an asynchronous change message to be sent to all the registered listeners. ...
virtual void changeListenerCallback(ChangeBroadcaster *source)=0
Your subclass should implement this method to receive the callback.
void removeAllChangeListeners()
Removes all listeners from the list.
void dispatchPendingMessages()
If a change message has been sent but not yet dispatched, this will call sendSynchronousChangeMessage...