الثوابت المسماة
تأخذ معلمة الدالة المضمَّنة ذات المجموعة الثابتة من الخيارات قيمة Integer من إحدى مساحات الأسماء هذه.
تُستبدل الأسماء بأرقامها عند ترجمة البرنامج النصي، لذا لا تكلّف شيئًا في وقت التشغيل، ويُكملها المحرر بعد
أن تكتب مساحة الأسماء ونقطة، ويعرض قيمة كل اسم ومعناه. وهي حساسة لحالة الأحرف، والاسم المكتوب بشكل خاطئ خطأ في الترجمة. يعمل الرقم
نفسه أيضًا (VirtualKey.A هو 65 هو 0x41)، لكن الاسم يوضح المقصود. ويأخذ حقل الخطوات الذي يقبل
عددًا صحيحًا الأسماء نفسها.
| مساحة الأسماء | الأعضاء = القيمة | تستخدمها |
|---|---|---|
MouseButton | Left=0 Right=1 Middle=2 X1=3 X2=4 Primary=5 Secondary=6 | MouseClick وMouseButtonDown/Up وMouseDoubleClick وMouseIsButtonDown؛ وهي أيضًا ما تُرجعه ContextGetStrokeButton (-1 عند عدم وجود سياق زر). Primary هو الزر الذي يعامله Windows كنقرة يسرى وSecondary هو الزر الذي يعامله كنقرة يمنى، وفقًا لإعداد «زر الماوس الأساسي» في Windows، لذا استخدمهما للنقرة العادية أو النقر بزر الماوس الأيمن. Left وRight هما الزران الفعليان: عند تبديل الزرين الأساسي والثانوي في إعدادات الماوس في Windows، تكون نقرة MouseButton.Left هي الزر الأيسر الفعلي، الذي يعامله Windows كنقرة يمنى. تُبلغ ContextGetStrokeButton عن الزر بعد التبديل بالقيمة Primary أو Secondary، لذا تُبلغ إيماءة الزر الأيمن عن Secondary أيًّا كان الزر الفعلي الذي رسمها، وتمرير القيمة إلى MouseClick يضغط الزر نفسه. تستخدم وحدات الماكرو المسجَّلة Primary وSecondary. |
FileNotify | FileName=0x1 DirName=0x2 Attributes=0x4 Size=0x8 LastWrite=0x10 LastAccess=0x20 Creation=0x40 Security=0x100 | المعلمة filterMask في FolderWatchCreate. هذه علامات بت، لذا ادمجها باستخدام |. |
AudioEndpoint | Playback=0 Capture=1 Communications=2 | الدوال المضمَّنة Multimedia* الخاصة بمستوى الصوت وكتمه |
WindowStyle | Normal=0 Minimized=1 Maximized=2 Hidden=3 | ShellRunProgram |
ShellVerb | Open=0 Edit=1 Print=2 RunAs=3 Properties=4 Explore=5 Find=6 | المعلمة verb في ShellRunProgram، التي تقبل أيضًا أي فعل آخر كقيمة Text |
Location | TopLeft=0 TopCenter=1 TopRight=2 MiddleLeft=3 MiddleCenter=4 MiddleRight=5 BottomLeft=6 BottomCenter=7 BottomRight=8 | المعلمة location في UIShowDisplayMessage، التي تقبل أيضًا نقطة شاشة كقيمة Text بالشكل "x,y" |
TextAlign | Left=0 Center=1 Right=2 | UIShowDisplayMessage/UIUpdateDisplayMessage |
LockResult | Acquired=0 TimedOut=1 Pinned=2 | تُرجعها UtilityLockAcquire/UtilityLockAcquirePinned |
LockState | Free=0 HeldByMe=1 HeldByOther=2 Pinned=3 | تُرجعها UtilityLockGetState |
SerialParity | None=0 Odd=1 Even=2 Mark=3 Space=4 | SerialOpenPort، SerialMonitorCreate |
SerialStopBits | One=0 OnePointFive=1 Two=2 | SerialOpenPort، SerialMonitorCreate |
DateTimeStyle | ShortDate=0 LongDate=1 ShortTime=2 LongTime=3 ShortDateTime=4 LongDateTime=5 FileStamp=6 | DateTimeFormat. تتبع كلها باستثناء FileStamp إعدادات المنطقة في Windows للمستخدم، بالتقويم الخاص بتلك المنطقة؛ أما FileStamp فيكون دائمًا بالشكل 20261001-140509، الذي يُفرز حسب الوقت وآمن في اسم الملف. |
DateTimePart | Year=0 Month=1 Day=2 Hour=3 Minute=4 Second=5 Weekday=6 | DateTimeGetPart. ميلادي، بالتوقيت المحلي. Weekday وفق ISO: الاثنين هو 1، والأحد هو 7. |
VirtualKey | رموز المفاتيح الظاهرية في Win32، مسماة وفق التعداد Keys في .NET (مدرجة أدناه) | كل دالة مضمَّنة من نوع Keyboard* تأخذ key من نوع Integer |
أعضاء VirtualKey
تُسمى مفاتيح Oem* بالرمز الذي تُنتجه على لوحة مفاتيح أمريكية. يختلف المفتاح الفعلي باختلاف التخطيط.
LButton RButton Cancel MButton XButton1 XButton2 Back Tab Clear Enter ShiftKey ControlKey Menu Pause CapsLock Escape Space PageUp PageDown End Home Left Up Right Down Select Print Execute PrintScreen Insert Delete Help D0 D1 D2 D3 D4 D5 D6 D7 D8 D9 A B C D E F G H I J K L M N O P Q R S T U V W X Y Z LWin RWin Apps Sleep NumPad0 NumPad1 NumPad2 NumPad3 NumPad4 NumPad5 NumPad6 NumPad7 NumPad8 NumPad9 Multiply Add Separator Subtract Decimal Divide F1 F2 F3 F4 F5 F6 F7 F8 F9 F10 F11 F12 F13 F14 F15 F16 F17 F18 F19 F20 F21 F22 F23 F24 NumLock Scroll LShiftKey RShiftKey LControlKey RControlKey LMenu RMenu BrowserBack BrowserForward BrowserRefresh BrowserStop BrowserSearch BrowserFavorites BrowserHome VolumeMute VolumeDown VolumeUp MediaNextTrack MediaPreviousTrack MediaStop MediaPlayPause LaunchMail SelectMedia LaunchApplication1 LaunchApplication2 OemSemicolon Oemplus Oemcomma OemMinus OemPeriod OemQuestion Oemtilde OemOpenBrackets OemPipe OemCloseBrackets OemQuotes Oem8 Oem102
نص تركيبة المفاتيح (KeyboardPressKeyCombo)
تأخذ KeyboardPressKeyCombo قيمة Text، وليس ثابتًا: أي عدد من بادئات مفاتيح التعديل، ثم مفتاح واحد
بالضبط. تركيبة واحدة لكل استدعاء، بلا أعداد تكرار. لا يجوز أن يلي المفتاحَ أي شيء: "^cx" أو
"Control+V" خطأ، وليس ضغطًا للمفتاح الأول.
| البادئة | ^ | + | % | @ |
|---|---|---|---|---|
| مفتاح التعديل | Ctrl | Shift | Alt | Win |
المفتاح حرف أو رقم واحد (بأي حالة أحرف)، أو أحد هذه الأسماء بين أقواس معقوصة، بأي حالة أحرف: {ENTER}
{ESC} {TAB} {DEL} {BS} {SPACE} {HOME} {END} {PGUP} {PGDN} {LEFT} {RIGHT}
{UP} {DOWN} {INSERT} {F1}…{F24} {PRTSC} {CAPSLOCK} {NUMLOCK} {SCROLLLOCK}
{BREAK} {HELP} {CLEAR} {NUMPAD0}…{NUMPAD9} {MULTIPLY} {ADD} {SEPARATOR}
{SUBTRACT} {DECIMAL} {DIVIDE}. يعمل أيضًا {ESCAPE} و{DELETE}.
أمثلة: "^c" Ctrl+C · "^+{ESC}" Ctrl+Shift+Esc · "%{F4}" Alt+F4 · "@d" Win+D ·
"^{HOME}" Ctrl+Home · "{enter}" Enter.
هل تعرف SendKeys في .NET؟ تتبع البادئات والأسماء بين الأقواس المعقوصة
صيغة SendKeys من Microsoft. يضيف هذا
النص @ لمفتاح Windows، و{NUMPAD0}…{NUMPAD9} و{SEPARATOR} و{DECIMAL} لمفاتيح لوحة الأرقام نفسها. ولا يدعم
أعداد التكرار ({LEFT 4})، ولا عدة مفاتيح في نص واحد ("^s{ENTER}")، ولا المجموعات بين أقواس ("+(ec)")، ولا ~
لمفتاح Enter، ولا الأحرف الحرفية بين أقواس معقوصة مثل {+}، ولا الاسمين المختصرين {BKSP} و{INS}.