kio Library API Documentation

kservicegroup.h

00001 /* This file is part of the KDE project 00002 Copyright (C) 2000 Waldo Bastian <bastian@kde.org> 00003 00004 This library is free software; you can redistribute it and/or 00005 modify it under the terms of the GNU Library General Public 00006 License version 2 as published by the Free Software Foundation. 00007 00008 This library is distributed in the hope that it will be useful, 00009 but WITHOUT ANY WARRANTY; without even the implied warranty of 00010 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU 00011 Library General Public License for more details. 00012 00013 You should have received a copy of the GNU Library General Public License 00014 along with this library; see the file COPYING.LIB. If not, write to 00015 the Free Software Foundation, Inc., 59 Temple Place - Suite 330, 00016 Boston, MA 02111-1307, USA. 00017 */ 00018 00019 #ifndef __kservicegroup_h__ 00020 #define __kservicegroup_h__ 00021 00022 #include <qptrlist.h> 00023 #include <qstring.h> 00024 #include <qshared.h> 00025 #include <qdatastream.h> 00026 #include <qvariant.h> 00027 00028 #include <kdesktopfile.h> 00029 00030 #include "ksycocaentry.h" 00031 #include "ksycocatype.h" 00032 #include "kservice.h" 00033 00034 class KBuildServiceGroupFactory; 00035 00067 class KServiceGroup : public KSycocaEntry 00068 { 00069 friend class KBuildServiceGroupFactory; 00070 K_SYCOCATYPE( KST_KServiceGroup, KSycocaEntry ) 00071 00072 public: 00073 typedef KSharedPtr<KServiceGroup> Ptr; 00074 typedef KSharedPtr<KSycocaEntry> SPtr; 00075 typedef QValueList<SPtr> List; 00076 public: 00082 KServiceGroup( const QString & name ); 00083 00089 KServiceGroup( const QString & _fullpath, const QString & _relpath ); 00090 00095 KServiceGroup( QDataStream& _str, int offset, bool deep ); 00096 00097 virtual ~KServiceGroup(); 00098 00103 bool isValid() const { return true; } 00104 00109 virtual QString name() const { return entryPath(); } 00110 00115 virtual QString relPath() const { return entryPath(); } 00116 00121 QString caption() const { return m_strCaption; } 00122 00128 QString icon() const { return m_strIcon; } 00129 00135 QString comment() const { return m_strComment; } 00136 00142 int childCount(); 00143 00150 bool noDisplay() const; 00151 00159 QStringList suppressGenericNames() const; 00160 00165 void setLayoutInfo(const QStringList &layout); 00166 00171 virtual void load( QDataStream& ); 00176 virtual void save( QDataStream& ); 00177 00188 List entries(bool sorted, bool excludeNoDisplay, bool allowSeparators, bool sortByGenericName=false); 00189 virtual List entries(bool sorted, bool excludeNoDisplay); 00190 00197 virtual List entries(bool sorted = false); 00198 00209 QString baseGroupName() const { return m_strBaseGroupName; } 00210 00216 QString directoryEntryPath() const; 00217 00223 static Ptr baseGroup( const QString &baseGroupName ); 00224 00229 static Ptr root(); 00230 00236 static Ptr group(const QString &relPath); 00237 00245 static Ptr childGroup(const QString &parent); 00246 00247 protected: 00252 void addEntry( KSycocaEntry *entry); 00253 00254 QString m_strCaption; 00255 QString m_strIcon; 00256 QString m_strComment; 00257 00258 List m_serviceList; 00259 bool m_bDeep; 00260 QString m_strBaseGroupName; 00261 int m_childCount; 00262 protected: 00263 virtual void virtual_hook( int id, void* data ); 00264 private: 00265 class Private; 00266 Private* d; 00267 }; 00268 00269 class KServiceSeparator : public KSycocaEntry 00270 { 00271 K_SYCOCATYPE( KST_KServiceSeparator, KSycocaEntry ) 00272 00273 public: 00274 typedef KSharedPtr<KServiceSeparator> Ptr; 00275 public: 00280 KServiceSeparator(); 00281 00282 bool isValid() const { return true; } 00283 00284 // Dummy 00285 virtual QString name() const { return "separator"; } 00286 // Dummy 00287 virtual void load( QDataStream& ) { }; 00288 // Dummy 00289 virtual void save( QDataStream& ) { }; 00290 }; 00291 00292 #endif
KDE Logo
This file is part of the documentation for kio Library Version 3.2.3.
Documentation copyright © 1996-2004 the KDE developers.
Generated on Fri Oct 8 11:14:59 2004 by doxygen 1.3.7 written by Dimitri van Heesch, © 1997-2003