GNU Emacs 32.0.50 (9008bf64c3) のマニュアルを PLaMo 翻訳で機械翻訳したものです。誤訳を含むことがあります。原文: https://www.gnu.org/software/emacs/manual/html_node/elisp/Xwidget-Events.html ・ emacs-doc.conao3.com

22.7.11 Xwidgetイベント

Xwidgets(組み込みネイティブウィジェットを参照)は、Lispプログラムにステータスを更新するためのイベントを送信できます。これらのイベントはxwidget-eventsと呼ばれ、変更の内容を示すさまざまなデータを含んでいます。

(xwidget-event kind xwidget arg)

このイベントは、xwidget で何らかの更新が発生するたびに送信されます。更新にはいくつかの種類があり、それぞれ kind で識別されます。

これは特殊なイベント(特殊イベントを参照)であり、xwidget の xwidget イベントを受信するたびに呼び出されるコールバックを xwidget に追加することで処理する必要があります。

xwidgetのプロパティリストのcallbackにコールバックを設定することで追加できます。このコールバックは、xwidgetとkindを引数として受け取る関数である必要があります。

load-changed

このxwidgetイベントは、xwidgetがページ読み込みプロセスの特定の時点に達したことを示します。これらのイベントが送信されると、argにはウィジェットの状態をさらに詳細に記述する文字列が含まれます:

‘load-started’

これは、ウィジェットがページ読み込み処理を開始したことを意味します。

‘load-finished’

これは、xwidget がそれまで行っていたページ読み込み処理を完了したことを意味します。

‘load-redirected’

これは、ページ読み込み処理中に xwidget がリダイレクトを検知し、それに従ったことを意味します。

‘load-committed’

これは、ページ読み込み処理中に xwidget が特定のURLを確定したことを意味します。つまり、そのURLが、現在のページ読み込み処理において xwidget によってレンダリングされる最終的なURLとなります。

download-callback

このイベントは、何らかのダウンロードが完了したことを示しています。

In the above events, there can be arguments after arg, which itself indicates the URL from which the download file was retrieved: the first argument after arg indicates the MIME type of the download, as a string, while the second argument contains the full file name of the downloaded file.

download-started

このイベントは、ダウンロードが開始されたことを示します。これらのイベントでは、arg に現在ダウンロード中のファイルの URL が含まれます。

javascript-callback

このイベントにはJavaScriptのコールバックデータが含まれています。これらのイベントはxwidget-webkit-execute-scriptで内部的に使用されます。

(xwidget-display-event xwidget source)

このイベントは、あるxwidgetが別のxwidgetの表示を要求するたびに送信されます。xwidgetは表示されるべきxwidgetであり、sourceはxwidgetの表示を要求したxwidgetです。

また、これはコールバックを通じて処理すべき特殊なイベントでもあります。このようなコールバックは、sourceのプロパティリストのdisplay-callbackに設定することで追加でき、そのプロパティリストにはxwidgetとsourceを引数として受け取る関数を指定する必要があります。

xwidgetのバッファは一時バッファに設定されます。ウィジェットを表示する際は、set-xwidget-bufferを用いて、バッファをxwidgetが表示されるバッファに置き換えるよう注意してください(組み込みネイティブウィジェットを参照)。