mirror of
https://bitbucket.org/smil3y/kdelibs.git
synced 2025-02-23 18:32:49 +00:00
124 lines
4.2 KiB
C++
124 lines
4.2 KiB
C++
/* 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;
|