# Das KPanel-Handbuch

Das KDE Team
Version 0.19.1-1, 6. Juni 1998, deutsche Übersetzung vom 18. März 1999

Diese Dokumentation wurde zuletzt für kpanel Version 0.19.1. überarbeitet. Bitte richten Sie Bemerkungen und Ergänzungen an den Autor.

Handbuch zum KDE-Panel (KPanel), der folgende Funktionen besitzt: KDE-Anwendungsstarter, Taskleiste und Knpfe fr die virtuellen Desktops.

KDE
Panel
Tasks
Programmstarter
Programmleiste

## Einleitung

kpanel unterstützt Sie beim Starten und Verwalten Ihrer Anwendungen und der virtuellen Desktops unter KDE. kpanel ermöglicht Ihnen den schnellen Zugriff u.a. auf:

- den KDE Anwendungsstarter

- eine Taskleiste mit den laufenden Anwendungen

- Buttons, mit denen Sie häufig benutze Anwendungen starten können

- die virtuellen Desktops

kpanel ist äußerst flexibel und weitgehend konfigurierbar und unterstützt sowohl systemweite als auch benutzerspezifische Einstellungen. Dieses Dokument beschreibt die Konfiguration und den Gebrauch von kpanel.

### Leistungsmerkmale

Zu den besonderen Funktionen, die kpanel bietet, gehören:

- Panel und Taskleiste sind unabhängig voneinander positionierbar.

- Panel und Taskleiste lassen sich automatisch verbergen.

- Konfigurierbare Tooltips.

- Kleine Anzeige-/Statusanwendungen lassen sich direkt im Panel ausführen.

- Für einen Button auf dem Panel können mehrere Icons definiert und mit kpanel-Kommandos untereinander ausgetauscht werden.

## Die Bildschirmkomponenten

kpanel zeigt zwei Fenster an: Taskleiste und Panel.

- Die Taskleiste zeigt die gegenwärtig laufenden Anwendungen an.

- Das Panel enthält den Anwendungsstarter, einen Button, um eine Fensterliste anzuzeigen, die Buttons der virtuellen Desktops und Buttons für häufig gestartete Anwendungen.

Panel und Taskleiste sind unabhängig voneinander positionierbar.

### Taskleiste

Die Taskleiste zeigt eine Liste der laufenden Anwendungen. Die Titel der Fenster, die minimiert sind, stehen in Klammern. Ein Klick auf einen Listeneintrag bringt Sie sofort zu der ausgewählten Anwendung, falls erforderlich wird der virtuelle Desktop gewechselt.

Außerdem können Sie mit der rechten Maustaste auf einen Eintrag in der Taskleiste klicken und wählen, ob Sie eine Anwendung maximieren, minimieren, schließen oder auf den aktuellen Arbeitsplatz verschieben wollen.

### Panel

In der Voreinstellung erscheint das Panel am unteren Bildschirmrand. Es enthält den Anwendungsstarter, eine Uhr und Buttons für häufig gestartete Anwendungen und die virtuellen Desktops. Falls Ihnen das Panel auf Ihrem aktuellen Desktop einmal im Wege sein sollte, klicken Sie auf die gepunktete Leiste ganz links (auf Ihren anderen virtuellen Desktops bleibt das Panel weiterhin sichtbar). Ferner können Sie das Panel so konfigurieren, daß es sich von selbst verbirgt. Es bleibt solange verborgen, bis Sie mit dem Mauszeiger den Bildschirmrand berühren, an den das Panel angehängt ist.

Die Icons, die auf dem Standardpanel erscheinen, und ihre Funktionen:

Anwendungsstarter

  Ein Klick auf das große K auf dem Panel öffnet ein Menü mit Anwendungen und Utilities. Es bietet Ihnen Zugriff auch auf das Hilfesystem und das KDE-Kontrollzentrum. Sie können Ihre eigenen Einträge hinzufügen.

  Tastenkombination: `Alt-F1` öffnet den Anwendungsstarter.

Fensterliste

  Ein Klick auf den Button, auf dem eine Gruppe von Fenstern abgebildet ist, öffnet ein Menü, das die gegenwärtig offenen Anwendungen desktopweise anzeigt. Fenstertitel in Klammern verweisen auf minimierte Fenster. Wählen Sie eine Anwendung aus, um auf sie zuzugreifen.

  Tastenkombination: Klicken Sie mit der mittleren Maustaste auf eine leere Stelle des Desktops, um die Fensterliste anzuzeigen.

Heimatverzeichnis

  Der Button mit der Abbildung eines Hauses ermöglicht Ihnen den schnellen Zugriff auf die Dateien in Ihrem Heimatverzeichnis.

Virtuelle Desktops

  Die mit "Eins", "Zwei" usw. beschrifteten Buttons in der Mitte des Panels ermöglichen Ihnen den Zugriff auf die virtuellen Desktops. Die Anzahl der virtuellen Desktops und ihre Bezeichnungen können geändert werden.

Hilfe-Browser

  Der Button mit der Abbildung eines Buches ermöglicht Ihnen den Zugriff auf das KDE-Online-Hilfesystem.

Zusätzlich zu den Standard-Icons können Sie Ihre eigenen Buttons hinzufügen, um häufig genutzte Anwendungen zu starten. Außerdem können Programme so eingerichtet werden, daß sie direkt im Panel laufen. So können Sie z.B. einen Button definieren, der Ihnen ein Programm anzeigt, das die eingehende Post beobachtet, und mit dem Sie ein EMail-Programm mit einem Klick starten können.

## Das Panel einrichten

kpanel ist ein äußerst flexibler und umfassend konfigurierbarer Bestandteil der KDE-Benutzerschnitstelle. Dieses Kapitel enthält Anleitungen, die Ihnen dabei helfen, kpanel nach Ihrem Geschmack einzurichten. Informationen über kpanelrc, die kpanel-Konfigurationsdatei, finden Sie in Kapitel Hinweise für Entwickler.

Die Erläuterungen zur Konfiguration finden Sie unter:

- Position und Verhalten des Panels

- Panel-Buttons

- Virtuelle Desktops

- Anwendungstarter

### Position und Verhalten des Panels

Um die Position und das Verhalten von Panel und Taskleiste einzustellen, klicken Sie mit der rechten Maustaste auf eine leere Stelle des Panels, wählen Sie dann den Menüeintrag "Konfigurieren". Klicken Sie auf den Hilfe-Button, um nähere Informationen über die Einstellungen zu erhalten.

### Panel-Buttons

Sie können einen Panel-Button bewegen, löschen oder seine Eigenschaften ändern, indem Sie mit der rechten Maustaste auf den Button klicken und dann die gewünschte Option aus dem erscheinenden Kontextmenü auswählen.

Um einen Button dem Panel hinzuzufügen, wählen Sie eine der drei folgenden Methoden:

- Um einen Fensterlisten-Button auf dem Panel zu plazieren, wählen Sie Anwendungsstarter > Panel > Fensterliste hinzufügen.

- Um eine Anwendung aus dem Anwendungsstarter auf dem Panel zu plazieren, wählen Sie Anwendungsstarter > Panel > Programm hinzufügen, gehen Sie durch das Menü, und wählen Sie die gewünschte Anwendung aus. Auf die gleiche Weise können Sie ein Untermenü aus dem Anwendungsstarter direkt auf das Panel plazieren. Wenn Sie auf das gewünschte Untermenü gestoßen sind, wählen Sie den ersten Eintrag des Untermenüs (das Untermenü selbst) aus. Um z.B. das Einstellungen-Untermenü auf das Panel zu plazieren, wählen Sie Anwendungsstarter > Programm hinzufügen > System > System.

- Ziehen Sie ein Icon aus einem kfm-Fenster oder vom Desktop auf das Panel. Nur .kdelnk-Dateien und Ordner, die .kdelnk-Dateien enthalten, können auf das Panel gezogen werden. Haben Sie ein Icon auf dem Panel plaziert, klicken Sie mit der rechten Maustaste und wählen Sie "Eigenschaften", um es einzurichten. Hinweis: Wenn Sie ein Icon in dieser Weise auf das Panel plazieren, achten Sie darauf, nicht die originale .kdelnk-Datei oder den originalen Ordner zu verschieben oder zu löschen, sonst kann das Panel das Icon nicht anzeigen.

Tooltips: kpanel zeigt Tooltips (einzeilige Hilfetexte) für Buttons auf dem Panel und Einträge im Anwendungsstarter an. Um einen Tooltip für einen Button einzurichten, klicken Sie mit der rechten Maustaste auf den Button, und wählen Sie "Eigenschaften" im Kontextmenü. Wählen Sie die Dialogseite "Anwendungen", und geben Sie den Text für den Tooltip im Feld "Beschreibung" ein. Damit die Änderungen wirksam werden, müssen Sie kpanel neu starten (klicken Sie mit der rechten Maustaste auf das Panel, und wählen Sie "Neu starten").

Anwendungen einbetten: Auf der Dialogseite "Ausführen" der Eigenschaften eines Programm-Icons können Sie unter "In Panel einbetten" einen Button im Panel so einrichten, daß er Ihnen eine laufende Anwendung anstelle eines statischen Icons anzeigt. Das ist insbesondere sinnvoll bei kleinen Anzeige- oder Statusanwendungen wie z.B. xbiff. Um eine Anwendung einzubetten, gehen Sie folgendermaßen vor:

- Geben Sie unter "In Panel einbetten - Ausführen" den Namen der Anwendung an, die im Panel ausgeführt werden soll.

- Geben Sie unter "Fenstertitel" den Titel des Fensters an, das von der Anwendung geöffnet wird, wenn sie ganz normal vom Desktop aus gestartet wird. kpanel benötigt den Fenstertitel, um zu erkennen, welches Fenster in das Panel gezogen werden soll. Sollte das Fenster keinen Titel haben, starten Sie die Anwendung vom Desktop aus, und sehen Sie auf der Taskleiste nach. Übernehmen Sie den dort angezeigten Titel.

### Virtuelle Desktops

Um die Bezeichnungen der Desktop-Buttons auf dem Panel oder die Anzahl der virtuellen Desktops zu ändern, klicken Sie mit der rechten Maustaste auf eine leere Stelle des Panels, und wählen Sie "Konfigurieren". Nehmen Sie die gewünschten Änderungen auf der Dialogseite "Desktops" vor (unter "Hilfe" finden Sie weitere Informationen zu den Einstellungen).

### Anwendungsstarter

Um den Benutzerabschnitt des Anwendungsstarters zu konfigurieren, wählen Sie Anwendungsstarter > Panel > Menüeditor. Folgen Sie den Anleitungen des kmenuedit-Utilities, um die gewünschten Einstellungen vorzunehmen.

Um Ihre Benutzereinträge an primärer Position im Menü zu plazieren, klicken Sie mit der rechten Maustaste auf eine leere Stelle des Panels, und wählen Sie "Konfigurieren" aus. Schlagen Sie die Dialogseite "Einstellungen" auf, und wählen Sie "Persönliches Menu zuerst".

## Hinweise für Entwickler

Dieses Kapitel enthält Wissenswertes für erfahrene Benutzer und Programmierer. Es befaßt sich mit folgenden Themen:

- kpanel-Kommandos

- kpanelrc, die Konfigurationsdatei

### kpanel-Kommandos

Sie können kpanel über den K-Fenstermanager Kommandos schicken, und zwar mit einer der beiden folgenden Techniken:

`KWM::sendKWMCommand(QString)` (aus KDE-Programmen) oder `kwmcom command` (von der Kommandozeile aus)

kpanel reagiert auf die folgenden Kommandos:

- kpanel:restart - Startet das Panel erneut, indem die Konfigurationsdateien erneut geladen werden.

- kpanel:hide - Verbirgt das Panel auf dem aktuellen Desktop, so als hätte der Benutzer auf die gepunktete schmale Leiste am Ende des Panels geklickt.

- kpanel:show - Zeigt das Panel wieder an, wenn es verborgen war.

- kpanel:system - Öffnet den Anwendungsstarter.

- kpanel:goXXXXYYYY - Öffnet den Anwendungsstarter an der angegebenen Position auf dem Desktop, z.B. öffnet kpanel:go05000100 das Menü an den Koordinaten 500,100.

- kpanel:icon:&num;:button - Wechselt das Icon, das für Button auf dem Panel angezeigt wird. &num; steht für eine Zahl von 1 bis 4 und bezieht sich auf ein Icon, das für den Button in der .kdelnk-Datei des Buttons definiert ist (Zeilen der Art: icon=pixmap, icon2=pixmap, usw.).

### kpanelrc

kpanel kann über das KDE-Kontrollzentrum (Anwendungsstarter > KDE-Kontrollzentrum) konfiguriert werden. Wählen Sie im Modul "Anwendungen" den Abschnitt "Panel" aus, um die verschiedenen Einstellungen vorzunehmen.

Für alle, die es vorziehen, eine Konfigurationsdatei zu bearbeiten, erklärt dieser Abschnitt die Optionen in der Datei kpanelrc, die Sie unter ˜/.kde/share/config finden.

Die kpanelrc-Konfigurationsdatei ist in zwei Anschnitte gegliedert:

- kpanel

- kpanel-Buttons

#### &lsqb;kpanel&rsqb;

Der kpanel-Abschnitt enthält eine Reihe von Einträgen, die das Verhalten von kpanel steuern.

- AutoHide=`on&verbar;off` Bei `on` verbirgt sich das Panel automatisch, wenn der Benutzer den Mauszeiger aus dem Panel bewegt.

- AutoHideTaskbar=`on&verbar;off` Bei `on` verbirgt sich die Taskleiste automatisch, wenn der Benutzer den Mauszeiger aus der Taskleiste bewegt.

- BackgroundTexture=pixmap Zeigt pixmap als Hintergrund des Panels.

- BoxHeight=value (in Pixel) BoxWidth=value (in Pixel) Diese Einstellungen bestimmen die Höhe des Panels bzw. die Breite von Buttons auf dem Panel.

- ClockAmPm=`on&verbar;off` Bei `on` zeigt die Uhr auf dem Panel eine AM/PM-Anzeige an. Bei `off` erscheint die Zeitanzeige im 24-Stundenformat.

- DateFont=font Bestimmt den Font für die Uhr auf dem Panel. Gebrauchen Sie eine X-Fontspezifikation wie *-times-medium-i-normal-12-*.

- DateVisible=`true&verbar;false` Bei `false` wird die Paneluhr nicht angezeigt.

- DesktopButtonFont=font Bestimmt den Font für die Desktop-Buttons auf dem Panel.

- DesktopButtonHorizontalSize=value Bestimmt die Breite der Desktop-Buttons auf dem Panel. Der eingesetzte Wert wird mit der Hälfte von BoxWidth multipliziert.

- DesktopButtonRows=value Bestimmt die Anzahl der Reihen der Desktop-Buttons auf dem Panel.

- FoldersFirst=`on&verbar;off` Bei `on` erscheinen Untermenüs im Anwendungsstarter immer an erster Stelle. Bei `off` erscheinen alle Einträge in alphabetischer Reihenfolge.

- Margin=value (in Pixel) Dieser Wert bestimmt die Größe des unteren und oberen Randes des Panels.

- MenuToolTips=value (in Millisekunden) Bestimmt die Zeitdauer, die ein Benutzer die Maus über einem Eintrag im Anwendungsstarter halten muß, ehe ein Tooltip erscheint.

- PanelHidden=00000000 Diese Einstellung legt fest, auf welchem Desktop das Panel verborgen ist. Die 8 Stellen im Einstellungswert korrespondieren den 8 Desktops. Eine 0 an einer Stelle bedeutet, daß das Panel auf dem korrespondierenden Desktop sichtbar ist; eine 1, daß das Panel unsichtbar ist. Z.B. bestimmt die Folge 01011000, daß das Panel auf den Desktops 2, 4 und 5 verborgen ist.

- PersonalFirst=`on&verbar;off` Bei `on` erscheinen die benutzerspezifischen Einträge im Anwendungsstarter an erster Stelle. Bei `off` steht die KDE-Standardauswahl an erster Stelle.

- Position=`bottom&verbar;top&verbar;left&verbar;right` Bestimmt die Position des Panels auf dem Bildschirm.

- Style=`normal&verbar;tiny&verbar;large` Bestimmt den Stil des Panels. Diese Einstellung wird von dem graphischen Konfigurations-Utility kcmkpanel ausgewertet und betrifft die Erscheinung des Panels nicht direkt.

- TaskbarButtonHorizontalSize=value Ein Integerwert, der die Breite der Taskleiste bestimmt.

- TaskbarPosition=`top&verbar;top&lowbar;left&verbar;bottom&verbar;hidden` Bestimmt die Position der Taskleiste auf dem Bildschirm. Bei `hidden` ist die Taskleiste unsichtbar.

#### &lsqb;kpanel-Buttons&rsqb;

Dieser Abschnitt legt die Anordnung der Panel-Buttons fest.

- Buttons=button1, button2, ... Eine Liste der Buttons auf dem Panel, wobei button&num; `system` (der Anwendungsstarter), `windowlist` (die Fensterleiste) oder der absolute Pfad einer .kdelnk-Datei sein kann.

- ButtonDelta=delta1, delta2, ... Bestimmt die Position der Buttons auf dem Panel. Die Deltas sind Fließkommawerte und stellen für jeden Button seinen Abstand zu dem Button unmittelbar links von bzw. über ihm dar.

- control=value Bestimmt, nach welchem Button die Gruppe der Desktop-Buttons folgt. Bei 0 folgt die Gruppe unmittelbar auf den K-Button, bei 1 folgt sie auf den 1. Button nach dem K-Button usw.

- controldelta=delta Bestimmt den Abstand der Gruppe der Desktop-Buttons von dem Button unmittelbar links von bzw. über ihr.

## Dank

### Entwickler

`Matthias Ettrich`

### Autoren

`Stephen Schaub`

`Robert Williams` - Editor

### Übersetzer

`Bernd Platzdasch`