C# 枚举中使用Flags特性以编写帮助文档

C#枚举中使用Flags特性

  .NET中的枚举我们一般有两种用法，一是表示唯一的元素序列；还有就是用来表示多种复合的状态。这个时候一般需要为枚举加上[Flags]特性标记为位域,这样我们就可以用"或"运算符组合多个状态.

using System;
using System.Runtime.InteropServices;

namespace tetris
{
    /// <summary>
    /// Sound 的摘要说明。
    /// </summary>
    public class PlaySound
    {
        internal class Helpers1
        {
            [Flags]
            public enum PlaySoundFlags : int
            {
                ///<params>"play synchronously(default)"</params>
                ///<params>"play asynchronously"</params>
                ///<params>"silence(!default)if sound not found "</params>
                ///<params>"pszSound points to a memory file"</params>
                ///<params>"loop the sound until next sndPlaySound"</params>
                ///<params>"don't stop any currently playing sound"</params>
                ///<params>"don't wait if the driver is busy"</params>
                ///<params>"name is a registry alias"</params>
                ///<params>"alias is a predefined ID"</params>
                ///<params>"name is file name"</params>
                ///<params>"name is resource name or atom"</params>
                SND_SYNC = 0x0000,  /* play synchronously (default) */ //同步
                SND_ASYNC = 0x0001,  /* play asynchronously */ //异步
                SND_NODEFAULT = 0x0002,  /* silence (!default) if sound not found */
                SND_MEMORY = 0x0004,  /* pszSound points to a memory file */
                SND_LOOP = 0x0008,  /* loop the sound until next sndPlaySound */
                SND_NOSTOP = 0x0010,  /* don't stop any currently playing sound */
                SND_NOWAIT = 0x00002000, /* don't wait if the driver is busy */
                SND_ALIAS = 0x00010000, /* name is a registry alias */
                SND_ALIAS_ID = 0x00110000, /* alias is a predefined ID */
                SND_FILENAME = 0x00020000, /* name is file name */
                SND_RESOURCE = 0x00040004  /* name is resource name or atom */
            }

            [DllImport("winmm.dll")]
            public static extern bool PlaySound(string szSound, IntPtr hMod, PlaySoundFlags flags);
        }


        public class Sound
        {
            public static void Play(string strFileName)
            {
                Helpers1.PlaySound(strFileName, IntPtr.Zero, Helpers1.PlaySoundFlags.SND_FILENAME | Helpers1.PlaySoundFlags.SND_ASYNC);
            }
        }
    }
}