Next: ファイル変更による通知, Previous: セッションマネージャー, Up: オペレーティングシステムのインターフェース [Contents][Index]
Emacsはfreedesktop.orgのDesktop Notifications
SpecificationをサポートするシステムとMS-Windowsでは通知(notifications)を送ることができます。この機能をPOSIXホストで使用するにはEmacsがD-Busサポート付きでコンパイルされていて、notifications
ライブラリーがロードされていなければなりません。D-Bus in D-Bus integration in
Emacsを参照してください。D-Busサポートが利用できるときには以下の関数がサポートされます。
この関数は引数paramsで指定された構成したパラメーターによりD-Busを通じてデスクトップに通知を送信する。これらの引数は交互になったキーワードと値のペアーで構成されていること。以下はサポートされているキーワードと値:
:bus bus
D-Busのバス。この引数は:session
以外のバスを使用する場合のみ必要。
:title title
通知のタイトル。
:body text
通知のbodyのテキスト。通知サーバーの実装に依存して‘"<b>bold text</b>"’のようなHTMLマークアップ、ハイパーリンク、イメージをテキストに含むことができる。HTML特殊文字は‘"Contact <postmaster@localhost>!"’のようにエンコードしなければならない。
:app-name name
その通知を送信するアプリケーション名。デフォルトはnotifications-application-name
。
:replaces-id id
この通知が置換する通知のid。idはnotifications-notify
の以前の呼び出し結果でなければならない。
:app-icon icon-file
通知アイコンのファイル名。nil
ならアイコンは表示されない。デフォルトはnotifications-application-icon
。
:actions (key title key title ...)
適用されるアクションのリスト。keyとtitleはどちらも文字列。デフォルトのアクション(通常は通知クリックで呼び出される)は‘"default"’という名前であること。実装がそれを表示しないようにするには自由だがtitleは何でもよい。
:timeout timeout
timeoutは通知が表示されてからその通知が自動的にクローズされるまでのミリ秒での時間。-1なら通知の有効期限は通知サーバーのセッティングに依存して、通知のタイプにより異なるかもしれない。0なら通知は失効しない。デフォルト値は-1。
:urgency urgency
緊急レベル。low
、normal
、critical
のいずれか。
:action-items
このキーワードが与えられるとアクションのtitle文字列はアイコン名として解釈される。
:category category
通知の種類の文字列。標準のカテゴリーのリストはDesktop Notifications Specificationを参照のこと。
:desktop-entry filename
これは‘"emacs"’のようにプログラムを呼び出すデスクトップファイル名の名前を指定する。
:image-data (width height rowstride has-alpha bits channels data)
これはそれぞれwidth、height、rowstride、およびalpha channel、bits per sample、channels、image dataの有無を記述するrawデータのイメージフォーマット。
:image-path path
これはURI(現在サポートされているのはURIスキーマは‘file://’のみ)、または‘$XDG_DATA_DIRS/icons’にあるfreedesktop.org準拠のアイコンテーマ名のいずれかを表す。
:sound-file filename
通知ポップアップ時に再生するサウンドファイルのパス。
:sound-name name
通知ポップアップ時に再生するfreedesktop.orgサウンド命名仕様準拠のテーマに対応した‘$XDG_DATA_DIRS/sounds’にある名前付きサウンド。アイコン名と同様にサウンドにたいしてのみ。例としては‘"message-new-instant"’。
:suppress-sound
それが可能ならサーバーにすべてのサウンドの再生を抑制させる。
:resident
セットするとアクション呼び出し時にサーバーは通知を自動的に削除しない。ユーザーか送信者により明示的に削除されるまで通知はサーバー内に常駐し続ける。恐らくこのヒントはサーバーが:persistence
能力をもつときのみ有用。
:transient
セットするとサーバーはその通知を過渡的なものとして扱い、もしそれが永続的であるべきならサーバーのpersistence能力をバイパスする。
:x position
:y position
その通知がポイントすべきスクリーン上のXとYの座標を指定する。これらの引数は併せて使用しなければならない。
:on-action function
アクション呼び出し時に呼び出す関数。通知idとアクションのkeyは引数としてその関数に渡される。
:on-close function
タイムアウトかユーザーにより通知がクローズされたときに呼び出す関数。通知idとクローズ理由reasonは引数としてその関数に渡される。:
expired
。
dismissed
。
notifications-close-notification
呼び出しにより通知がクローズされたら
close-notification
undefined
。
通知サーバーがどのパラメーターを受け入れるかのチェックはnotifications-get-capabilities
を通じて行うことができる。
この関数は整数の通知idをリターンする。このidはnotifications-close-notification
や別のnotifications-notify
呼び出しの:replaces-id
引数で通知アイテムの操作に使用できる。たとえば:
(defun my-on-action-function (id key) (message "Message %d, key \"%s\" pressed" id key)) ⇒ my-on-action-function
(defun my-on-close-function (id reason) (message "Message %d, closed due to \"%s\"" id reason)) ⇒ my-on-close-function
(notifications-notify :title "Title" :body "This is <b>important</b>." :actions '("Confirm" "I agree" "Refuse" "I disagree") :on-action 'my-on-action-function :on-close 'my-on-close-function) ⇒ 22
A message window opens on the desktop. Press ``I agree''. ⇒ Message 22, key "Confirm" pressed Message 22, closed due to "dismissed"
この関数は識別子idの通知をクローズする。busはD-Bus接続を表す文字列でありデフォルトは:session
。
通知サーバーの能力をシンボルのリストでリターンする。busはD-Bus接続を表す文字列でありデフォルトは:session
。以下は期待できる能力:
:actions
サーバーはユーザーにたいする指定されたアクションを提供する。
:body
bodyのテキストをサポートする。
:body-hyperlinks
サーバーは通知内のハイパーリンクをサポートする。
:body-images
サーバーは通知内のイメージをサポートする。
:body-markup
サーバーは通知内のマークアップをサポートする。
:icon-multi
サーバーは与えられたイメージ配列内のすべてのフレームのアニメーションを描画できる。
:icon-static
与えられたイメージ配列内の正確に1フレームの表示をサポートする。この値は、:icon-multi
とは相互に排他。
:persistence
サーバーは通知の永続性をサポートする。
:sound
サーバーは通知のサウンドをサポートする。
これらに加えてベンダー固有の能力は:x-gnome-foo-cap
のように:x-vendor
で始まる。
通知サーバーの情報を文字列のリストでリターンする。busはD-Bus接続を表す文字列でありデフォルトは:session
。リターンされるリストは(name
vendor version spec-version)
。
サーバーのプロダクト名。
ベンダー名。たとえば‘"KDE"’や‘"GNOME"’。
サーバーのバージョン番号。
サーバーが準拠する仕様のバージョン。
spec_versionがnil
ならサーバーは‘"1.0"’以前の仕様をサポートする。
EmacsがMS-WindowsでGUIセッションとして実行時には、ネイティブのプリミティブを通じてD-Bus通知の小サブセットをサポートします:
この関数はparamsの指定にしたがってMS-Windowsのトレー通知(tray notification)を表示する。MS-Windowsトレー通知はタスクバーのの通知エリア内のアイコンからのバルーン内に表示される。
値は以下で説明するw32-notification-close
で通知の削除に使用できる一意な通知ID。関数が失敗するとリターン値はnil
。
引数paramsはkeyword/valueペアーで指定する。パラメーターはすべてオプションだが何もパラメーターを指定しなければ関数は何もせずにnil
をリターンする。
は以下はサポートされるパラメーター:
:icon icon
システムトレーにiconを表示する。iconが文字列ならアイコンをロードするファイル名(Windowsのアイコンファイル.ico)を指定すること。iconが文字列以外、またはこのパラメーターが指定されなければEmacsの標準アイコンが使用される。
:tip tip
通知のツールチップにtipを使用する。tipが文字列なら、通知により追加されたトレーアイコン上にマウスポインターを移動した際に表示されるツールチップのテキスト。tipが文字列以外またはこのパラメーターが指定されていなければ、ツールチップのデフォルトのテキストは‘Emacs notification’。ツールチップのテキストは127文字まで(Windows 2000以前は63文字)。それより長い文字列は切り捨てられる。
:level level
通知の重大度レベルでinfo
、warning
、error
のいずれか。値が与えられた場合には、:title
パラメーターも指定されて、かつ文字列の場合のみ通知アイコンの左に表示されるアイコンを決定する。
:title title
通知のタイトル。titleが文字列ならbodyテキストの直上に大きなフォントで表示される。タイトルのテキストは63文字まで。それより長い文字列は切り捨てられる。
:body body
通知のbody(本文)。bodyが文字列なら通知メッセージのテキストを指定する。テキストを行に分割する方法を制御するには埋め込みの改行を使用する。bodyのテキストは255文字までで、それより長ければ切り捨てられる。D-Busとは異なりbodyテキストはマークアップを含まないプレーンテキストであること。
Windows
2000以前のWindowsでは:icon
と:tip
だけがサポートされることに注意。他のパラメーターを渡すことは可能だが、それらの古いシステムでは無視されるだろう。
一度にアクティブな通知は最大でも常に1つ。新たな通知を表示できるようにするにはw32-notification-close
を呼び出してアクティブな通知を削除しなければならない。
タスクバーから通知とアイコンを削除するには以下の関数を使用します:
この関数は与えられた一意なidでトレー通知を削除する。
Next: ファイル変更による通知, Previous: セッションマネージャー, Up: オペレーティングシステムのインターフェース [Contents][Index]