俗话说,一个好汉十个帮,众人拾柴火焰高等都说明一个道理,有更多的资源,更丰富的积累,都是助你走向成功,走向顶峰的推动力。
本篇继续继续整理优化已有的共用类库,并继续发表随笔介绍公用类库的接口方法以及详细使用操作,力求给自己继续优化,积攒更丰富的公用类库资源,加深了解的同时,也给大家展现公用类库好的方面。
本篇的公用类库的介绍主题是设备相关的部分,包括计算机硬件信息(如系统信息、电脑CPU、磁盘、网卡、内存等)、声音播放控制、 键盘属性及操作、全局键盘按键钩子、鼠标属性及操作、鼠标按键钩子等类库信息。
1、**WAV声音格式文件播放辅助类AudioHelper**
实现效果
1)本辅助类主要是用来方便实现播放WAV声音格式文件的操作。
2)声音播放可以用在特定事件的触发上,如来电、收到消息等,经典的就如QQ收到信息,咳嗽的声音,使用声音播放可以提高更好的用户体验。
实现代码
1)辅助类提供的方法接口如下所示:
///
/// 播放 .wav 格式的声音文件
///
/// 声音文件路径
public static void Play(string location)
///
/// 播放 .wav 格式的声音文件
///
/// 播放声音的枚举模式。默认为AudioPlayMode.Background。
/// 声音文件路径
public static void Play(string location, AudioPlayMode playMode)
///
/// 播放 .wav 格式的声音文件
///
/// 声音文件的流对象
/// 播放声音的枚举模式。默认为AudioPlayMode.Background。
public static void Play(Stream stream, AudioPlayMode playMode)
///
/// 播放 .wav 格式的声音文件
///
/// 声音文件的字节数组
/// 播放声音的枚举模式。默认为AudioPlayMode.Background。
public static void Play(byte[] data, AudioPlayMode playMode)
///
/// 播放系统声音
///
public static void PlaySystemSound(SystemSound systemSound)
///
/// 停止正在后台播放的声音
///
public static void Stop()
2) 辅助类AudioHelper的使用例子代码如下所示
private void btnPlaySound_Click(object sender, EventArgs e)
{
try
{
AppConfig config = new AppConfig();
string SoundFilePath = config.AppConfigGet(\"SoundFilePath\");
AudioHelper.Play(SoundFilePath);//AudioHelper.Play(\"ringin.wav\");
}
catch (Exception ex)
{
LogHelper.Error(\"没找到声音文件\" , ex);
}
}
2、声音文件播放操作辅助类SoundPlayerHelper。除了MP3声音文件外,还可以播放WAV格式、midi格式声音文件。
实现效果
1)本辅助类主要是用来方便实现MP3文件、WAV文件、Midi文件等声音的播放操作,并提供音量控制操作功能。
实现代码
1)辅助类提供的方法接口如下所示:
///
/// 播放声音文件
///
/// 声音文件路径(可以是MP3、WAV、Midi等声音文件)
/// 是否重复播放
public static void Play(string soundFileName,bool Repeat)
///
/// 播放声音嵌入资源字节数组
///
/// 声音文件嵌入资源字节数组(可以是MP3、WAV、Midi等声音格式)
/// 是否重复播放
public static void Play(byte[] soundEmbeddedResource, bool Repeat)
///
/// 暂停播放
///
public static void Pause()
///
/// 停止播放
///
public static void Stop()
///
/// 清除操作
///
public static void Dispose()
///
/// 获取或设置音量的百分比
///
///
public static float VolumePercent
///
/// 获取音量
///
///
public static float GetVolume()
///
/// 设置音量
///
///
public static void SetVolume(float volume)
///
/// 返回当前状态播放:播放,暂停,停止等
///
public static string Status
2)辅助类SoundPlayerHelper的使用例子代码如下所示
bool isPlay = false;
private void btnPlayMp3_Click(object sender, EventArgs e)
{
if (!isPlay)
{
string mp3File = Path.Combine(Application.StartupPath, \"伤不起.mp3\");
string waveFile = Path.Combine(Application.StartupPath, \"ringin.wav\");
string midFile = @\"C:\\Windows\\Media\\onestop.mid\";
SoundPlayerHelper.Play(mp3File, false); //播放MP3格式文件
//SoundPlayerHelper.Play(waveFile, true); //播放WAV格式文件
//SoundPlayerHelper.Play(midFile, false); //播放Midi格式文件
this.btnPlayMp3.Text = \"停止播放\";
}
else
{
SoundPlayerHelper.Stop();//停止播放
//SoundPlayerHelper.Pause();//暂停播放
this.btnPlayMp3.Text = \"播放声音\";
}
string statu = SoundPlayerHelper.Status;
this.Text = statu;
isPlay = !isPlay;
}
private void trackBar1_Scroll(object sender, EventArgs e)
{
//设置音量
float vol = SoundPlayerHelper.VolumePercent;
SoundPlayerHelper.VolumePercent = trackBar1.Value;
}
3、提供用户硬件唯一信息的辅助类 FingerprintHelper
实现效果
1)本辅助类主要是用来方便实现获取用户硬件的相关信息,根据用户各种硬件(CPU、网卡、磁盘、主板等)标识信息,获取一个8位唯一标识数字。
2)本辅助类只提供了一个公共的方法Value,它集合了CPU、网卡、磁盘、主板等信息,通过这个8位的数字标识,我们可以唯一区分一台电脑,类似我们每个人的指纹信息一样,很少会发生重复的现象,可以用在一些关键的注册授权机制上。
实现代码
1)辅助类提供的方法接口如下所示:
///
/// 根据用户各种硬件(CPU、网卡、磁盘、主板等)标识信息,
/// 获取一个8位唯一标识数字
///
public static string Value()
///
/// 获取硬件的标识信息
///
private static string identifier(string wmiClass, string wmiProperty, string wmiMustBeTrue)
///
/// 获取硬件的标识信息
///
private static string identifier(string wmiClass, string wmiProperty)
///
/// 获取CPU信息
///
private static string cpuId()
///
/// 获取BOIS主板标识信息
///
private static string biosId()
///
/// 获取主硬盘的标识信息
///
///
private static string diskId()
///
/// 获取主板的标识信息
///
///
private static string baseId()
///
/// 获取主视频控制器标识信息
///
///
private static string videoId()
///
/// 获取第一个可用网卡信息
///
///
private static string macId()
///
/// 转换内容为8位数字
///
private static string pack(string text)
2)辅助类FingerprintHelper的使用例子代码如下所示
string identity = FingerprintHelper.Value();
MessageUtil.ShowTips(identity);
4、获取系统信息、电脑CPU、磁盘、网卡、内存等相关信息辅助类 HardwareInfoHelper
实现效果
1)本辅助类主要是用来方便获取系统信息、电脑CPU、磁盘、网卡、内存等相关信息。
实现代码
1)辅助类提供的方法接口如下所示:
///
/// 获得盘符为drvID的硬盘序列号,缺省为C
///
/// 盘符,如\"C\"
///
public static string HDVal(string drvID)
///
/// 获取默认C盘的磁盘序列号
///
///
public static string HDVal()
///
/// 获取硬盘ID
///
///
public static string GetDiskID()
///
/// 获取硬盘Model的信息
///
public static string GetDiskModel()
///
/// 获得Cpu使用率
///
public static int GetCpuUsage()
///
/// 获取CPU的ID
///
///
public static string GetCPUId()
///
/// 获取CPU的名称
///
///
public static string GetCPUName()
///
/// 返回USB盘符列表
///
public static List GetUSBDriveLetters()
///
/// 获得硬盘信息
///
public static HardDiskInfo GetHDInfo(byte driveIndex)
#region 其他数据
///
/// 获取MAC地址
///
///
public static string GetMacAddress()
///
/// 获取IP地址
///
public static string GetIPAddress()
///
/// 获取操作系统的登录用户名
///
public static string GetUserName()
///
/// 获取计算机名
///
public static string GetComputerName()
///
/// 获取PC类型
///
public static string GetSystemType()
///
/// 获取物理内存
///
public static string GetTotalPhysicalMemory()
#endregion
2)辅助类HardwareInfoHelper的使用例子代码如下所示
private void btnComputer_Click(object sender, EventArgs e)
{
string computerName = HardwareInfoHelper.GetComputerName();
string userName = HardwareInfoHelper.GetUserName();
string systemType = HardwareInfoHelper.GetSystemType();
string cpuid = HardwareInfoHelper.GetCPUId();
string cpuName = HardwareInfoHelper.GetCPUName();
int cpuUsage = HardwareInfoHelper.GetCpuUsage();
string diskId = HardwareInfoHelper.GetDiskID();
string ip = HardwareInfoHelper.GetIPAddress();
string macAddress = HardwareInfoHelper.GetMacAddress();
string memery = HardwareInfoHelper.GetTotalPhysicalMemory();
StringBuilder sb = new StringBuilder();
sb.AppendFormat(\"ComputerName:\\t {0} \\r\\n\", computerName);
sb.AppendFormat(\"UserName:\\t {0} \\r\\n\", userName);
sb.AppendFormat(\"SystemType:\\t {0} \\r\\n\", systemType);
sb.AppendFormat(\"CPU ID:\\t {0} \\r\\n\", cpuid);
sb.AppendFormat(\"CPU Name:\\t {0} \\r\\n\", cpuName);
sb.AppendFormat(\"CPU Usage:\\t {0} \\r\\n\", cpuUsage);
sb.AppendFormat(\"Disk Id:\\t {0} \\r\\n\", diskId);
sb.AppendFormat(\"IP:\\t {0} \\r\\n\", ip);
sb.AppendFormat(\"MacAddress:\\t {0} \\r\\n\", macAddress);
sb.AppendFormat(\"TotalPhysicalMemory:\\t {0} \\r\\n\", memery);
MessageUtil.ShowTips(sb.ToString());
string identity = FingerprintHelper.Value();
MessageUtil.ShowTips(identity);
}
5、键盘操作辅助类KeyboardHelper,提供属性访问敲击那个键,以及发送软键盘消息等操作。
实现效果
1)本辅助类主要是用来方便实现访问键盘的大写键、数字键等键的开启情况,另外判断CTRL、Shift、Alt键是否按下的操作,辅助类也封装了发送软键盘消息等操作。
实现代码
1)辅助类提供的方法接口如下所示:
#region 键盘属性
///
/// 判断ALT建是否按下
///
public static bool AltKeyDown
///
/// 判断Caps Lock大写键是否打开
///
public static bool CapsLock
///
/// 判断CTRL键是否按下
///
public static bool CtrlKeyDown
///
/// 判断Num Lock 数字键是否打开
///
public static bool NumLock
///
/// 判断Scroll Lock滚动锁定键是否打开
///
public static bool ScrollLock
///
/// 判断Shift键是否按下
///
public static bool ShiftKeyDown
#endregion
#region 操作方法
///
/// 发送一个或多个击键到活动窗口。
///
/// 定义发送键的字符串。特殊控制键代码SHIFT(+),CTRL(^), ALT(%)。Send(\"{SPACE}\")、Send(\"+{TAB}\")
public static void SendKeys(string keys)
///
/// 发送一个或多个击键到活动窗口
///
/// 定义发送键的字符串.特殊控制键代码SHIFT(+),CTRL(^), ALT(%)。Send(\"{SPACE}\")、Send(\"+{TAB}\")
/// 指定是否要等待应用程序继续之前得到处理的击键。默认为True。
///
public static void SendKeys(string keys, bool wait)
#endregion
2)辅助类KeyboardHelper的使用例子代码如下所示
bool capsLock = KeyboardHelper.CapsLock;
bool numLock = KeyboardHelper.NumLock;
bool scrollLock = KeyboardHelper.ScrollLock;
KeyboardHelper.SendKeys(\"{TAB}\"); //发送Tab键
KeyboardHelper.SendKeys(\"%{F4}\"); //发送Alt + F4退出
相关的按键参考如下所示
6、全局键盘钩子,用来捕捉系统全局的键盘输入辅助类 KeyboardHook
实现效果
1)本辅助类主要是用来方便实现全局键盘钩子,用来捕捉系统全局的键盘输入。
2)通过键盘钩子,我们可以获取用户的各种按键信息,以及可以屏蔽指定按键的操作,全局键盘钩子,就如一扇门一样,可以记录相关的键盘输入操作,也可以增加指定的事件处理,可以控制键盘按键继续流转到其他程序中,或者屏蔽操作。最典型的钩子操作例子就是金山词霸等取词软件。
3)辅助类通过KeyboardHook.Enable()开始键盘钩子,通过KeyboardHook.Disable()禁用或者通过KeyboardHook.Remove(**)来移除指定的键盘钩子事件。
实现代码
1)辅助类提供的方法接口如下所示:
///
/// 判断是否CTRL键按下
///
public static bool Control = false;
///
/// 判断Shift键是否按下
///
public static bool Shift = false;
///
/// 检查Alt键是否按下
///
public static bool Alt = false;
///
/// 检查Windows键是否按下
///
public static bool Win = false;
///
/// 键盘敲击事件代理定义
///
public delegate bool KeyPressed();
///
/// 处理键盘按下委托函数
///
///
/// 按下的键。需检查CTRL、Shift、Win等键。
///
/// 如果想应用程序能捕捉到,设置为True;如果设置为False,则键盘事件被屏蔽。
///
public delegate bool KeyboardHookHandler(Keys key);
///
/// 添加一个键盘钩子处理给当前的键
///
public static KeyboardHookHandler KeyDown;
///
/// 启动键盘钩子处理
///
/// 如无异常返回True
public static bool Enable()
///
/// 禁用键盘钩子处理
///
/// 如果禁用成功,则返回True
public static bool Disable()
///
/// 添加一个按下键的钩子处理
///
/// 按下的键
/// 按键的处理事件函数
public static bool AddKeyDown(Keys key, KeyPressed callback)
///
/// 添加一个键弹起的钩子处理
///
/// 弹起的键
/// 按键的处理事件函数
public static bool AddKeyUp(Keys key, KeyPressed callback)
///
/// 添加一个按下键的钩子处理
///
/// 按下的键
/// 按键的处理事件函数
public static bool Add(Keys key, KeyPressed callback)
///
/// 移除一个按下键的钩子处理
///
/// 移除的按键
public static bool RemoveDown(Keys key)
///
/// 移除一个弹起键的钩子处理
///
/// 移除的按键
public static bool RemoveUp(Keys key)
///
/// 移除一个键的钩子处理
///
/// 移除的按键
public static bool Remove(Keys key)
///
/// 返回一个给定的键基于当前的控制键的字符串表示形式。
///
/// 当前的键
///
public static string KeyToString(Keys key)
2)辅助类KeyboardHook的使用例子代码如下所示
private void btnKeyboadHook_Click(object sender, EventArgs e)
{
KeyboardHook.Enable();
KeyboardHook.Add(Keys.S, new KeyboardHook.KeyPressed(TestKeyboadHook));
}
private bool TestKeyboadHook()
{
//仅处理Alt + S 的钩子事件
if (KeyboardHook.Alt)
{
this.Text = DateTime.Now.ToString();
NativeMethods.BringToFront(this.Handle);
}
return true; //如果要被其他程序捕捉,返回True,否则返回False。
}
private void btnRemoveKeyboadHook_Click(object sender, EventArgs e)
{
KeyboardHook.Remove(Keys.S);
}
7、鼠标辅助操作类,提供获取鼠标状态以及模拟鼠标点击等操作 MouseHelper
实现效果
1)本辅助类主要是用来方便获取鼠标状态以及模拟鼠标点击等操作,通过该辅助类,可以获取鼠标是否安装、滚轮是否支持、或者模拟鼠标移动、单击、双击等操作。
实现代码
1)辅助类提供的方法接口如下所示:
#region 鼠标相关属性
///
/// 检查鼠标是否已经安装.
///
public static bool MousePresent
///
/// 检查鼠标是否存在滚轮
///
public static bool WheelExists
///
/// 获取鼠标滚轮每次滚动的行数
///
public static int WheelScrollLines
#endregion
#region 鼠标操作函数
///
/// 连续两次鼠标单击之间会被处理成双击事件的间隔时间。
///
/// 以毫秒表示的双击时间
[DllImport(\"user32.dll\", EntryPoint = \"GetDoubleClickTime\")]
public static extern int GetDoubleClickTime();
///
/// 检取光标的位置,以屏幕坐标表示。
///
/// POINT结构指针,该结构接收光标的屏幕坐标。
/// 如果成功,返回值非零;如果失败,返回值为零。
[DllImport(\"user32.dll\", EntryPoint = \"GetCursorPos\")]
public static extern int GetCursorPos(Point lpPoint);
///
/// 把光标移到屏幕的指定位置。如果新位置不在由 ClipCursor函数设置的屏幕矩形区域之内,则系统自动调整坐标,使得光标在矩形之内。
///
/// 指定光标的新的X坐标,以屏幕坐标表示。
/// 指定光标的新的Y坐标,以屏幕坐标表示。
/// 如果成功,返回非零值;如果失败,返回值是零
[DllImport(\"user32.dll\")]
public static extern int SetCursorPos(int x, int y);
#endregion
#region 封装函数
///
/// 在当前鼠标的位置左键点击一下
///
public static void MouseClick()
///
/// 移动到坐标位置点击
///
/// 要点击的坐标位置,屏幕绝对值
public static void MouseClick(Point location)
///
/// 移动到坐标位置点击
///
/// 要点击的坐标位置,屏幕绝对值
public static void MouseRightClick(Point location)
///
/// 移动到坐标位置
///
public static void MouseMove(Point location)
#endregion
2)辅助类MouseHelper的使用例子代码如下所示
操作比较简单,自己操作下即可。
8、全局的鼠标钩子操作类,用作捕捉全局的鼠标输入操作的辅助类 MouseHook
实现效果
1)本辅助类主要是用来方便实现全局的鼠标钩子,用作捕捉全局的鼠标输入操作。
实现代码
1)辅助类提供的方法接口如下所示:
///
/// 鼠标输入处理代理
///
/// 操作的鼠标键
/// 如果想应用程序能捕捉到,设置为True;如果设置为False,则鼠标事件被屏蔽。
public delegate bool MouseButtonHandler(MouseButtons button);
///
/// 鼠标按键按下处理操作
///
public static MouseButtonHandler ButtonDown;
///
/// 鼠标按键弹起处理操作
///
public static MouseButtonHandler ButtonUp;
///
/// 鼠标移动处理操作
///
public static MouseMoveHandler Moved;
///
/// 鼠标滚动处理操作
///
public static MouseScrollHandler Scrolled;
///
/// 启动鼠标钩子处理
///
/// 如无异常则返回True
public static bool Enable()
///
/// 禁用鼠标钩子操作
///
/// 禁用成功则返回True
public static bool Disable()
2)辅助类MouseHook的使用例子代码如下所示
private void btnMouseHook_Click(object sender, EventArgs e)
{
MouseHook.ButtonDown = new MouseHook.MouseButtonHandler(TestMouseHook);
MouseHook.Scrolled = new MouseHook.MouseScrollHandler(TestMouseScroll);
MouseHook.Enable();
}
private bool TestMouseHook(MouseButtons sender)
{
this.Text = string.Format(\"你单击了鼠标键:{0}\", sender);
return true;
}
private bool TestMouseScroll(int delta)
{
this.Text = string.Format(\"你滚动了鼠标值:{0}\", delta);
return true;
}
整理文档本身也对类库进行进一步的优化,整理过程本身也是一次马拉松式的身心赛跑。