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#ifndef __com_sun_star_presentation_XSlideShowView_idl__ 24*b1cdbd2cSJim Jagielski#define __com_sun_star_presentation_XSlideShowView_idl__ 25*b1cdbd2cSJim Jagielski 26*b1cdbd2cSJim Jagielski#ifndef __com_sun_star_uno_XInterface_idl__ 27*b1cdbd2cSJim Jagielski#include <com/sun/star/uno/XInterface.idl> 28*b1cdbd2cSJim Jagielski#endif 29*b1cdbd2cSJim Jagielski#ifndef __com_sun_star_rendering_XSpriteCanvas_idl__ 30*b1cdbd2cSJim Jagielski#include <com/sun/star/rendering/XSpriteCanvas.idl> 31*b1cdbd2cSJim Jagielski#endif 32*b1cdbd2cSJim Jagielski#ifndef __com_sun_star_util_XModifyListener_idl__ 33*b1cdbd2cSJim Jagielski#include <com/sun/star/util/XModifyListener.idl> 34*b1cdbd2cSJim Jagielski#endif 35*b1cdbd2cSJim Jagielski#ifndef __com_sun_star_awt_XPaintListener_idl__ 36*b1cdbd2cSJim Jagielski#include <com/sun/star/awt/XPaintListener.idl> 37*b1cdbd2cSJim Jagielski#endif 38*b1cdbd2cSJim Jagielski#ifndef __com_sun_star_awt_XMouseListener_idl__ 39*b1cdbd2cSJim Jagielski#include <com/sun/star/awt/XMouseListener.idl> 40*b1cdbd2cSJim Jagielski#endif 41*b1cdbd2cSJim Jagielski#ifndef __com_sun_star_awt_XMouseMotionListener_idl__ 42*b1cdbd2cSJim Jagielski#include <com/sun/star/awt/XMouseMotionListener.idl> 43*b1cdbd2cSJim Jagielski#endif 44*b1cdbd2cSJim Jagielski#ifndef __com_sun_star_awt_Rectangle_idl__ 45*b1cdbd2cSJim Jagielski#include <com/sun/star/awt/Rectangle.idl> 46*b1cdbd2cSJim Jagielski#endif 47*b1cdbd2cSJim Jagielski 48*b1cdbd2cSJim Jagielskimodule com { module sun { module star { module presentation { 49*b1cdbd2cSJim Jagielski 50*b1cdbd2cSJim Jagielski/** View interface to display slideshow presentations on.<p> 51*b1cdbd2cSJim Jagielski 52*b1cdbd2cSJim Jagielski This interface provides the necessary methods to enable an 53*b1cdbd2cSJim Jagielski XSlideShow interface to display a presentation. The slideshow can 54*b1cdbd2cSJim Jagielski be displayed simultaneously on multiple views<p> 55*b1cdbd2cSJim Jagielski 56*b1cdbd2cSJim Jagielski @since OpenOffice 2.4 57*b1cdbd2cSJim Jagielski */ 58*b1cdbd2cSJim Jagielskipublished interface XSlideShowView : ::com::sun::star::uno::XInterface 59*b1cdbd2cSJim Jagielski{ 60*b1cdbd2cSJim Jagielski /** Get view canvas.<p> 61*b1cdbd2cSJim Jagielski 62*b1cdbd2cSJim Jagielski This method gets the underlying XCanvas to display on this 63*b1cdbd2cSJim Jagielski view.<p> 64*b1cdbd2cSJim Jagielski 65*b1cdbd2cSJim Jagielski @return XSpriteCanvas to display on. Must be valid, and the 66*b1cdbd2cSJim Jagielski same object, as long as this view is added to any slide show. 67*b1cdbd2cSJim Jagielski */ 68*b1cdbd2cSJim Jagielski ::com::sun::star::rendering::XSpriteCanvas getCanvas(); 69*b1cdbd2cSJim Jagielski 70*b1cdbd2cSJim Jagielski /** This method clears the whole view area. 71*b1cdbd2cSJim Jagielski 72*b1cdbd2cSJim Jagielski The slideshow uses this method to fully erase the view 73*b1cdbd2cSJim Jagielski content. Since the slideshow has no notion of view size, this 74*b1cdbd2cSJim Jagielski is the only reliable way to wholly clear the view. 75*b1cdbd2cSJim Jagielski */ 76*b1cdbd2cSJim Jagielski void clear(); 77*b1cdbd2cSJim Jagielski 78*b1cdbd2cSJim Jagielski /** Query the current transformation matrix for this view.<p> 79*b1cdbd2cSJim Jagielski 80*b1cdbd2cSJim Jagielski This method returns the transformation matrix of the 81*b1cdbd2cSJim Jagielski view. When notified via the transformation change listener, 82*b1cdbd2cSJim Jagielski the show will be displayed using the new transformation.<p> 83*b1cdbd2cSJim Jagielski 84*b1cdbd2cSJim Jagielski @return the view transformation matrix. Note that the slide 85*b1cdbd2cSJim Jagielski show itself will paint all slides as one-by-one boxes, one 86*b1cdbd2cSJim Jagielski therefore has to at least provide a scaling at this matrix to 87*b1cdbd2cSJim Jagielski blow this up to the desired device pixel size (640 times 480, 88*b1cdbd2cSJim Jagielski or whatever size the output view has). Furthermore, the aspect 89*b1cdbd2cSJim Jagielski ratio of the scaling should match that of the slides 90*b1cdbd2cSJim Jagielski (otherwise, the slides will be scaled anisotrophically). 91*b1cdbd2cSJim Jagielski */ 92*b1cdbd2cSJim Jagielski ::com::sun::star::geometry::AffineMatrix2D getTransformation(); 93*b1cdbd2cSJim Jagielski 94*b1cdbd2cSJim Jagielski /** Add a listener to get notified when the transformation matrix changes.<p> 95*b1cdbd2cSJim Jagielski 96*b1cdbd2cSJim Jagielski This method registers a listener with the view, which will get 97*b1cdbd2cSJim Jagielski called everytime the transformation matrix changes.<p> 98*b1cdbd2cSJim Jagielski 99*b1cdbd2cSJim Jagielski @param xListener 100*b1cdbd2cSJim Jagielski Listener interface to call when the transformation matrix changes. 101*b1cdbd2cSJim Jagielski */ 102*b1cdbd2cSJim Jagielski void addTransformationChangedListener( [in] ::com::sun::star::util::XModifyListener xListener ); 103*b1cdbd2cSJim Jagielski 104*b1cdbd2cSJim Jagielski /** Revoke a previously registered transformation matrix change listener.<p> 105*b1cdbd2cSJim Jagielski 106*b1cdbd2cSJim Jagielski @param xListener 107*b1cdbd2cSJim Jagielski Listener interface to revoke from being called. 108*b1cdbd2cSJim Jagielski */ 109*b1cdbd2cSJim Jagielski void removeTransformationChangedListener( [in] ::com::sun::star::util::XModifyListener xListener ); 110*b1cdbd2cSJim Jagielski 111*b1cdbd2cSJim Jagielski /** Add a listener to get notified when this view needs a repaint.<p> 112*b1cdbd2cSJim Jagielski 113*b1cdbd2cSJim Jagielski This method registers a listener with the view, which will get 114*b1cdbd2cSJim Jagielski called everytime the view needs an update of their screen 115*b1cdbd2cSJim Jagielski representation.<p> 116*b1cdbd2cSJim Jagielski 117*b1cdbd2cSJim Jagielski @param xListener 118*b1cdbd2cSJim Jagielski Listener interface to call when the view needs a repaint. 119*b1cdbd2cSJim Jagielski */ 120*b1cdbd2cSJim Jagielski void addPaintListener( [in] ::com::sun::star::awt::XPaintListener xListener ); 121*b1cdbd2cSJim Jagielski 122*b1cdbd2cSJim Jagielski /** Revoke a previously registered paint listener.<p> 123*b1cdbd2cSJim Jagielski 124*b1cdbd2cSJim Jagielski @param xListener 125*b1cdbd2cSJim Jagielski Listener interface to revoke from being called. 126*b1cdbd2cSJim Jagielski */ 127*b1cdbd2cSJim Jagielski void removePaintListener( [in] ::com::sun::star::awt::XPaintListener xListener ); 128*b1cdbd2cSJim Jagielski 129*b1cdbd2cSJim Jagielski /** Add a mouse listener to the view.<p> 130*b1cdbd2cSJim Jagielski 131*b1cdbd2cSJim Jagielski This method registers a listener with the view, which will get 132*b1cdbd2cSJim Jagielski called everytime the mouse is clicked on the view.<p> 133*b1cdbd2cSJim Jagielski 134*b1cdbd2cSJim Jagielski @param xListener 135*b1cdbd2cSJim Jagielski Listener interface to call when the mouse is clicked on the view. 136*b1cdbd2cSJim Jagielski */ 137*b1cdbd2cSJim Jagielski void addMouseListener( [in] com::sun::star::awt::XMouseListener xListener ); 138*b1cdbd2cSJim Jagielski 139*b1cdbd2cSJim Jagielski /** Revoke a previously registered mouse listener.<p> 140*b1cdbd2cSJim Jagielski 141*b1cdbd2cSJim Jagielski @param xListener 142*b1cdbd2cSJim Jagielski Listener interface to revoke from being called. 143*b1cdbd2cSJim Jagielski */ 144*b1cdbd2cSJim Jagielski void removeMouseListener( [in] com::sun::star::awt::XMouseListener xListener ); 145*b1cdbd2cSJim Jagielski 146*b1cdbd2cSJim Jagielski /** Add a mouse motion listener to the view.<p> 147*b1cdbd2cSJim Jagielski 148*b1cdbd2cSJim Jagielski This method registers a listener with the view, which will get 149*b1cdbd2cSJim Jagielski called everytime the mouse is moved on the view.<p> 150*b1cdbd2cSJim Jagielski 151*b1cdbd2cSJim Jagielski @param xListener 152*b1cdbd2cSJim Jagielski Listener interface to call when the mouse is moved on the view. 153*b1cdbd2cSJim Jagielski */ 154*b1cdbd2cSJim Jagielski void addMouseMotionListener( [in] com::sun::star::awt::XMouseMotionListener xListener ); 155*b1cdbd2cSJim Jagielski 156*b1cdbd2cSJim Jagielski /** Revoke a previously registered mouse move listener.<p> 157*b1cdbd2cSJim Jagielski 158*b1cdbd2cSJim Jagielski @param xListener 159*b1cdbd2cSJim Jagielski Listener interface to revoke from being called. 160*b1cdbd2cSJim Jagielski */ 161*b1cdbd2cSJim Jagielski void removeMouseMotionListener( [in] com::sun::star::awt::XMouseMotionListener xListener ); 162*b1cdbd2cSJim Jagielski 163*b1cdbd2cSJim Jagielski /** Change the mouse cursor currently in effect.<p> 164*b1cdbd2cSJim Jagielski 165*b1cdbd2cSJim Jagielski This method changes the mouse cursor currently in effect, for 166*b1cdbd2cSJim Jagielski this view.<p> 167*b1cdbd2cSJim Jagielski 168*b1cdbd2cSJim Jagielski @param nPointerShape 169*b1cdbd2cSJim Jagielski New mouse cursor shape to display for this view. Must be from 170*b1cdbd2cSJim Jagielski the ::com::sun::star::awt::SystemPointer constant group. 171*b1cdbd2cSJim Jagielski */ 172*b1cdbd2cSJim Jagielski void setMouseCursor( [in] short nPointerShape ); 173*b1cdbd2cSJim Jagielski 174*b1cdbd2cSJim Jagielski /** Get rectangle defining area inside of canvas device which 175*b1cdbd2cSJim Jagielski this slideshow view uses. 176*b1cdbd2cSJim Jagielski */ 177*b1cdbd2cSJim Jagielski ::com::sun::star::awt::Rectangle getCanvasArea(); 178*b1cdbd2cSJim Jagielski}; 179*b1cdbd2cSJim Jagielski 180*b1cdbd2cSJim Jagielski}; }; }; }; 181*b1cdbd2cSJim Jagielski 182*b1cdbd2cSJim Jagielski 183*b1cdbd2cSJim Jagielski#endif 184