class KUrlNavigator


Table of contents
Modules
kio Classes
All Classes
Module kio
Namespace global
Class KUrlNavigator
Inherits QWidget

************************************************************************** Copyright (C) 2006 by Peter Penz * Copyright (C) 2006 by Aaron J. Seigo * Copyright (C) 2007 by Kevin Ottens * Copyright (C) 2007 by Urs Wolfer * * This library is free software; you can redistribute it and/or * modify it under the terms of the GNU Library General Public * License version 2 as published by the Free Software Foundation. * * 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. * *************************************************************************** Allows to navigate through the paths of an URL.

The URL navigator offers two modes: - Editable: Represents the 'classic' mode, where the URL is editable inside a line editor. By pressing RETURN the URL will get activated. - Non editable ("breadcrumb view"): The URL is represented by a number of buttons, where each button represents a path of the URL. By clicking on a button the path will get activated. This mode also supports drag and drop of items.

The mode can be changed by clicking on the empty area of the URL navigator. It is recommended that the application remembers the setting of the mode or allows the user to configure the default mode (see KUrlNavigator.setUrlEditable()).

The URL navigator remembers the URL history during navigation and allows to go back and forward within this history.

The typical usage of the KUrlNavigator is: - Create an instance providing a places model and an URL. - Create an instance of QAbstractItemView which shows the content of the URL given by the URL navigator. - Connect to the signal KUrlNavigator.urlChanged() and synchronize the content of QAbstractItemView with the URL given by the URL navigator.



methods