kde4下KParts入门

sonald

kde4刚刚方布，KParts的基本原理没有变化，但是接口已经大大简化，尤其是Part工厂的编写工作少了很多，kde的techbase上也没有更新这部分的文档，甚至在kde4的实现代码中也没有完全迁移到新的接口（例如有些标记为KDE_DEPRECATED的接口还被使用）。废话不说了，下面进入正题。最基本的原理我就不说了，重点关注一下kde4中的变化，下文中我就以一个例子做说明。
一个有Part的kde程序大概会有几部分组成：一个Shell，作为所有Part的容器，一组Part（可由KParts::PartManager管理），和许多的KPart::Plugin。Part和Plugin都是KXMLGUIClient的间接子类，这就意味着这些部件的GUI是可以动态融合的（主要是菜单项和工具栏），Shell程序没有这个要求。
一个Part应该包含一个继承自KParts::Part接口（或其子类）的类定义和定义其GUI部分的XML文件。先来看notepad_part.h:
class NotepadPart: public KParts::ReadWritePart
{
    Q_OBJECT
        public:
    NotepadPart(QWidget* parentWidget, QObject *parent, const QStringList& args);
    ~NotepadPart();
    void setReadWrite(bool rw);
    static KAboutData *createAboutData();
   
protected:
    bool saveFile();
    bool openFile();
    protected slots:
    void slotSelectAll();
protected:
    QTextEdit *m_edit;
    KComponentData *m_instance;
};
我从KParts::ReadWritePart继承， 然后实现了saveFile和openFile两个纯虚函数。
NotepadPart(QWidget* parentWidget, QObject *parent, const QStringList& args)
为了使用新的Part构建方法，构造函数必须定义成上面的形式。
static KAboutData *createAboutData()
这个方法是Part工厂要求实现的，后面将会看到。
另一个区别是kde4中将原来的KInstance类改名为KComponentData，以使其功能更明确。
现在看实现部分 notepad_part.cpp
typedef KParts::GenericFactory NotepadPartFactory;
K_EXPORT_COMPONENT_FACTORY( libnotepad_part, NotepadPartFactory )
这两行用来定义一个NotepadPart的工厂类，并且生成合适的构造函数和初始化函数。这样工厂类就可以在合适的时候知道如何生成NotepadPart对象。上面notepad_part.h中定义的构造函数声明和createAboutData将被工厂调用。这比以前的方式要简洁很多，你也可以不使用上面的方法定义工厂类，而使用kde3的方式。
NotepadPart::NotepadPart(QWidget* parentWidget, QObject *parent, const QStringList& args)
    : KParts::ReadWritePart(parent)
{
    setComponentData( NotepadPartFactory::componentData() );
    QString rcfile = KStandardDirs::locate( "data", "notepad_part/notepad_part.rc" );
    if ( !rcfile.isEmpty() )
        setXMLFile( rcfile );
   
    m_edit = new QTextEdit( parentWidget );
    m_edit->setFocus();
    setWidget( m_edit );
    KAction *actSel = new KAction(QString("Select All"), this );
    actionCollection()->addAction("selectAll", actSel);
    connect( actSel, SIGNAL(triggered()), this, SLOT(slotSelectAll()) );
   
    setReadWrite( true );   
}
在NotepadPart的构造函数中，应该使用setComponentData初始化Part的ComponentData对象，工厂类负责对象的ComponentData、KAboutData等的处理，我们可以重新实现其createComponentData接口来提供新的信息。createAboutData的实现如下：
KAboutData* NotepadPart::createAboutData()
{
    KAboutData* aboutData = new KAboutData("notepad_part", 0, ki18n("NotepadPart"), "0.1");
    aboutData->addAuthor( ki18n("sycao"), KLocalizedString(), "yinshuiboy@gmail.com" );
    return aboutData;
}
一个part需要一个rc文件来定义其GUI，notepad_part.rc如下：
  
   
      Edit
      
     
  
下面再定义一个NotepadPart的插件，插件从KParts::Plugin继承，定义如下：
class SpellCheck: public KParts::Plugin
{
    Q_OBJECT
        public:
    SpellCheck(QObject *parent = 0,
               const QStringList& args = QStringList());
    ~SpellCheck();
    public slots:
    void slotSpellCheck();
};
这里值得注意的是，构造函数的声明方式由其工厂类的需要决定的。插件的工厂可以KGenericFactory模板定义如下：
typedef KGenericFactory SpellCheckFactory;
K_EXPORT_COMPONENT_FACTORY( libspellcheck, SpellCheckFactory("spellcheck") )
插件的构造函数如下：
SpellCheck::SpellCheck(QObject *parent, const QStringList& args)
    : KParts::Plugin( parent )
{
    //    setComponentData( SpellCheckFactory::componentData() );
    KAction *actSC = new KAction( "spell check", this );
    connect( actSC, SIGNAL(triggered()),
             this, SLOT(slotSpellCheck()) );
    actionCollection()->addAction("spell_check", actSC );
}
通常情况下，我们把插件放在相关part的子目录kpartplugins目录下，那么该part被载入时，会自动寻找和融合plugin的界面。这里不需要在构造函数里调用setXMLFile，但是同样要提供一个rc文件和一个desktop服务描述文件。desktop文件如下：
[Desktop Entry]
Encoding=UTF-8
Icon=mypluginicon
Type=Service
ServiceTypes=KPluginInfo
Name=spellCheck
Comment=Description of what the plugin does
X-KDE-PluginInfo-EnabledByDefault=true
X-KDE-PluginInfo-Author=sycao
X-KDE-PluginInfo-Email=sycao@gmail.com
X-KDE-PluginInfo-Name=internalname
X-KDE-PluginInfo-Version=1.0
X-KDE-PluginInfo-Website=http://www.plugin.org/
X-KDE-PluginInfo-Category=demo
X-KDE-PluginInfo-License=GPL
这里定义了该插件的类型、库等信息。
接下来是Shell部分，我定义了一个MainShell类，从这里载入多个part，并且由KParts::PartManager来帮助管理多个part。其构造函数如下：
MainShell::MainShell()
    : KParts::MainWindow( )
{
    setXMLFile( "tutor1/main_shell.rc" );
    KAction *actFileOpen = new KAction( QString("file open"), this );
    actionCollection()->addAction( "file_open", actFileOpen );
    connect( actFileOpen, SIGNAL(triggered()),
             this, SLOT(slotFileOpen()) );
    KAction *actFileQuit = new KAction( QString("file &quit"), this );
    connect( actFileQuit, SIGNAL(triggered()),
             this, SLOT(slotFileQuit()) );
    actionCollection()->addAction( "file_quit", actFileQuit );
   
    KAction *actSwitch = new KAction( QString("switch part"), this );
    connect( actSwitch, SIGNAL(triggered()),
             this, SLOT(slotSwitch()) );
    actionCollection()->addAction( "part_switch", actSwitch );
    m_sa = new QScrollArea( this );
    KPluginFactory *factory = KLibLoader::self()->factory("libnotepad_part");   
    if ( factory ) {
        m_part_editor =
            factory->create(this, this);
        if ( !m_part_editor )
            kapp->quit();
        m_part_editor->widget()->hide();
    } else
        kDebug() lastErrorMessage();
    factory = KPluginLoader("libkonsolepart").factory();
    if ( factory ) {
        m_part_terminal =
            factory->create(this);
        if ( !m_part_terminal )
            kapp->quit();
        TerminalInterface *ti =
            qobject_cast( m_part_terminal );
        ti->startProgram( "bash", QStringList() );
        ti->sendInput( "ls\n" );
        m_part_terminal->widget()->hide();
    } else
        kDebug() addPart( m_part_editor, true );
    m_pm->addPart( m_part_terminal, false );
}
在kde4中，你可以用KLibLoader、KPluginLoader来载入Part和插件。KPluginLoader是推荐的方法。当你编译的时候，你会发现系统有warning，提示你参数中不要出现前缀lib。比如
KPluginFactory *factory = KLibLoader::self()->factory("libnotepad_part");
会被要求写成
KPluginFactory *factory = KLibLoader::self()->factory("notepad_part");
但是如果你不加lib前缀，你会发现系统没法找到你所需要的组件，除非使用全路径格式。可能是由于目前的kde4代码没有完全迁移到新的接口的原因。
其他代码就不具体说明了，有兴趣的可以试试，大家可以研究一下。
你要编译代码，必须有可用的QT4和kde4环境，以及cmake。


       
        文件:kparts.demo.tar
        大小:50KB
        下载:
下载
       


本文来自ChinaUnix博客，如果查看原文请点：http://blog.chinaunix.net/u1/58649/showart_465085.html