XDeviceBell

Section: X FUNCTIONS (3X11)
Updated: Release 6.6
索引 xjman

名前

XDeviceBell - 入力機能拡張を通じてサポートされているデバイスでベルを鳴らす

書式

Status XDeviceBell(display, device, feedbackclass, feedbackid, percent)

      Display *display;

      XDevice *device;

      XID *feedbackclass;

      XID *feedbackid;

      int *percent;

引き数

display: X サーバへの接続を指定する。
device: ベルが対応するデバイスを指定する。
feedbackclass: ベルが対応するフィードバックのクラスを指定する。
feedbackid: ベルが対応するフィードバックのIDを指定する。
percent: ベルが鳴る音量を -100 から 100 の範囲で指定する。

説明

XDeviceBell リクエストは、X サーバに可能であれば、指定したデバイスの指定したフィードバックでベルを鳴らす。指定した音量はベルの基本音量に対する相対値である。不正なデバイスが指定された場合、BadDevice エラーが返される。引き数 feedbackclass と feedbackid は、XGetFeedbackControl リクエストに返される値を持ち、鳴らされるベルを一意に識別する。ベルをサポートしていない feedbackclass が指定された場合や、存在しない feedbackid が指定された場合や、-100 から 100 の範囲でないパーセント数が指定された場合には、エラー BadValue が返される。

引き数 percent が負でない値の場合にはベルが鳴る音量は

: base - [(base * percent) / 100] + percent

となる。引き数 percent が負の値の場合には、ベルが鳴る音量は

: base + [(base * percent) / 100]

となる。ベルの基本音量を変えるには XChangeFeedbackControl を使用する。

XDeviceBell はエラー BadDevice, BadValue を起こし得る。

返り値

BadDevice: 不正なデバイスが指定された。指定されたデバイスが存在しないか、クライアントの XOpenInputDevice によってオープンされていない。
BadValue: 不正な feedbackclass, feedbackid, percent 値が指定された。

jman

Time: 07:00:49 GMT, January 12, 2009

XDeviceBell

名前

書式

引き数

説明

返り値

関連項目

Index