名称

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 リクエストは、可能ならサーバが指定されたフィードバックで 指定されたデバイスのベルを鳴らすようにします。 ベルの基本音量に対する相対的な音量が指定できます。 無効なデバイスが指定された場合、 BadDevice エラーが返されます。 feedbackclass および feedbackid パラメータは XGetFeedbackControl リクエストが返す値を保持し、 鳴らすベルをユニークに指定します。 ベルをサポートしない feedbackclass を指定した場合や、 存在しない feedbackid を指定した場合、 音量の値として −100 から 100 の範囲外の percent を指定した場合、 BadValue エラーが返されます。

percent の値が正の場合の音量:

基本音量 − [(基本音量 ∗ percent) / 100] + percent

percent の値が負の場合の音量:

基本音量 + [(基本音量 ∗ percent/ 100]

ベルの基本音量を変更する場合、 XChangeFeedbackControl を指定します。

XDeviceBell は BadDevice または BadValue エラーを生成します。

診断

BadDevice 無効なデバイスが指定された。 指定したデバイスが存在しない、 または クライアントがこのデバイスを XOpenInputDevice を使って オープンしていない。

BadValue 無効な feedbackclass、feedbackid、または percent が指定された。

関連事項

XChangeFeedbackControl(3XI), XBell(3X11)
Programming With Xlib

NEWS-OSRelease 4.2.1R