Source Code (Use browser search to find items of interest.)

kcontrol'TopLevel (./kdebase/kcontrol/kcontrol/toplevel.h:38)

class TopLevel : public KTMainWindow
{
  Q_OBJECT

public:
  TopLevel( const char* name=0 );
  ~TopLevel();

  void showModule(QString desktopFile);

protected:
  void setupActions(); 

protected slots:
  void activateModule(const QString& name);
  void moduleActivated(ConfigModule *module);
  void newModule(const QString &name, const QString &quickhelp);
  void activateIconView();
  void activateTreeView();

  void activateSmallIcons();
  void activateMediumIcons();
  void activateLargeIcons();

private:
  QTabWidget     *_tab;
  DockContainer  *_dock;
  QSplitter      *_splitter;

  KToggleAction *tree_view, *icon_view;
  KToggleAction *icon_small, *icon_medium, *icon_large;

  IndexWidget  *_indextab;
  SearchWidget *_searchtab;
  HelpWidget   *_helptab;

  ConfigModule     *_active;
  ConfigModuleList *_modules;
};

kcontrol'TopLevel::TopLevel() (./kdebase/kcontrol/kcontrol/toplevel.cpp:51)

TopLevel::TopLevel(const char* name)
  : KTMainWindow( name )
  , _active(0)
{
  setPlainCaption(i18n("KDE Control Center"));

  // read settings
  KConfig *config = KGlobal::config();
  config->setGroup("Index");
  QString viewmode = config->readEntry("ViewMode", "Icon");

  if (viewmode == "Tree")
    KCGlobal::setViewMode(Tree);
  else
    KCGlobal::setViewMode(Icon);

  QString size = config->readEntry("IconSize", "Medium");
  if (size == "Small")
    KCGlobal::setIconSize(Small);
  else if (size == "Large")
    KCGlobal::setIconSize(Large);
  else
    KCGlobal::setIconSize(Medium);
  
  // initialize the entries
  _modules = new ConfigModuleList();
  _modules->readDesktopEntries();

  // create the splitter
  _splitter = new QSplitter(this);

  // create the left hand side (the tab view)
  _tab = new QTabWidget(_splitter);

  // index tab
  _indextab = new IndexWidget(_modules, _tab);
  connect(_indextab, SIGNAL(moduleActivated(ConfigModule*)),
		  this, SLOT(moduleActivated(ConfigModule*)));
  _tab->addTab(_indextab, i18n("In&dex"));

  // search tab
  _searchtab = new SearchWidget(_tab);
  _searchtab->populateKeywordList(_modules);
  connect(_searchtab, SIGNAL(moduleSelected(const QString&)),
		  this, SLOT(activateModule(const QString&)));

  _tab->addTab(_searchtab, i18n("S&earch"));

  // help tab
  _helptab = new HelpWidget(_tab);
  _tab->addTab(_helptab, i18n("Hel&p"));
  
  // set a reasonable resize mode
  _splitter->setResizeMode(_tab, QSplitter::KeepSize);

  // set up the right hand side (the docking area)
  _dock = new DockContainer(_splitter);
  connect(_dock, SIGNAL(newModule(const QString&, const QString&)),
		  this, SLOT(newModule(const QString&, const QString&)));

  // insert the about widget
  AboutWidget *aw = new AboutWidget(this);
  _dock->setBaseWidget(aw);

  // set the main view
  setView(_splitter);

  // initialize the GUI actions
  setupActions();

  // activate defaults
  if (KCGlobal::viewMode() == Tree)   {
    activateTreeView();
    tree_view->setChecked(true);
  }
  else {
    activateIconView();
    icon_view->setChecked(true);
  }
}

kcontrol'TopLevel::~TopLevel() (./kdebase/kcontrol/kcontrol/toplevel.cpp:132)

TopLevel::~TopLevel()
{
  KConfig *config = KGlobal::config();
  config->setGroup("Index");
  if (KCGlobal::viewMode() == Tree)
    config->writeEntry("ViewMode", "Tree");
  else
    config->writeEntry("ViewMode", "Icon");

  switch (KCGlobal::iconSize())
    {
    case Small:
      config->writeEntry("IconSize", "Small");
      break;
    case Medium:
      config->writeEntry("IconSize", "Medium");
      break;
    case Large:
      config->writeEntry("IconSize", "Large");
      break;
    default:
      config->writeEntry("IconSize", "Medium");
      break;
    }

  config->sync();
}

kcontrol'TopLevel::setupActions() (./kdebase/kcontrol/kcontrol/toplevel.cpp:160)

void TopLevel::setupActions()
{
  KStdAction::quit(kapp, SLOT(quit()), actionCollection());

  icon_view = new KToggleAction
    (i18n("&Icon View"), 0, this, SLOT(activateIconView()),
     actionCollection(), "activate_iconview");
  icon_view->setExclusiveGroup( "viewmode" );

  tree_view = new KToggleAction
    (i18n("&Tree View"), 0, this, SLOT(activateTreeView()),
     actionCollection(), "activate_treeview");
  tree_view->setExclusiveGroup( "viewmode" );

  icon_small = new KToggleAction
    (i18n("&Small"), 0, this, SLOT(activateSmallIcons()),
     actionCollection(), "activate_smallicons");
  icon_small->setExclusiveGroup( "iconsize" );

  icon_medium = new KToggleAction
    (i18n("&Medium"), 0, this, SLOT(activateMediumIcons()),
     actionCollection(), "activate_mediumicons");
  icon_medium->setExclusiveGroup( "iconsize" );

  icon_large = new KToggleAction
    (i18n("&Large"), 0, this, SLOT(activateLargeIcons()),
     actionCollection(), "activate_largeicons");
  icon_large->setExclusiveGroup( "iconsize" );

  createGUI("kcontrolui.rc");

  // add menu with the modules
  ModuleMenu *menu = new ModuleMenu(_modules, this);
  menuBar()->insertItem(i18n("&Modules"), menu, -1, 2);
  connect(menu, SIGNAL(moduleActivated(ConfigModule*)),
	  this, SLOT(moduleActivated(ConfigModule*)));
}

kcontrol'TopLevel::activateIconView() (./kdebase/kcontrol/kcontrol/toplevel.cpp:198)

void TopLevel::activateIconView()
{
  KCGlobal::setViewMode(Icon);
  _indextab->activateView(Icon);

  icon_small->setEnabled(true);
  icon_medium->setEnabled(true);
  icon_large->setEnabled(true);

  switch(KCGlobal::iconSize())
    {
    case Small:
      icon_small->setChecked(true);
      break;
    case Large:
      icon_large->setChecked(true);
      break;
    default:
      icon_medium->setChecked(true);
      break;
    }
}

kcontrol'TopLevel::activateTreeView() (./kdebase/kcontrol/kcontrol/toplevel.cpp:221)

void TopLevel::activateTreeView()
{
  KCGlobal::setViewMode(Tree);
  _indextab->activateView(Tree);

  icon_small->setEnabled(false);
  icon_medium->setEnabled(false);
  icon_large->setEnabled(false);
}

kcontrol'TopLevel::activateSmallIcons() (./kdebase/kcontrol/kcontrol/toplevel.cpp:231)

void TopLevel::activateSmallIcons()
{
  KCGlobal::setIconSize(Small);
  _indextab->reload();
}

kcontrol'TopLevel::activateMediumIcons() (./kdebase/kcontrol/kcontrol/toplevel.cpp:237)

void TopLevel::activateMediumIcons()
{
  KCGlobal::setIconSize(Medium);
  _indextab->reload();
}

kcontrol'TopLevel::activateLargeIcons() (./kdebase/kcontrol/kcontrol/toplevel.cpp:243)

void TopLevel::activateLargeIcons()
{
  KCGlobal::setIconSize(Large);
  _indextab->reload();
}

kcontrol'TopLevel::newModule() (./kdebase/kcontrol/kcontrol/toplevel.cpp:249)

void TopLevel::newModule(const QString &name, const QString &quickhelp)
{
  QString cap = i18n("KDE Control Center");
  
  if (!name.isEmpty())
    cap += " - [" + name +"]";

  setPlainCaption(cap);

  _helptab->setText(quickhelp);
}

kcontrol'TopLevel::moduleActivated() (./kdebase/kcontrol/kcontrol/toplevel.cpp:261)

void TopLevel::moduleActivated(ConfigModule *module)
{
  activateModule(module->name());
}

kcontrol'TopLevel::showModule() (./kdebase/kcontrol/kcontrol/toplevel.cpp:266)

void TopLevel::showModule(QString desktopFile)
{
  // strip trailing ".desktop"
  int pos = desktopFile.find(".desktop");
  if (pos > 0)
    desktopFile = desktopFile.left(pos);

  // locate the desktop file
  QStringList files;
  files = KGlobal::dirs()->findAllResources("apps", "Settings/"+desktopFile+".desktop", TRUE);
  
  // show all matches
  QStringList::Iterator it;
  for (it = files.begin(); it != files.end(); ++it)
    {
      for (ConfigModule *mod = _modules->first(); mod != 0; mod = _modules->next())
		if (mod->fileName() == *it && mod != _active)
		  {
			// tell the index to display the module
			_indextab->makeVisible(mod);
			
			// tell the index to mark this module as loaded
			_indextab->makeSelected(mod);

			// dock it
            _dock->dockModule(mod);
            break;
	  }
    }
}

kcontrol'TopLevel::activateModule() (./kdebase/kcontrol/kcontrol/toplevel.cpp:297)

void TopLevel::activateModule(const QString& name)
{
  kdDebug() << "activate: " << name << endl;
  for (ConfigModule *mod = _modules->first(); mod != 0; mod = _modules->next())
	{
	  if (mod->name() == name)
		{
		  // tell the index to display the module
		  _indextab->makeVisible(mod);

		  // tell the index to mark this module as loaded
		  _indextab->makeSelected(mod);
		  
		  // dock it
          _dock->dockModule(mod);
		  break;
		}
	}
}