1*b1cdbd2cSJim Jagielski /**************************************************************
2*b1cdbd2cSJim Jagielski  *
3*b1cdbd2cSJim Jagielski  * Licensed to the Apache Software Foundation (ASF) under one
4*b1cdbd2cSJim Jagielski  * or more contributor license agreements.  See the NOTICE file
5*b1cdbd2cSJim Jagielski  * distributed with this work for additional information
6*b1cdbd2cSJim Jagielski  * regarding copyright ownership.  The ASF licenses this file
7*b1cdbd2cSJim Jagielski  * to you under the Apache License, Version 2.0 (the
8*b1cdbd2cSJim Jagielski  * "License"); you may not use this file except in compliance
9*b1cdbd2cSJim Jagielski  * with the License.  You may obtain a copy of the License at
10*b1cdbd2cSJim Jagielski  *
11*b1cdbd2cSJim Jagielski  *   http://www.apache.org/licenses/LICENSE-2.0
12*b1cdbd2cSJim Jagielski  *
13*b1cdbd2cSJim Jagielski  * Unless required by applicable law or agreed to in writing,
14*b1cdbd2cSJim Jagielski  * software distributed under the License is distributed on an
15*b1cdbd2cSJim Jagielski  * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
16*b1cdbd2cSJim Jagielski  * KIND, either express or implied.  See the License for the
17*b1cdbd2cSJim Jagielski  * specific language governing permissions and limitations
18*b1cdbd2cSJim Jagielski  * under the License.
19*b1cdbd2cSJim Jagielski  *
20*b1cdbd2cSJim Jagielski  *************************************************************/
21*b1cdbd2cSJim Jagielski 
22*b1cdbd2cSJim Jagielski 
23*b1cdbd2cSJim Jagielski 
24*b1cdbd2cSJim Jagielski #ifndef INCLUDED_SLIDESHOW_VIEWEVENTHANDLER_HXX
25*b1cdbd2cSJim Jagielski #define INCLUDED_SLIDESHOW_VIEWEVENTHANDLER_HXX
26*b1cdbd2cSJim Jagielski 
27*b1cdbd2cSJim Jagielski #include <boost/shared_ptr.hpp>
28*b1cdbd2cSJim Jagielski #include <boost/weak_ptr.hpp>
29*b1cdbd2cSJim Jagielski 
30*b1cdbd2cSJim Jagielski #include "unoview.hxx"
31*b1cdbd2cSJim Jagielski 
32*b1cdbd2cSJim Jagielski 
33*b1cdbd2cSJim Jagielski /* Definition of ViewEventHandler interface */
34*b1cdbd2cSJim Jagielski 
35*b1cdbd2cSJim Jagielski namespace slideshow
36*b1cdbd2cSJim Jagielski {
37*b1cdbd2cSJim Jagielski     namespace internal
38*b1cdbd2cSJim Jagielski     {
39*b1cdbd2cSJim Jagielski 
40*b1cdbd2cSJim Jagielski         /** Interface for handling view events.
41*b1cdbd2cSJim Jagielski 
42*b1cdbd2cSJim Jagielski         	Classes implementing this interface can be added to an
43*b1cdbd2cSJim Jagielski         	EventMultiplexer object, and are called from there to
44*b1cdbd2cSJim Jagielski         	handle view events.
45*b1cdbd2cSJim Jagielski          */
46*b1cdbd2cSJim Jagielski         class ViewEventHandler
47*b1cdbd2cSJim Jagielski         {
48*b1cdbd2cSJim Jagielski         public:
~ViewEventHandler()49*b1cdbd2cSJim Jagielski             virtual ~ViewEventHandler() {}
50*b1cdbd2cSJim Jagielski 
51*b1cdbd2cSJim Jagielski             /** Notify new view.
52*b1cdbd2cSJim Jagielski 
53*b1cdbd2cSJim Jagielski             	@param rView
54*b1cdbd2cSJim Jagielski                 The newly added view
55*b1cdbd2cSJim Jagielski              */
56*b1cdbd2cSJim Jagielski             virtual void viewAdded( const UnoViewSharedPtr& rView ) = 0;
57*b1cdbd2cSJim Jagielski 
58*b1cdbd2cSJim Jagielski             /** Notify removed view.
59*b1cdbd2cSJim Jagielski 
60*b1cdbd2cSJim Jagielski             	@param rView
61*b1cdbd2cSJim Jagielski                 The removed view
62*b1cdbd2cSJim Jagielski              */
63*b1cdbd2cSJim Jagielski             virtual void viewRemoved( const UnoViewSharedPtr& rView ) = 0;
64*b1cdbd2cSJim Jagielski 
65*b1cdbd2cSJim Jagielski             /** Notify changed view.
66*b1cdbd2cSJim Jagielski 
67*b1cdbd2cSJim Jagielski                 Reasons for a viewChanged notification can be
68*b1cdbd2cSJim Jagielski                 different view size, transformation, or other device
69*b1cdbd2cSJim Jagielski                 properties (color resolution or profile, etc.)
70*b1cdbd2cSJim Jagielski 
71*b1cdbd2cSJim Jagielski             	@param rView
72*b1cdbd2cSJim Jagielski                 The changed view
73*b1cdbd2cSJim Jagielski              */
74*b1cdbd2cSJim Jagielski             virtual void viewChanged( const UnoViewSharedPtr& rView ) = 0;
75*b1cdbd2cSJim Jagielski 
76*b1cdbd2cSJim Jagielski             /** Notify that all views changed.
77*b1cdbd2cSJim Jagielski 
78*b1cdbd2cSJim Jagielski                 Reasons for a viewChanged notification can be
79*b1cdbd2cSJim Jagielski                 different view size, transformation, or other device
80*b1cdbd2cSJim Jagielski                 properties (color resolution or profile, etc.)
81*b1cdbd2cSJim Jagielski 
82*b1cdbd2cSJim Jagielski                 Note that this method avoids hidden inefficiencies
83*b1cdbd2cSJim Jagielski                 (O(n^2) behaviour when viewChanged() needs to perform
84*b1cdbd2cSJim Jagielski                 linear searches)
85*b1cdbd2cSJim Jagielski              */
86*b1cdbd2cSJim Jagielski             virtual void viewsChanged() = 0;
87*b1cdbd2cSJim Jagielski         };
88*b1cdbd2cSJim Jagielski 
89*b1cdbd2cSJim Jagielski         typedef ::boost::shared_ptr< ViewEventHandler > ViewEventHandlerSharedPtr;
90*b1cdbd2cSJim Jagielski         typedef ::boost::weak_ptr< ViewEventHandler >   ViewEventHandlerWeakPtr;
91*b1cdbd2cSJim Jagielski 
92*b1cdbd2cSJim Jagielski     }
93*b1cdbd2cSJim Jagielski }
94*b1cdbd2cSJim Jagielski 
95*b1cdbd2cSJim Jagielski #endif /* INCLUDED_SLIDESHOW_VIEWEVENTHANDLER_HXX */
96