kdeui Library API Documentation

KEdit Class Reference

A simple text editor for the KDE project. More...

#include <keditcl.h>

Inheritance diagram for KEdit:

Inheritance graph
[legend]
Collaboration diagram for KEdit:

Collaboration graph
[legend]
List of all members.

Public Types

enum  { NONE, FORWARD, BACKWARD }
 Search directions. More...


Signals

void gotUrlDrop (QDropEvent *e)
 This signal is emitted if the user dropped a URL over the text editor QMultiLineEdit widget.

void CursorPositionChanged ()
 This signal is emitted whenever the cursor position changes.

void toggle_overwrite_signal ()
 This signal is emitted if the user toggles from insert to overwrite mode or vice versa.


Public Member Functions

 KEdit (QWidget *_parent=NULL, const char *name=NULL)
 The usual constructor.

void insertText (QTextStream *)
 Insert text from the text stream into the edit widget.

void saveText (QTextStream *, bool softWrap)
 Save text from the edit widget to a text stream.

void saveText (QTextStream *)
void selectFont ()
 Let the user select a font and set the font of the textwidget to that selected font.

void search ()
 Present a search dialog to the user.

bool repeatSearch ()
 Repeat the last search specified on the search dialog.

void replace ()
 Present a Search and Replace Dialog to the user.

void doGotoLine ()
 Present a "Goto Line" dialog to the user.

void cleanWhiteSpace ()
 Clean up redundant whitespace from selected text.

void installRBPopup (QPopupMenu *)
 Install a context menu for KEdit.

int currentLine ()
 Retrieve the current line number.

int currentColumn ()
 Retrieve the actual column number the cursor is on.

void spellcheck_start ()
 Start spellchecking mode.

void spellcheck_stop ()
 Exit spellchecking mode.

void setOverwriteEnabled (bool b)
 Allow the user to toggle between insert mode and overwrite mode with the "Insert" key.


Protected Member Functions

void computePosition ()
int doSearch (QString s_pattern, bool case_sensitive, bool regex, bool forward, int line, int col)
int doReplace (QString s_pattern, bool case_sensitive, bool regex, bool forward, int line, int col, bool replace)
void posToRowCol (unsigned int pos, unsigned int &line, unsigned int &col)
 Sets line and col to the position pos, considering word wrap.

virtual void create (WId=0, bool initializeWindow=true, bool destroyOldWindow=true)
 Reimplemented for internal reasons, the API is not affected.

void keyPressEvent (QKeyEvent *)
void dragMoveEvent (QDragMoveEvent *e)
void dragEnterEvent (QDragEnterEvent *e)
void dropEvent (QDropEvent *e)
void contentsDragMoveEvent (QDragMoveEvent *e)
void contentsDragEnterEvent (QDragEnterEvent *e)
void contentsDropEvent (QDropEvent *e)
virtual void virtual_hook (int id, void *data)

Detailed Description

A simple text editor for the KDE project.

This class or method is obsolete, it is provided for compatibility only.. Use KTextEditor::Editor or KTextEdit instead.

Author:
Bernd Johannes Wuebben <wuebben@math.cornell.edu>, Waldo Bastian <bastian@kde.org>

Definition at line 171 of file keditcl.h.


Member Enumeration Documentation

anonymous enum
 

Search directions.

Definition at line 187 of file keditcl.h.


Constructor & Destructor Documentation

KEdit::KEdit QWidget _parent = NULL,
const char *  name = NULL
 

The usual constructor.

Definition at line 47 of file keditcl1.cpp.

References KStdAccel::name(), and KCursor::setAutoHideCursor().


Member Function Documentation

void KEdit::insertText QTextStream  ) 
 

Insert text from the text stream into the edit widget.

Definition at line 78 of file keditcl1.cpp.

References QTextStream::device(), QMultiLineEdit::insertAt(), QString::isNull(), QTextStream::read(), QTextStream::readLine(), QMultiLineEdit::setCursorPosition(), QIODevice::size(), and QMultiLineEdit::textLine().

void KEdit::saveText QTextStream ,
bool  softWrap
 

Save text from the edit widget to a text stream.

If softWrap is false soft line wrappings are replaced with line-feeds If softWrap is true soft line wrappings are ignored.

Since:
3.1

Definition at line 233 of file keditcl1.cpp.

References QString::mid(), QMultiLineEdit::numLines(), and QMultiLineEdit::textLine().

void KEdit::selectFont  ) 
 

Let the user select a font and set the font of the textwidget to that selected font.

Definition at line 516 of file keditcl1.cpp.

References KFontDialog::getFont().

void KEdit::search  ) 
 

Present a search dialog to the user.

Definition at line 50 of file keditcl2.cpp.

References KStdAction::deselect(), and QString::isEmpty().

Referenced by repeatSearch().

bool KEdit::repeatSearch  ) 
 

Repeat the last search specified on the search dialog.

If the user hasn't searched for anything until now, this method will simply return without doing anything.

Returns:
true if a search was done. false if no search was done.

Definition at line 223 of file keditcl2.cpp.

References QString::isEmpty(), and search().

void KEdit::replace  ) 
 

Present a Search and Replace Dialog to the user.

Definition at line 245 of file keditcl2.cpp.

References KStdAction::deselect(), KStdAccel::find(), and QString::isEmpty().

void KEdit::doGotoLine  ) 
 

Present a "Goto Line" dialog to the user.

Definition at line 524 of file keditcl1.cpp.

References QMultiLineEdit::setCursorPosition().

void KEdit::cleanWhiteSpace  ) 
 

Clean up redundant whitespace from selected text.

Definition at line 139 of file keditcl1.cpp.

References KStdAction::deselect(), QString::fromLatin1(), QMultiLineEdit::hasMarkedText(), KStdAccel::insert(), QString::isEmpty(), QChar::isSpace(), QMultiLineEdit::markedText(), QMultiLineEdit::numLines(), QMultiLineEdit::QMultiLineEdit(), QString::right(), KStdAccel::selectAll(), QStringList::split(), and QMultiLineEdit::textLine().

void KEdit::installRBPopup QPopupMenu  ) 
 

Install a context menu for KEdit.

The Popup Menu will be activated on a right mouse button press event.

Definition at line 512 of file keditcl1.cpp.

References KContextMenuManager::insert().

int KEdit::currentLine  ) 
 

Retrieve the current line number.

The current line is the line the cursor is on.

Definition at line 281 of file keditcl1.cpp.

int KEdit::currentColumn  ) 
 

Retrieve the actual column number the cursor is on.

This call differs from QMultiLineEdit::getCursorPosition() in that it returns the actual cursor position and not the character position. Use currentLine() and currentColumn() if you want to display the current line or column in the status bar for example.

Definition at line 288 of file keditcl1.cpp.

void KEdit::spellcheck_start  ) 
 

Start spellchecking mode.

Definition at line 999 of file keditcl2.cpp.

void KEdit::spellcheck_stop  ) 
 

Exit spellchecking mode.

Definition at line 1057 of file keditcl2.cpp.

References KStdAction::deselect().

void KEdit::setOverwriteEnabled bool  b  ) 
 

Allow the user to toggle between insert mode and overwrite mode with the "Insert" key.

See also toggle_overwrite_signal();

The default is false: the user can not toggle.

Definition at line 619 of file keditcl1.cpp.

void KEdit::gotUrlDrop QDropEvent e  )  [signal]
 

This signal is emitted if the user dropped a URL over the text editor QMultiLineEdit widget.

Note that the user can drop also Text on it, but this is already handled internally by QMultiLineEdit.

void KEdit::CursorPositionChanged  )  [signal]
 

This signal is emitted whenever the cursor position changes.

Use this in conjunction with currentLine(), currentColumn() if you need to know the cursor position.

void KEdit::toggle_overwrite_signal  )  [signal]
 

This signal is emitted if the user toggles from insert to overwrite mode or vice versa.

The user can do so by pressing the "Insert" button on a PC keyboard.

This feature must be activated by calling setOverwriteEnabled(true) first.

void KEdit::posToRowCol unsigned int  pos,
unsigned int &  line,
unsigned int &  col
[protected]
 

Sets line and col to the position pos, considering word wrap.

Definition at line 1047 of file keditcl2.cpp.

References QMultiLineEdit::lineLength(), and QMultiLineEdit::numLines().

void KEdit::create WId  = 0,
bool  initializeWindow = true,
bool  destroyOldWindow = true
[protected, virtual]
 

Reimplemented for internal reasons, the API is not affected.

Definition at line 625 of file keditcl1.cpp.

References KCursor::setAutoHideCursor().


The documentation for this class was generated from the following files:
KDE Logo
This file is part of the documentation for kdelibs Version 3.1.5.
Documentation copyright © 1996-2002 the KDE developers.
Generated on Wed Jan 28 13:00:49 2004 by doxygen 1.3.4 written by Dimitri van Heesch, © 1997-2001