إنتقل إلى المحتوى الرئيسي

الثوابت المسماة

تأخذ معلمة الدالة المضمَّنة ذات المجموعة الثابتة من الخيارات قيمة Integer من إحدى مساحات الأسماء هذه. تُستبدل الأسماء بأرقامها عند ترجمة البرنامج النصي، لذا لا تكلّف شيئًا في وقت التشغيل، ويُكملها المحرر بعد أن تكتب مساحة الأسماء ونقطة، ويعرض قيمة كل اسم ومعناه. وهي حساسة لحالة الأحرف، والاسم المكتوب بشكل خاطئ خطأ في الترجمة. يعمل الرقم نفسه أيضًا (VirtualKey.A هو 65 هو 0x41)، لكن الاسم يوضح المقصود. ويأخذ حقل الخطوات الذي يقبل عددًا صحيحًا الأسماء نفسها.

مساحة الأسماءالأعضاء = القيمةتستخدمها
MouseButtonLeft=0 Right=1 Middle=2 X1=3 X2=4 Primary=5 Secondary=6MouseClick وMouseButtonDown/Up وMouseDoubleClick وMouseIsButtonDown؛ وهي أيضًا ما تُرجعه ContextGetStrokeButton (-1 عند عدم وجود سياق زر، أو إذا رُسمت الإيماءة بمفتاح الرسم). Primary هو الزر الذي يعامله Windows كنقرة يسرى وSecondary هو الزر الذي يعامله كنقرة يمنى، وفقًا لإعداد «زر الماوس الأساسي» في Windows، لذا استخدمهما للنقرة العادية أو النقر بزر الماوس الأيمن. Left وRight هما الزران الفعليان: عند تبديل الزرين الأساسي والثانوي في إعدادات الماوس في Windows، تكون نقرة MouseButton.Left هي الزر الأيسر الفعلي، الذي يعامله Windows كنقرة يمنى. تُبلغ ContextGetStrokeButton عن الزر بعد التبديل بالقيمة Primary أو Secondary، لذا تُبلغ إيماءة الزر الأيمن عن Secondary أيًّا كان الزر الفعلي الذي رسمها، وتمرير القيمة إلى MouseClick يضغط الزر نفسه. تستخدم وحدات الماكرو المسجَّلة Primary وSecondary.
FileNotifyFileName=0x1 DirName=0x2 Attributes=0x4 Size=0x8 LastWrite=0x10 LastAccess=0x20 Creation=0x40 Security=0x100المعلمة filterMask في FolderWatchCreate. هذه علامات بت، لذا ادمجها باستخدام |.
AudioEndpointPlayback=0 Capture=1 Communications=2الدوال المضمَّنة Multimedia* الخاصة بمستوى الصوت وكتمه
WindowStyleNormal=0 Minimized=1 Maximized=2 Hidden=3ShellRunProgram
ShellVerbOpen=0 Edit=1 Print=2 RunAs=3 Properties=4 Explore=5 Find=6المعلمة verb في ShellRunProgram، التي تقبل أيضًا أي فعل آخر كقيمة Text
LocationTopLeft=0 TopCenter=1 TopRight=2 MiddleLeft=3 MiddleCenter=4 MiddleRight=5 BottomLeft=6 BottomCenter=7 BottomRight=8المعلمة location في UIShowDisplayMessage، التي تقبل أيضًا نقطة شاشة كقيمة Text بالشكل "x,y"
TextAlignLeft=0 Center=1 Right=2UIShowDisplayMessage/UIUpdateDisplayMessage
LockResultAcquired=0 TimedOut=1 Pinned=2تُرجعها UtilityLockAcquire/UtilityLockAcquirePinned
LockStateFree=0 HeldByMe=1 HeldByOther=2 Pinned=3تُرجعها UtilityLockGetState
SerialParityNone=0 Odd=1 Even=2 Mark=3 Space=4SerialOpenPort، SerialMonitorCreate
SerialStopBitsOne=0 OnePointFive=1 Two=2SerialOpenPort، SerialMonitorCreate
DateTimeStyleShortDate=0 LongDate=1 ShortTime=2 LongTime=3 ShortDateTime=4 LongDateTime=5 FileStamp=6DateTimeFormat. تتبع كلها باستثناء FileStamp إعدادات المنطقة في Windows للمستخدم، بالتقويم الخاص بتلك المنطقة؛ أما FileStamp فيكون دائمًا بالشكل 20261001-140509، الذي يُفرز حسب الوقت وآمن في اسم الملف.
DateTimePartYear=0 Month=1 Day=2 Hour=3 Minute=4 Second=5 Weekday=6DateTimeGetPart. ميلادي، بالتوقيت المحلي. 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" خطأ، وليس ضغطًا للمفتاح الأول.

البادئة^+%@
مفتاح التعديلCtrlShiftAltWin

المفتاح حرف أو رقم واحد (بأي حالة أحرف)، أو أحد هذه الأسماء بين أقواس معقوصة، بأي حالة أحرف: {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} و{BACKSPACE} و{BKSP} و{INS}.

أمثلة: "^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} لمفاتيح لوحة الأرقام نفسها. ولعدة مفاتيح في نص واحد، استخدم KeyboardSendKeys، أدناه.

تسلسلات المفاتيح (KeyboardSendKeys)​

تأخذ KeyboardSendKeys تسلسلًا كاملًا بتنسيق SendKeys من Microsoft، مع @ لمفتاح Windows كما سبق، لذا فكل تركيبة مفاتيح هي أيضًا تسلسل.

اكتبيرسل
abcالأحرف، مكتوبة كما هي في أي تخطيط للوحة المفاتيح
^ + % @ قبل مفتاحCtrl أو Shift أو Alt أو Windows مضغوطًا لذلك المفتاح: "^a" هو Ctrl+A
~Enter
{TAB} و{F5} و…مفتاح باسمه، بالأسماء المذكورة أعلاه
{LEFT 5} و{a 3}المفتاح أو الحرف بذلك العدد من المرات، من 1 إلى 1000
+(abc)Shift مضغوطًا لكل مفتاح بين القوسين
{+} {^} {%} {~} {@} {(} {)} {{} {}}ذلك الحرف نفسه

أمثلة: "{TAB 3}^a" Tab ثلاث مرات، ثم Ctrl+A · "^s{ENTER}" Ctrl+S، ثم Enter · "%(fx)" Alt+F، ثم Alt+X · "me{@}example.com~" العنوان، ثم Enter.

يُفحص النص كله قبل ضغط أي مفتاح. وأي خطأ في أي موضع منه، مثل اسم غير معروف بين أقواس معقوصة أو { بلا }، يوقف الإجراء بخطأ يذكر الحرف، ولا يُرسل شيء. والتسلسل 4096 حرفًا و10000 ضغطة مفتاح على الأكثر، مع احتساب التكرارات. وتنتظر كل ضغطة مفتاح المدة المعيَّنة في الإعداد تأخير الكتابة، كما تفعل KeyboardTypeText، إلا أن مفتاح السهم أو Home أو End أو Page Up أو Page Down المكرَّر يُرسل دفعة واحدة.

مع الضغط باستمرار على Ctrl أو Alt أو Shift أو Windows، يكون الحرف اللاتيني أو الرقم أو المسافة هو المفتاح نفسه في كل تخطيط للوحة المفاتيح. وأي حرف آخر يُبحث عنه في تخطيط النافذة الموجودة في المقدمة: "^;" مفتاح مختلف في التخطيط الألماني عنه في التخطيط الأمريكي، والحرف الذي لا يستطيع ذلك التخطيط كتابته مع مفتاح تعديل خطأ.

الحرف بعد مفتاح التعديل هو مفتاحه، كبيرًا كان أم لا: "^A" هو Ctrl+A، مثل "^a". ولضغط Ctrl+Shift+A، اكتب "^+a". تضيف SendKeys من Microsoft المفتاح Shift للحرف الكبير، لذا يكتب الاستيراد من StrokesPlus.net المفتاح Shift نيابةً عنك.

أرسل النص العادي باستخدام KeyboardTypeText، لا KeyboardSendKeys. هنا + ^ % ~ @ ( ) { } أوامر، وليست أحرفًا: "50% off" يضغط Alt+Space، وفي "[email protected]" يُبقي @ مفتاح Windows مضغوطًا للحرف e. والنص الذي لم تكتبه بنفسك، مثل محتوى الحافظة أو متغير، قد يحتوي على أي منها، لذا لا تمرّره أبدًا إلى KeyboardSendKeys.