/usr/include/ktexteditor/smartcursornotifier.h is in kdelibs5-dev 4:4.13.0-0ubuntu1.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
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 | /* This file is part of the KDE project
Copyright (C) 2003-2005 Hamish Rodda <rodda@kde.org>
This library is free software; you can redistribute it and/or
modify it under the terms of the GNU Library General Public
License as published by the Free Software Foundation; either
version 2 of the License, or (at your option) any later version.
This library is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
Library General Public License for more details.
You should have received a copy of the GNU Library General Public License
along with this library; see the file COPYING.LIB. If not, write to
the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor,
Boston, MA 02110-1301, USA.
*/
#ifndef KDELIBS_KTEXTEDITOR_SMARTCURSORNOTIFIER_H
#define KDELIBS_KTEXTEDITOR_SMARTCURSORNOTIFIER_H
#include <ktexteditor/ktexteditor_export.h>
#include <QtCore/QObject>
#include <kdebug.h>
namespace KTextEditor
{
class SmartCursor;
/**
* \short A class which provides notifications of state changes to a SmartCursor via QObject signals.
*
* \ingroup kte_group_smart_classes
*
* This class provides notifications of changes to a SmartCursor such as the
* position in the document, and deletion or insertion of text immediately
* before or after the cursor.
*
* If you prefer to receive notifications via virtual inheritance, see SmartCursorWatcher.
*
* \sa SmartCursor, SmartCursorNotifier
*
* \author Hamish Rodda \<rodda@kde.org\>
*/
class KTEXTEDITOR_EXPORT SmartCursorNotifier : public QObject
{
Q_OBJECT
public:
/**
* Default constructor.
*/
SmartCursorNotifier();
/**
* Returns whether this notifier will notify of changes that happen
* directly to the cursor, e.g. by calls to SmartCursor::setPosition(), rather
* than just when surrounding text changes.
*/
bool wantsDirectChanges() const;
/**
* Set whether this notifier should notify of changes that happen
* directly to the cursor, e.g. by calls to SmartCursor::setPosition(), rather
* than just when surrounding text changes.
*
* \param wantsDirectChanges whether this notifier should provide notifications for direct changes.
*/
void setWantsDirectChanges(bool wantsDirectChanges);
Q_SIGNALS:
/**
* The cursor's position was changed.
*
* \param cursor pointer to the cursor which generated the notification.
*/
void positionChanged(KTextEditor::SmartCursor* cursor);
/**
* The cursor's surrounding characters were both deleted simultaneously.
* The cursor is automatically placed at the start of the deleted region.
*
* \param cursor pointer to the cursor which generated the notification.
*/
void positionDeleted(KTextEditor::SmartCursor* cursor);
/**
* One character immediately surrounding the cursor was deleted.
* If both characters are simultaneously deleted, positionDeleted() is called instead.
*
* \param cursor pointer to the cursor which generated the notification.
* \param deletedBefore \c true if the character immediately before was deleted,
* \c false if the character immediately after was deleted.
*/
void characterDeleted(KTextEditor::SmartCursor* cursor, bool deletedBefore);
/**
* A character was inserted immediately before or after the cursor, as given
* by \p insertedBefore.
*
* \param cursor pointer to the cursor which generated the notification.
* \param insertedBefore \e true if a character was inserted before \p cursor,
* \e false if a character was inserted after
*/
void characterInserted(KTextEditor::SmartCursor* cursor, bool insertedBefore);
/**
* The SmartCursor instance specified by \p cursor is being deleted.
*
* \param cursor pointer to the cursor which is about to be deleted. It is
* still safe to access information at this point.
*/
void deleted(KTextEditor::SmartCursor* cursor);
private:
bool m_wantDirectChanges;
};
}
#endif
// kate: space-indent on; indent-width 2; replace-tabs on;
|