点击或拖拽改变大小

Functions.Tone 方法

X#
以指定的频率和持续时间发出扬声器音调。 注意:
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
查看代码

参数

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
示例
这个例子是一个表示批处理操作已完成的蜂鸣函数:
X#
1FUNCTION DoneBeep()
2    Tone(300, 1)
3    Tone(100, 1)
4    Tone(300, 1)
5    Tone(100, 1)
这个例子是一个表示无效按键或边界条件的音调序列:
X#
1FUNCTION ErrorBeep()
2    Tone(100, 3)
参见