tdeaddons/konq-plugins/sidebar/delicious/mainWidget.h

//////////////////////////////////////////////////////////////////////////
// mainWidget.h                                                         //
//                                                                      //
// Copyright (C)  2005  Lukas Tinkl <lukas@kde.org>                     //
//                                                                      //
// This program is free software; you can redistribute it and/or        //
// modify it under the terms of the GNU General Public License          //
// as published by the Free Software Foundation; either version 2       //
// of the License, or (at your option) any later version.               //
//                                                                      //
// This program 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 General Public License for more details.                         //
//                                                                      //
// You should have received a copy of the GNU General Public License    //
// along with this program; if not, write to the Free Software          //
// Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA            //
// 02110-1301, USA.                                                     //
//////////////////////////////////////////////////////////////////////////

#ifndef _MAINWIDGET_H_
#define _MAINWIDGET_H_

#include "widget.h"

#include <tdeio/jobclasses.h>
#include <tdeparts/browserextension.h>

class TQStringList;
class KURL;
class TDEConfig;

/**
 * Main widget of the del.icio.us bookmarks panel
 */
class MainWidget: public MainWidget_base
{
    Q_OBJECT
  
public:
    MainWidget( TDEConfig * config, TQWidget * parent );
    ~MainWidget();

    /**
     * @return all the tags user has
     * (used in the DCOP iface)
     */
    TQStringList tags() const;

    /**
     * @return all the (currently visible) bookmark (URLs)
     * (used in the DCOP iface)
     */
    TQStringList bookmarks() const;

    /**
     * Set the internal URL to @p url
     */
    void setCurrentURL( const KURL & url );

public slots:
    /**
     * Show a dialog for adding a new bookmark
     */
    void slotNewBookmark();

private slots:
    /**
     * Start the job to get the list of tags
     */
    void slotGetTags();

    /**
     * Fill the Tags listview with job->data()
     * (parses the XML returned by the server)
     */
    void slotFillTags( TDEIO::Job * job );

    /**
     * Start the job to get the list of bookmarks
     * for checked tags
     */
    void slotGetBookmarks();

    /**
     * Fill the Bookmarks listview with job->data()
     * (parses the XML returned by the server)
     */
    void slotFillBookmarks( TDEIO::Job * job );

    /**
     * Handle clicking on a bookmark (KDE mode)
     */
    void slotBookmarkExecuted( TQListViewItem * item );

    /**
     * Handle middle clicking a bookmark
     */
    void slotBookmarkClicked( int button, TQListViewItem * item, const TQPoint & pnt, int col );

    /**
     * Popup a tag context menu over @p item and position @pos
     */
    void slotTagsContextMenu( TQListViewItem * item, const TQPoint & pos, int col );

    /**
     * Popup a bookmark context menu over @p item and position @pos
     */
    void slotBookmarksContextMenu( TQListViewItem * item, const TQPoint & pos, int col );

    /**
     * Put a checkmark before all tags
     */
    void slotCheckAllTags();

    /**
     * Cancel the checkmark before all tags
     */
    void slotUncheckAllTags();

    /**
     * Toggle the checkmark before all tags
     */
    void slotToggleTags();

    /**
     * Starts a singleshot timer once an item (tag) has been toggled. Timer will update bookmarks.
     */
    void itemToggled();

    /**
     * Display a dialog box that allows renaming of tags
     */
    void slotRenameTag();

    /**
     * Delete the selected bookmark
     */
    void slotDeleteBookmark();

signals:
    /**
     * Emit a signal to the plugin interface that a @p url has been left-clicked
     */
    void signalURLClicked( const KURL & url, const KParts::URLArgs & args = KParts::URLArgs() );

    /**
     * Emit a signal to the plugin interface that a @p url has been mid-clicked
     */
    void signalURLMidClicked( const KURL & url, const KParts::URLArgs & args = KParts::URLArgs() );

private:
    /**
     * @return list of checked tags
     */
    TQStringList checkedTags() const;

    /**
     * Save the tag list to the config file
     */
    void saveTags();

    /**
     * Load the tag list from the config file
     */
    void loadTags();

    TQTimer *m_updateTimer;
    KURL m_currentURL;
    TQStringList m_tags;
    TDEConfig * m_config;
};

#endif