# K パネル ハンドブック

KDE チーム
バージョン 0.19.1-1, 1998年6月6日

この文書は kpanel バージョン 0.19.1 向けに最終更新しました。 コメントや追加があれば、著者までお願いします。

KDE パネル ハンドブック

KDE
panel

## はじめに

kpanel は、KDE におけるアプリケーションや仮想デスクトップの起動や管理の 際にお役に立ちます。次のようなさまざまなものへすばやくアクセスすることが可能になります:

- KDE アプリケーション スタータ

- 動作中のアプリケーションのタスクバー

- 頻繁に使用するアプリケーションの起動用ボタン

- 仮想デスクトップ

kpanel は、柔軟性や設定性に富んでおり、システム全般にわたる設定とユーザ の個人用設定の双方をサポートしています。このドキュメンテーションでは、 kpanel の設定方法と使用方法について解説します。

### 機能

kpanel が提供する機能をいくつか紹介します:

- 別個に配置可能なパネルとタスクバー

- パネルとタスクバーの自動隠蔽機能

- 設定可能なツールチップ

- 通知/ステータス関連の小さなアプリケーションをパネル内で直に動作させる機能

- パネル上のボタンに複数のアイコンを設定し、kpanel の コマンドを用いてそれらを切り替える機能

## 画面上での基本操作

kpanel では、次の 2 つのウィンドウを表示します: タスクバー、およびパネル。

- タスクバー では、現在動作中のアプリケーションを表示します。

- パネル には次のようなものが入っています。 アプリケーション スタータ; ウィンドウ リストを表示するボタン; 仮想デスクトップ ボタン; および頻繁に起動するアプリケーション用のボタン。

パネルとタスクバーは別個に配置することが可能です。

### タスクバー

タスクバー は、動作中のアプリケーションのリストを表示します。アイコン化 されたウィンドウのタイトルは括弧つきになっています。リスト内のエントリをクリ ックすると、選択したアプリケーションへ即座に移動できます。その際、必要に応じ て仮想デスクトップは変更されます。

また、タスクバー内のエントリ上でマウスを右クリックすると、オプションから、ア プリケーションの最大化、アイコン化、終了、あるいは現在のデスクトップへの移動が選択できます。

### パネル

パネル は標準で画面の下部に表示されます。ここには、アプリケーション スタ ータ、時計、および頻繁に使用するアプリケーションや仮想デスクトップのボタンが 入っています。左側にある編み目のバーをクリックすると、現在のデスクトップ上で パネルを消すことができます (他の仮想デスクトップ上では表示されたままです)。 また、パネルの設定 により自動的に隠蔽する ことも可能で、この場合、パネルがついている画面の端にマウス ポインタを触れさ せるまでパネルは表示されなくなります。

ここでは、標準のパネル上に表示されるアイコンについて説明します:

アプリケーション スタータ

  パネル上の大きな K をクリックすると、アプリケーションやユーティリティのメニ ューが開きます。また、ここからヘルプ システムや KDE コントロール パネルにア クセスすることもできます。 独自にエントリを追加することが可能です。

  ショートカット: `Alt-F1` によりアプリケーション スタータが開きます

ウィンドウ リスト

  ウィンドウが連なったように見えるボタンをクリックすると、現在開いているアプリ ケーションをデスクトップごとにまとめて表示するメニューが開きます。括弧つきの タイトルは、アイコン化されたウィンドウを表しています。アプリケーションを選択 してアクセスしてください。

  ショートカット: デスクトップの空いているエリア上でマウスの真ん中のボタンをク リックすると、ウィンドウ リストが表示されます。

/ホーム ディレクトリ

  家の絵のついたボタンによって、自分のホーム ディレクトリ内にあるファイルにす ばやくアクセスすることができます。

仮想デスクトップ

  パネルの中ほどにある、標準で「1」、「2」、などと文字で表記されたボタンによ り、仮想デスクトップにアクセスできます。仮想デスクトップの数やその表記は、 変更することが可能です。

ヘルプ ブラウザ

  本の絵のついたボタンによって、KDE のオンライン ヘルプ システムにアクセスすることができます。

標準のアイコンに加え、 独自にボタンを追加 して、頻繁に使用するプログラムを起動することができます。また、設定により、タ スクバー内で直接プログラムを起動させることも可能です: たとえば、動作中のメー ル通知プログラムをタスクバー内に表示し、クリック時にメールプログラムを起動す るようなボタンを定義することができます。

## パネルの設定

kpanel は、KDE ユーザ インタフェイスの一部であり、非常に柔軟性と設定性に 富んでいます。当セクションでは、kpanel をお好みにカスタマイズするために参考 となる説明をおこなっています。kpanel の設定ファイルである kpanelrc に関する情報については、 開発者ガイド セクションをご覧ください。

次の各設定のための説明を以下におこないます

- パネルの位置/動作

- パネルのボタン

- 仮想デスクトップ

- アプリケーション スタータ

### パネルの位置/動作

パネルとタスクバーの位置と動作を設定するには、パネル上でアイコンのないエリア を右クリックし、メニューから「設定」を選択します。設定に関する特定の情報につ いては、「ヘルプ」ボタンをクリックしてください。

### パネルのボタン

パネルのボタンのアイコンを右クリックして現れるコンテキスト メニューからご希 望のオプションを選択すれば、パネルのボタンの移動、削除、あるいはプロパティの変更が可能です。

パネルにボタンを追加するには、次の 3 つの方法のうちいずれかを用いてください:

- パネル上にウィンドウ リストのボタンを置くには、 「アプリケーション スタータ」 > 「パネル」 > 「ウィンドウ リストの追加」を選択します。

- アプリケーションをアプリケーション スタータからパネル上に置くには、 「アプリケーション スタータ」 > 「パネル」 > 「アプリケーションの追加」を選択し、さらにメニューを進んで、目的のアプリケーションを選択してください。ま た、同じ手順によって、アプリケーション スタータからサブメニューを直接パネル 上に置くことも可能です; 目的のサブメニューまで進めば、サブメニューで最初の項 目を選択します。それがそのサブメニューそのものです。たとえば、パネル上に「設 定」サブメニューを置くには、 「アプリケーション スタータ」 > 「パネル」 > 「アプリケーションの追加」 > 「システム」 > 「システム」 を選択します。

- kfm ウィンドウ、あるいはデスクトップからパネルへアイコンをドラッ グしてください。.kdelnk ファイル、および .kdelnk ファイルの入っているフォル ダのみ、パネル上へ置くことが可能です。パネル上にアイコンを置いたらアイコンを 右クリックし、メニューから「プロパティ」を選択してセットアップしてください。 注意: このようにしてパネル上にアイコンを置いた場合、元の .kdelnk ファイ ル、あるいはフォルダを移動、もしくは削除しないように注意してください。さもな いと、パネルがアイコンを表示できなくなります。

ツール チップ:: kpanel は、パネル上のボタンやアプリケーション スタータ内のエントリのツール チップを表示します。ボタンのツール チップを設定 するには、ボタンを右クリックし、メニューから「プロパティ」を選択してくださ い。「アプリケーション」タブをクリックし、 「コメント」 欄にツール チップ のテキストを入れます。変更を反映させるには、 kpanel を再起動させる必要が あるかもしれません (パネルを右クリックし、「再起動」を選択します)。

アプリケーションのスワロー: アプリケーションのアイコンのプロパティ の「実行」タグで「パネル上でスワロー」設定を選択すると、固定アイコンではなく 実行中のアプリケーションを表示するボタンをパネル上に置くことができるようにな ります。これは特に、xbiff のような通知、あるいはステータス用の小さなアプリケ ーションについては便利です。以下がその方法です:

- 「実行」 を、パネル内で実行させるアプリケーションの名前に設定しま す。ただし、これは「パネル上でスワロー」エリア内の「実行」設定です。

- 「ウィンドウ タイトル」 を、通常デスクトップから実行された際にこの アプリケーションが開くウィンドウのタイトルに設定します。 kpanel はこのタ イトルによって、どのウィンドウをパネル内に持ってくればよいかを決定します。ウ ィンドウにタイトルバーがない場合は、デスクトップからそのアプリケーションを実 行し、タスクバーを見てどんなタイトルを使用すればよいかを決定してください。

### 仮想デスクトップ

パネル上の仮想デスクトップ ボタンの表記を変更、あるいは仮想デスクトップの数 を変更するには、パネル上のアイコンのないエリアを右クリックし、メニューから 「設定」を選択します。KPanel の「設定」ウィンドウ内の「デスクトップ」タブを クリックし、ご希望の変更をおこなってください (設定に関する特定の情報について は、「ヘルプ」をクリックしてください)。

### アプリケーション スタータ

アプリケーション スタータのユーザ セクションをカスタマイズするには、 「アプリケーション スタータ」 > 「パネル」 > 「メニューの編集」 を選択します。 kmenuedit ユーティリティ内にある指示にしたがって、項目をセットアップし てください。

自分のカスタム エントリをメニュー上での第 1 エントリにするには、パネル上のア イコンのないエリアをクリックし、メニューから「設定」を選択します。「オプショ ン」タブをクリックし、「個人用第 1」項目を選択してください。

## 開発者ガイド

当セクションでは、上級ユーザ、および開発者にとって重要な話題を扱っています。 扱う話題は以下のとおりです:

- kpanel コマンド

- kpanelrc 設定ファイル

### kpanel コマンド

次の 2 つのうちいずれかの手法によって、K ウィンドウ マネージャを介してコマンドを kpanel に送ることができます:

`KWM::sendKWMCommand(QString)` (KDE アプリケーションにて) または `kwmcom` command (コマンド ラインから)

kpanel は以下のコマンドに対して反応します:

- kpanel:restart パネルを再起動し、パネルの設定ファイルを読み込み直します。

- kpanel:hide ユーザがパネルの端の小さな編み目のバーをクリックした 場合と同様に、現在のデスクトップ上のパネルを隠蔽します。

- kpanel:show パネルが隠蔽されている場合は、再表示します。

- kpanel:system アプリケーション スタータを開きます。

- kpanel:goXXXXYYYY 画面上の特定の場所にてアプリケーション スタータ を開きます。たとえば `kpanel:go05000100` であれば、このメニューを (500,100) という座標で開きます。

- kpanel:icon:&num;:button パネル上で ボタン に対して表示されるアイコンを変更します。 &num; は 1 から 4 であり、これはボタンの .kdelnk ファイル (この書式の行は icon=pixmap、 icon2=pixmap、など。) 内でボタンに対して定義されたアイコンを指しています。

### kpanelrc

kpanel は KDE コントロール センターを用いて設定できます (「アプリケーション スタータ」 > 「KDE コントロール センター」))。「アプリケーション」セクションから 「パネル」 を選択して、さまざまな設定オプションを操作してください。

設定ファイルの編集を希望される方向けに、当セクションでは、 ˜/.kde/share/config 内に存在する kpanelrc ファイル中のオプションについて説明します。

kpanelrc 設定ファイルは以下の 2 つのセクションに分けられます:

- kpanel

- kpanelButtons

#### &lsqb;kpanel&rsqb;

kpanel セクションには、 kpanel の挙動をつかさどるさまざまなエントリが含まれています。

- AutoHide=`on&verbar;off` `on` の場合、ユーザがパネル上からポインタをはずすと、パネルは自動的に隠蔽されます。

- AutoHideTaskbar=`on&verbar;off` `on` の場合、ユーザがパネル上からポインタをはずすと、タスクバーは自動的に隠蔽されます。

- BackgroundTexture=pixmap パネルの背景として pixmap を表示します。

- BoxHeight=value (ピクセル単位) BoxWidth=value (ピクセル単位) これらの設定はそれぞれ、パネルの高さ、およびパネル上のボタンの幅を決定します。

- ClockAmPm=`on&verbar;off` `on` の場合、パネル上の時計は AM/PM インジケータを表示します; `off` の場合、時計は 24 時間形式で時刻を表示します。

- DateFont=font パネル上の時計のフォントを指定します。 `*-times-medium-i-normal--12-*` のように、X フォントの指定子を用いてください。

- DateVisible=`true&verbar;false` If `false` の場合、パネルの時計を隠蔽します。

- DesktopButtonFont=font パネル上の仮想デスクトップ ボタンの幅を指定します。

- DesktopButtonHorizontalSize=value パネル上の仮想デスクトップ ボタンの幅を指定します。 value には `BoxWidth` の 2 分の 1 が掛けられます。

- DesktopButtonRows=value パネル上の仮想デスクトップ ボタンの列数を指定します。

- FoldersFirst=`on&verbar;off` `on` の場合、アプリケーション スタータ メニュー上のサブメニューは常に上部 に表示されます。 `off` の場合、すべての項目はアルファベット順に表示されます。

- Margin=value (ピクセル単位) この値は、パネルに対する上部と下部の境界の幅を指定します。

- MenuToolTips=value (ミリ秒単位) ツールチップが表示されるまでアプリケーションスタータメニュー上の項目の上でユ ーザがマウスを固定し続けていなければならない時間の長さを指定します。

- PanelHidden=00000000 この設定は、パネルを隠蔽するデスクトップを設定します。設定は 8 箇所あり、こ れらは 8 個のデスクトップに対応しています。各箇所の 0 は、対応するデスクトッ プ上でパネルが表示されることを示しています; 1 はパネルが隠蔽されることを示し ています。たとえば、01011000 という設定では、2、4、および 5 のデスクトップ上 でパネルが隠蔽されます。

- PersonalFirst=`on&verbar;off` `on` の場合、ユーザの個人用のメニュー設定が、アプリケーション スタータ メ ニュー上で第 1 項目として表示されます。 `off` の場合、KDE の標準設定の項目 が第 1 となります。

- Position=`bottom&verbar;top&verbar;left&verbar;right` 画面上におけるパネルの位置を指定します。

- Style=normal&verbar;tiny&verbar;large パネルのスタイルを指定します。これは kpanel のグラフィカル設定ユーティリティである kcmkpanel で使用されるものであり、パネルの外観に直接的な影響は及ぼしません。

- TaskbarButtonHorizontalSize=value タスクバーの幅を指定する整数値です。

- TaskbarPosition=`top&verbar;top&lowbar;left&verbar;bottom&verbar;hidden` 画面上におけるタスクバーの位置を指定します。 `hidden` の場合、タスクバーは表示されません。

#### &lsqb;kpanelButtons&rsqb;

当セクションでは、パネル ボタンのレイアウトを指定します。

- Buttons=button1, button2, ... パネル上のボタンのリストであり、ここでは、 button&num; は `system` (アプリケーション スタータ)、 `windowlist` (ウィンドウ リスト)、あるいは .kdelnk ファイルの絶対パスになります。

- ButtonDelta=delta1, delta2, ... パネル上におけるボタンの位置を指定します。delta は浮動小数点数であり、各ボタ ンに対して、すぐ左/上のボタンからの距離を表しています。

- control=value どのボタンの後ろに一連の仮想デスクトップ ボタンが来るのかを指定します。0 の 場合、K ボタンの直後に来ます; 1 の場合、K の次のボタンの後ろに来る、などです。

- controldelta=delta 一連の仮想デスクトップ ボタンの、すぐ左/上のボタンからの距離を指定します。

## クレジット

### 開発者

`Matthias Ettrich`

### 著者

`Stephen Schaub`

`Robert Williams` - 編集