必要なサポートライブラリーつきでEmacsがビルドされていて、かつグラフィカル端末上で実行されていれば、Emacsバッファー内にGTK+
WebKitウィジェットのようなネイティブウィジェットを表示することができます。Emacsが埋め込みウィジェットを表示可能かテストするには、xwidget-internal
機能が利用可能かどうかをチェックします(Named Featuresを参照)。
Emacsバッファー内に埋め込みウィジェットを表示するためには、最初にxwidgetオブジェクトを作成して、テキストプロパティまたはオーバーレイプロパティdisplay
内のディスプレイ仕様としてそのオブジェクトを使用します(Display Propertyを参照)。
これはxwidgetオブジェクトを作成してリターンする。bufferが省略かnil
の場合のデフォルトはカレントバッファー。bufferが存在しないバッファーの名前を指定する場合には作成する。typeはxwidgetコンポーネントを識別するもので以下のいずれかが可能:
webkit
WebKitコンポーネント。
引数widthとheightはウィジェットのサイズをピクセル単位で指定して、titleはそのタイトルを指定する文字列。
この関数はobjectがxwidgetならt
、それ以外はnil
をリターンする。
この関数はxwidgetのプロパティリストをリターンする。
この関数はplistで与えられた新たなプロパティリストでxwidgetのプロパティリストを置き換える。
この関数はxwidgetのバッファーをリターンする。
この関数はbufferに関連付けられたxwidgetオブジェクトのリストをリターンする。bufferはバッファーオブジェクトか既存のバッファー名(文字列)を指定できる。bufferにxwidgetが含まれなければ値はnil
。
この関数は与えられたxwidget内で指定したuriをブラウズ(browse: 閲覧)する。uriはファイルかURLを指定する文字列。
この関数はxwidgetで指定されるブラウザウィジェットに、script
で指定するJavaScriptを実行させる。
この関数はxwidget-webkit-execute-script
と同様に指定したscriptを実行するが、スクリプトのリターン値も文字列としてリターンする。この関数はscriptが値をリターンしなければdefault、defaultが省略されたらnil
をリターンする。
この関数はxwidgetのタイトルを文字列としてリターンする。
この関数は指定したxwidgetをwidthxheightのサイズ(ピクセル単位)にリサイズする。
この関数はxwidgetのサイズを(width
height)
という形式のリストでリターンする。単位はピクセル。
この関数は[type title width
height]
という形式のベクターでxwidgetの属性をリターンする。属性は通常はxwidgetの作成時にmake-xwidget
で決定される。
この関数はEmacsがxwidgetに関連付けられたバッファーのexitやkillの前にユーザーに確認を求めるようにアレンジすることを可能にする。flagが非nil
ならEmacsはユーザーに確認を求めて、それ以外なら確認を求めない。
この関数はxwidgetのquery-on-exitフラグのカレントセッティングをt
かnil
のいずれかでリターンする。