File indexing completed on 2024-05-05 04:21:19
0001 0002 /* 0003 Copyright (c) 2003-2007 Clarence Dang <dang@kde.org> 0004 All rights reserved. 0005 0006 Redistribution and use in source and binary forms, with or without 0007 modification, are permitted provided that the following conditions 0008 are met: 0009 0010 1. Redistributions of source code must retain the above copyright 0011 notice, this list of conditions and the following disclaimer. 0012 2. Redistributions in binary form must reproduce the above copyright 0013 notice, this list of conditions and the following disclaimer in the 0014 documentation and/or other materials provided with the distribution. 0015 0016 THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR 0017 IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES 0018 OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. 0019 IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT, 0020 INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT 0021 NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, 0022 DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY 0023 THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT 0024 (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF 0025 THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. 0026 */ 0027 0028 0029 #ifndef KP_UNZOOMED_THUMBNAIL_VIEW_H 0030 #define KP_UNZOOMED_THUMBNAIL_VIEW_H 0031 0032 0033 #include "views/kpThumbnailView.h" 0034 0035 0036 class kpViewScrollableContainer; 0037 0038 0039 /** 0040 * @short Unzoomed thumbnail view of a document. 0041 * 0042 * This is an unzoomed thumbnail view of a document. Unlike 0043 * @ref kpZoomedThumbnailView, it never changes the zoom level. And unlike 0044 * @ref kpZoomedView, it never resizes itself. Instead, it changes its 0045 * origin according to the main view's scrollable container so that the 0046 * top-left most document pixel displayed in the scrollable container will 0047 * be visible. 0048 * 0049 * Do not call setZoomLevel() nor setOrigin(). 0050 * 0051 * This class is sealed. Do not derive from it. 0052 * 0053 * @author Clarence Dang <dang@kde.org> 0054 */ 0055 /*sealed*/ class kpUnzoomedThumbnailView : public kpThumbnailView 0056 { 0057 Q_OBJECT 0058 0059 public: 0060 /** 0061 * Constructs an unzoomed thumbnail view. 0062 */ 0063 kpUnzoomedThumbnailView (kpDocument *document, 0064 kpToolToolBar *toolToolBar, 0065 kpViewManager *viewManager, 0066 kpView *buddyView, 0067 kpViewScrollableContainer *scrollableContainer, 0068 QWidget *parent); 0069 0070 /** 0071 * Destructs an unzoomed thumbnail view. 0072 */ 0073 ~kpUnzoomedThumbnailView () override; 0074 0075 0076 /** 0077 * Implements @ref kpThumbnailView. 0078 */ 0079 QString caption () const override; 0080 0081 0082 public Q_SLOTS: 0083 /** 0084 * Changes its origin according to the main view's scrollable container 0085 * so that the top-left most document pixel displayed in the scrollable 0086 * container will be visible. 0087 * 0088 * It tries to maximise the used area of this view. Unused areas will 0089 * be set to the widget background thanks to the mask. 0090 * 0091 * Call this if the size of the document changes. 0092 * Already connected to buddyViewScrollableContainer()'s 0093 * contentsMoved() signal. 0094 * Already called by @ref kpThumbnailView resizeEvent(). 0095 * 0096 * Implements @ref kpView. 0097 */ 0098 void adjustToEnvironment () override; 0099 0100 0101 private: 0102 struct kpUnzoomedThumbnailViewPrivate *d; 0103 }; 0104 0105 0106 #endif // KP_UNZOOMED_THUMBNAIL_VIEW_H