KTextEditor

View on LXR

#include <mainwindow.h>

Inheritance diagram for KTextEditor::MainWindow:

Public Types
enum	ToolViewPosition { Left = 0, Right = 1, Top = 2, Bottom = 3 }

Signals
void	pluginViewCreated (const QString &name, QObject *pluginView)

void	pluginViewDeleted (const QString &name, QObject *pluginView)

void	unhandledShortcutOverride (QEvent *e)

void	viewChanged (KTextEditor::View *view)

void	viewCreated (KTextEditor::View *view)

Public Member Functions
	MainWindow (QObject *parent)

virtual	~MainWindow ()

KTextEditor::View *	activateView (KTextEditor::Document *document)

KTextEditor::View *	activeView ()

void	addWidgetToViewBar (KTextEditor::View view, QWidget bar)

bool	closeSplitView (KTextEditor::View *view)

bool	closeView (KTextEditor::View *view)

QWidget *	createToolView (KTextEditor::Plugin *plugin, const QString &identifier, KTextEditor::MainWindow::ToolViewPosition pos, const QIcon &icon, const QString &text)

QWidget *	createViewBar (KTextEditor::View *view)

void	deleteViewBar (KTextEditor::View *view)

KXMLGUIFactory *	guiFactory ()

bool	hideToolView (QWidget *widget)

void	hideViewBar (KTextEditor::View *view)

bool	moveToolView (QWidget *widget, KTextEditor::MainWindow::ToolViewPosition pos)

KTextEditor::View *	openUrl (const QUrl &url, const QString &encoding=QString())

QObject *	pluginView (const QString &name)

bool	showPluginConfigPage (KTextEditor::Plugin *plugin, int page)

bool	showToolView (QWidget *widget)

void	showViewBar (KTextEditor::View *view)

void	splitView (Qt::Orientation orientation)

QList< KTextEditor::View * >	views ()

bool	viewsInSameSplitView (KTextEditor::View view1, KTextEditor::View view2)

QWidget *	window ()

Public Member Functions inherited from QObject
	QObject (QObject *parent)

bool	blockSignals (bool block)

const QObjectList &	children () const

QMetaObject::Connection	connect (const QObject sender, const char signal, const char *method, Qt::ConnectionType type) const

void	deleteLater ()

void	destroyed (QObject *obj)

bool	disconnect (const char signal, const QObject receiver, const char *method) const

bool	disconnect (const QObject receiver, const char method) const

void	dumpObjectInfo ()

void	dumpObjectTree ()

QList< QByteArray >	dynamicPropertyNames () const

virtual bool	event (QEvent *e)

virtual bool	eventFilter (QObject watched, QEvent event)

T	findChild (const QString &name, QFlags< Qt::FindChildOption > options) const

QList< T >	findChildren (const QString &name, QFlags< Qt::FindChildOption > options) const

QList< T >	findChildren (const QRegExp &regExp, QFlags< Qt::FindChildOption > options) const

QList< T >	findChildren (const QRegularExpression &re, QFlags< Qt::FindChildOption > options) const

bool	inherits (const char *className) const

void	installEventFilter (QObject *filterObj)

bool	isWidgetType () const

bool	isWindowType () const

void	killTimer (int id)

virtual const QMetaObject *	metaObject () const

void	moveToThread (QThread *targetThread)

QString	objectName () const

void	objectNameChanged (const QString &objectName)

QObject *	parent () const

QVariant	property (const char *name) const

void	removeEventFilter (QObject *obj)

void	setObjectName (const QString &name)

void	setParent (QObject *parent)

bool	setProperty (const char *name, const QVariant &value)

bool	signalsBlocked () const

int	startTimer (int interval, Qt::TimerType timerType)

QThread *	thread () const

Additional Inherited Members
Properties inherited from QObject
	objectName

Static Public Member Functions inherited from QObject
QMetaObject::Connection	connect (const QObject sender, const char signal, const QObject receiver, const char method, Qt::ConnectionType type)

QMetaObject::Connection	connect (const QObject sender, const QMetaMethod &signal, const QObject receiver, const QMetaMethod &method, Qt::ConnectionType type)

QMetaObject::Connection	connect (const QObject sender, PointerToMemberFunction signal, const QObject receiver, PointerToMemberFunction method, Qt::ConnectionType type)

QMetaObject::Connection	connect (const QObject *sender, PointerToMemberFunction signal, Functor functor)

QMetaObject::Connection	connect (const QObject sender, PointerToMemberFunction signal, const QObject context, Functor functor, Qt::ConnectionType type)

bool	disconnect (const QMetaObject::Connection &connection)

bool	disconnect (const QObject sender, const char signal, const QObject receiver, const char method)

bool	disconnect (const QObject sender, PointerToMemberFunction signal, const QObject receiver, PointerToMemberFunction method)

bool	disconnect (const QObject sender, const QMetaMethod &signal, const QObject receiver, const QMetaMethod &method)

QString	tr (const char sourceText, const char disambiguation, int n)

QString	trUtf8 (const char sourceText, const char disambiguation, int n)

Protected Member Functions inherited from QObject
virtual void	childEvent (QChildEvent *event)

virtual void	connectNotify (const QMetaMethod &signal)

virtual void	customEvent (QEvent *event)

virtual void	disconnectNotify (const QMetaMethod &signal)

bool	isSignalConnected (const QMetaMethod &signal) const

int	receivers (const char *signal) const

QObject *	sender () const

int	senderSignalIndex () const

virtual void	timerEvent (QTimerEvent *event)

Detailed Description

This class allows the application that embeds the KTextEditor component to allow it to access parts of its main window.

For example the component can get a place to show view bar widgets (e.g. search&replace, goto line, ...). This is useful to e.g. have one place inside the window to show such stuff even if the application allows the user to have multiple split views available per window.

The application must pass a pointer to the MainWindow object to the createView method on view creation and ensure that this main window stays valid for the complete lifetime of the view.

It must not reimplement this class but construct an instance and pass a pointer to a QObject that has the required slots to receive the requests.

Definition at line 56 of file mainwindow.h.

Member Enumeration Documentation

enum KTextEditor::MainWindow::ToolViewPosition

Toolview position.

A toolview can only be at one side at a time.

Enumerator
Left	Left side.
Right	Right side.
Top	Top side.
Bottom	Bottom side.

Definition at line 223 of file mainwindow.h.

Constructor & Destructor Documentation

KTextEditor::MainWindow::MainWindow ( QObject * parent )

Construct an MainWindow wrapper object.

The passed parent is both the parent of this QObject and the receiver of all interface calls via invokeMethod.

Parameters

parent object the calls are relayed to

Definition at line 29 of file mainwindow.cpp.

KTextEditor::MainWindow::~MainWindow ( )

virtual

Virtual Destructor.

Definition at line 35 of file mainwindow.cpp.

Member Function Documentation

KTextEditor::View * KTextEditor::MainWindow::activateView ( KTextEditor::Document * document )

Activate the view with the corresponding document.

If none exist for this document, create one

Parameters

document the document

Returns: activated view of this document, return nullptr if not possible

dispatch to parent

Definition at line 79 of file mainwindow.cpp.

KTextEditor::View * KTextEditor::MainWindow::activeView ( )

Access the active view.

Returns: active view, nullptr if not available

dispatch to parent

Definition at line 69 of file mainwindow.cpp.

void KTextEditor::MainWindow::addWidgetToViewBar	(	KTextEditor::View *	view,
		QWidget *	bar
	)

Add a widget to the view bar.

Parameters

view	view for which the view bar is used
bar	bar widget, shall have the viewBarParent() as parent widget

dispatch to parent

Definition at line 155 of file mainwindow.cpp.

bool KTextEditor::MainWindow::closeSplitView ( KTextEditor::View * view )

Close the split view that contains the given view.

Parameters

view the view.

Returns: true if the split view was closed.

dispatch to parent

Definition at line 117 of file mainwindow.cpp.

bool KTextEditor::MainWindow::closeView ( KTextEditor::View * view )

Close selected view.

Parameters

view the view

Returns: true if view was closed

dispatch to parent

Definition at line 99 of file mainwindow.cpp.

QWidget * KTextEditor::MainWindow::createToolView	(	KTextEditor::Plugin *	plugin,
		const QString &	identifier,
		KTextEditor::MainWindow::ToolViewPosition	pos,
		const QIcon &	icon,
		const QString &	text
	)

Create a new toolview with unique identifier at side pos with icon and caption text.

Use the returned widget to embedd your widgets.

Parameters

plugin	which owns this tool view
identifier	unique identifier for this toolview
pos	position for the toolview, if we are in session restore, this is only a preference
icon	icon to use in the sidebar for the toolview
text	translated text (i18n()) to use in addition to icon

Returns: created toolview on success, otherwise NULL

dispatch to parent

Definition at line 179 of file mainwindow.cpp.

QWidget * KTextEditor::MainWindow::createViewBar ( KTextEditor::View * view )

Try to create a view bar for the given view.

Parameters

view	view for which we want an view bar

Returns: suitable widget that can host view bars widgets or nullptr

dispatch to parent

Definition at line 137 of file mainwindow.cpp.

void KTextEditor::MainWindow::deleteViewBar ( KTextEditor::View * view )

Delete the view bar for the given view.

Parameters

view	view for which we want an view bar

dispatch to parent

Definition at line 147 of file mainwindow.cpp.

KXMLGUIFactory * KTextEditor::MainWindow::guiFactory ( )

Accessor to the XMLGUIFactory.

Returns: the mainwindow's KXMLGUIFactory, nullptr if not available

dispatch to parent

Definition at line 49 of file mainwindow.cpp.

bool KTextEditor::MainWindow::hideToolView ( QWidget * widget )

Hide the toolview widget.

Parameters

widget the toolview to hide, where the widget was constructed by createToolView().

Returns: true on success, otherwise false

dispatch to parent

Definition at line 217 of file mainwindow.cpp.

void KTextEditor::MainWindow::hideViewBar ( KTextEditor::View * view )

Hide the view bar for the given view.

Parameters

view	view for which the view bar is used

dispatch to parent

Definition at line 171 of file mainwindow.cpp.

bool KTextEditor::MainWindow::moveToolView	(	QWidget *	widget,
		KTextEditor::MainWindow::ToolViewPosition	pos
	)

Move the toolview widget to position pos.

Parameters

widget	the toolview to move, where the widget was constructed by createToolView().
pos	new position to move widget to

Returns: true on success, otherwise false

dispatch to parent

Definition at line 197 of file mainwindow.cpp.

KTextEditor::View * KTextEditor::MainWindow::openUrl	(	const QUrl &	url,
		const QString &	encoding = `QString()`
	)

Open the document url with the given encoding.

Parameters

url	the document's url
encoding	the preferred encoding. If encoding is QString() the encoding will be guessed or the default encoding will be used.

Returns: a pointer to the created view for the new document, if a document with this url is already existing, its view will be activated, return nullptr if not possible

dispatch to parent

Definition at line 89 of file mainwindow.cpp.

QObject * KTextEditor::MainWindow::pluginView ( const QString & name )

Get a plugin view for the plugin with with identifier name.

Parameters

name	the plugin's name

Returns: pointer to the plugin view if a plugin with name is loaded and has a view for this mainwindow, otherwise NULL

dispatch to parent

Definition at line 237 of file mainwindow.cpp.

void KTextEditor::MainWindow::pluginViewCreated	(	const QString &	name,
		QObject *	pluginView
	)

signal

This signal is emitted when the view of some Plugin is created for this main window.

Parameters

name	name of plugin
pluginView	the new plugin view

void KTextEditor::MainWindow::pluginViewDeleted	(	const QString &	name,
		QObject *	pluginView
	)

signal

This signal is emitted when the view of some Plugin got deleted.

Parameters

name	name of plugin
pluginView	the deleted plugin view

Warning !!! DO NOT ACCESS THE DATA REFERENCED BY THE POINTER, IT IS ALREADY INVALID Use the pointer only to remove mappings in hash or maps

bool KTextEditor::MainWindow::showPluginConfigPage	(	KTextEditor::Plugin *	plugin,
		int	page
	)

Shows the plugin's config page.

The page specifies which config page will be shown, see KTextEditor::Plugin::configPages().

Returns: true on success, otherwise false

Since: 5.63

dispatch to parent

Definition at line 227 of file mainwindow.cpp.

bool KTextEditor::MainWindow::showToolView ( QWidget * widget )

Show the toolview widget.

Parameters

widget the toolview to show, where the widget was constructed by createToolView().

Returns: true on success, otherwise false

Todo:: add focus parameter: bool showToolView (QWidget *widget, bool giveFocus );

dispatch to parent

Definition at line 207 of file mainwindow.cpp.

void KTextEditor::MainWindow::showViewBar ( KTextEditor::View * view )

Show the view bar for the given view.

Parameters

view	view for which the view bar is used

dispatch to parent

Definition at line 163 of file mainwindow.cpp.

void KTextEditor::MainWindow::splitView ( Qt::Orientation orientation )

Split current view space according to .

Parameters

orientation in which line split the view

dispatch to parent

Definition at line 109 of file mainwindow.cpp.

void KTextEditor::MainWindow::unhandledShortcutOverride ( QEvent * e )

signal

This signal is emitted for every unhandled ShortcutOverride in the window.

Parameters

e	responsible event

void KTextEditor::MainWindow::viewChanged ( KTextEditor::View * view )

signal

This signal is emitted whenever the active view changes.

Parameters

view	new active view

void KTextEditor::MainWindow::viewCreated ( KTextEditor::View * view )

signal

This signal is emitted whenever a new view is created.

Parameters

view	view that was created

QList< KTextEditor::View * > KTextEditor::MainWindow::views ( )

Get a list of all views for this main window.

Returns: all views, might be empty!

dispatch to parent

Definition at line 59 of file mainwindow.cpp.

bool KTextEditor::MainWindow::viewsInSameSplitView	(	KTextEditor::View *	view1,
		KTextEditor::View *	view2
	)

Returns: true if the given views

Parameters

view1	and
view2	share the same split view, false otherwise.

dispatch to parent

Definition at line 127 of file mainwindow.cpp.

QWidget * KTextEditor::MainWindow::window ( )

Get the toplevel widget.

Returns: the real main window widget, nullptr if not available

dispatch to parent

Definition at line 39 of file mainwindow.cpp.

The documentation for this class was generated from the following files:

KDE's Doxygen guidelines are available online.

Quick Links

Class Picker

About

Public Types

Signals

Public Member Functions

Additional Inherited Members

Detailed Description

Member Enumeration Documentation

Constructor & Destructor Documentation

Member Function Documentation