Functions.Tone 方法 | |
以指定的频率和持续时间发出扬声器音调。
注意:
Tone() 是一个兼容性函数,不再推荐使用。
它被 Windows API 的 MessageBeep()、SndPlaySound() 和 MCI 系列函数所取代。MessageBeep() 在系统库中定义,而其他函数在 Win32 API 库中定义。要使用这些函数,您必须在应用程序的搜索路径中包含 Win32 API 库。
命名空间:
XSharp.RT
程序集:
XSharp.RT (在 XSharp.RT.dll 中) 版本:2.22 GA
语法 FUNCTION Tone(
wFrequency AS DWORD,
wDuration AS DWORD
) AS USUAL
public static __Usual Tone(
uint wFrequency,
uint wDuration
)
查看代码参数
- wFrequency
- 类型:UInt32
要发出的音调的频率。 - wDuration
- 类型:UInt32
音调的持续时间,以 1/18 秒为增量单位。
例如,wDuration 值为 18 表示一秒。
对于这两个参数,非整数值会被截断(而不是四舍五入)为其整数部分。
返回值
类型:
__Usual备注
Tone() 是一个声音函数,用于向用户指示各种程序状态。
这些可以是错误状态、边界条件或耗时过程的结束。
例如,错误状态会在向用户显示消息或交互对话框之前发出错误音。
边界条件可能表示用户正试图在 TBrowse 对象的列中光标移动到顶部或底部之外。
批处理过程也可能通过声音表示其完成,以提醒用户,以防用户已离开屏幕。
Tone() 通过在指定频率下发出指定持续时间的扬声器声音来工作。
持续时间以 1/18 秒为增量单位。
频率以赫兹(每秒周期数)为单位。小于 20 的频率是听不见的。
下表显示了标准音乐音符的频率。
注意:
Tone() 仅在 IBM PC 和 100% 兼容的计算机上工作。
音高 频率 音高 频率
C 130.80 中央 C 261.70
C# 138.60 C# 277.20
D 146.80 D 293.70
D# 155.60 D# 311.10
E 164.80 E 329.60
F 174.60 F 349.20
F# 185.00 F# 370.00
G 196.00 G 392.00
G# 207.70 G# 415.30
A 220.00 A 440.00
A# 233.10 A# 466.20
B 246.90 B 493.90
C 523.30
示例
这个例子是一个表示批处理操作已完成的蜂鸣函数:
1FUNCTION DoneBeep()
2 Tone(300, 1)
3 Tone(100, 1)
4 Tone(300, 1)
5 Tone(100, 1)
这个例子是一个表示无效按键或边界条件的音调序列:
1FUNCTION ErrorBeep()
2 Tone(100, 3)
参见