.\"
.\" $XFree86: xc/doc/man/Xi/XDevBell.man,v 1.2 2001/01/27 18:20:21 dawes Exp $
.\"
.\"
.\" Copyright ([\d,\s]*) by Hewlett-Packard Company, Ardent Computer, 
.\" 
.\" Permission to use, copy, modify, distribute, and sell this documentation 
.\" for any purpose and without fee is hereby granted, provided that the above
.\" copyright notice and this permission notice appear in all copies.
.\" Ardent, and Hewlett-Packard make no representations about the 
.\" suitability for any purpose of the information in this document.  It is 
.\" provided \`\`as is'' without express or implied warranty.
.\" 
.\" $TOG: XDevBell.man /main/9 1997/11/04 20:46:37 kaleb $
.\"
.\" Copyright (c) 1998, 2001 The X Japanese Documentation Project.
.\" 
.\" Permission is hereby granted, free of charge, to any person obtaining a
.\" copy of this software and associated documentation files (the
.\" "Software"), to deal in the Software without restriction, including
.\" without limitation the rights to use, copy, modify, merge, publish, dis-
.\" tribute, sublicense, and/or sell copies of the Software, and to permit
.\" persons to whom the Software is furnished to do so, subject to the fol-
.\" lowing conditions:
.\" 
.\" The above copyright notice and this permission notice shall be included
.\" in all copies or substantial portions of the Software.
.\" 
.\" THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS
.\" OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABIL-
.\" ITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.  IN NO EVENT
.\" SHALL  THE X JAPANESE DOCUMENTATION PROJECT  BE  LIABLE  FOR  ANY CLAIM,
.\" DAMAGES OR OTHER LIABILITY,  WHETHER IN AN ACTION OF CONTRACT,  TORT OR
.\" OTHERWISE,  ARISING FROM,  OUT OF OR IN CONNECTION WITH THE SOFTWARE OR
.\" THE USE OR OTHER DEALINGS IN THE SOFTWARE.
.\" 
.\" Except as contained in this notice, the name of The X Japanese
.\" Documentation Project shall not be used in advertising or otherwise to
.\" promote the sale, use or other dealings in this Software without prior
.\" written authorization from The X Japanese Documentation Project.
.\" 
.\" X Window System is a trademark of The Open Group.
.\"
.\" Translated Wed Oct 27 22:00:20 JST 1998
.\"         by FUJIWARA Teruyoshi <fujiwara@linux.or.jp>
.\" Updated Sun Sep 23 19:53:47 JST 2001 for XFree86 4.1.0
.\"         by FUJIWARA Teruyoshi <fujiwara@linux.or.jp>
.\"
.\" $Xorg: XDevBell.man,v 1.3 2000/08/17 19:41:56 cpqbld Exp $
.ds xL Programming With Xlib
.TH XDeviceBell 3X11 "Release 6.5" "X Version 11" "X FUNCTIONS"
.SH 名前
.\"0 XDeviceBell \- ring a bell on a device supported through the input extension
XDeviceBell \- 入力機能拡張を通じてサポートされているデバイスでベルを鳴らす
.SH 書式
Status XDeviceBell\^(\^\fIdisplay\fP, \fIdevice\fP\^, \fIfeedbackclass\fP\^, \fIfeedbackid\fP\^, \fIpercent\fP\^)
.br
      Display *\fIdisplay\fP\^;
.br
      XDevice *\fIdevice\fP\^; 
.br
      XID *\fIfeedbackclass\fP\^; 
.br
      XID *\fIfeedbackid\fP\^; 
.br
      int *\fIpercent\fP\^; 
.br
.SH 引き数
.TP 12
.I display
.\"0 Specifies the connection to the X server.
X サーバへの接続を指定する。
.TP 12
.I device
.\"0 Specifies the device with which the bell is associated.
ベルが対応するデバイスを指定する。
.TP 12
.I feedbackclass
.\"0 Specifies the class of the feedback with which the bell is associated.
ベルが対応するフィードバックのクラスを指定する。
.TP 12
.I feedbackid
.\"0 Specifies the id of the feedback with which the bell is associated.
ベルが対応するフィードバックのIDを指定する。
.TP 12
.I percent
.\"0 Specifies the volume in the range -100 to 100 at which the bell should be rung.
ベルが鳴る音量を \-100 から 100 の範囲で指定する。
.SH 説明
.\"0 The \fIXDeviceBell\fP request causes the server to ring a bell on the 
.\"0 specified feedback of the specified device, if possible.  
\fIXDeviceBell\fP リクエストは、X サーバに可能であれば、指定した
デバイスの指定したフィードバックでベルを鳴らす。
.\"0 The specified volume is relative to the base volume for the bell.
指定した音量はベルの基本音量に対する相対値である。
.\"0 If an invalid device is specified,
.\"0 a \fIBadDevice\fP error will be returned.  The feedbackclass and feedbackid
.\"0 parameters contain values returned by an \fIXGetFeedbackControl\fP request
.\"0 and uniquely identify the bell to ring.  If a feedbackclass is specified that
.\"0 does not support a bell, or if a nonexistent feedbackid is specified,
.\"0 or a percent value is specified that is not in the range -100 to 100,
.\"0 a \fIBadValue\fP error will be returned.
不正なデバイスが指定された場合、\fIBadDevice\fP エラーが返される。
引き数 feedbackclass と feedbackid は、\fIXGetFeedbackControl\fP 
リクエストに返される値を持ち、鳴らされるベルを一意に識別する。
ベルをサポートしていない feedbackclass  が指定された場合や、存在しない
feedbackid が指定された場合や、\-100 から 100 の範囲でないパーセント数
が指定された場合には、エラー \fIBadValue\fP が返される。
.LP
.\"0 The volume at which the bell is rung when the percent argument is 
.\"0 nonnegative is:
引き数 percent が負でない値の場合にはベルが鳴る音量は
.IP
base \- [(base * percent) / 100] + percent
.LP
となる。
.\"0 The volume at which the bell rings
.\"0 when the percent argument is negative is:
引き数 percent が負の値の場合には、ベルが鳴る音量は
.IP
base + [(base * percent) / 100]
.LP
となる。
.\"0 To change the base volume of the bell, use \fIXChangeFeedbackControl\fP.
ベルの基本音量を変えるには \fIXChangeFeedbackControl\fP を使用する。
.LP
.\"0 \fIXDeviceBell\fP can generate a \fIBadDevice\fP or a \fIBadValue\fP
.\"0 error.
\fIXDeviceBell\fP はエラー \fIBadDevice\fP, \fIBadValue\fP を起こし得
る。
.SH 返り値
.TP 12
\fIBadDevice\fP
.\"0 An invalid device was specified.  The specified device does not exist, or has 
.\"0 not been opened by this client via \fIXOpenInputDevice\fP.
不正なデバイスが指定された。指定されたデバイスが存在しないか、クライア
ントの \fIXOpenInputDevice\fP によってオープンされていない。
.TP 12
\fIBadValue\fP
.\"0 An invalid feedbackclass, feedbackid, or percent value was specified.
不正な feedbackclass, feedbackid, percent 値が指定された。
.SH 関連項目
XChangeFeedbackControl(3X),
XBell(3X)
.br
\fI\*(xL\fP