توضیحات تکمیلی و نحوه استفاده :
FindSkin اسکریپتی است کارش مشخص کردن مسیر $skin است تا تصاویر چک باکس رو بشه فراخوانی کرد.
قبل از هر چیز بایستی اسکریپ FindSkin اجرا بشه تا مسیر $skin روی پوشه Skin تنظیم بشه. می توانید بجای
اجرا کردن FindSkin خودتون مقدار $skin رو روی پوشه مورد نظر تنظیم کنید. پیشنهاد ام اینه که اینکار همانند خود
پروژه پیوستی در اسکریپ Page Start انجام بشه :
CheckHover اسکریپتی است که هر 50 میلی ثانیه یکبار بررسی می کنه که آیا ماوس روی یکی از چک باکس ها
قرار گرفته یا نه. و بر اساس این بررسی رخداد های Enter و Leave و Up چک باکس ها رو فراخوانی می کنه. چون اجرا شدن
این رخداد برای نمایش صحیح چک باکس ها لازمه، حتما در همون ابتدای اجرا پروژه فراخوانی اش کنید :
CreateCheckbox رو زمانی فراخوانی کنید که بخواهید یک چک باکس روی Page تون بسازید و قرار بدهید.
قبل از فراخوانی اش حتما مقادیر زیر رو مشخص کنید :
$checkboxName نام چک باکس شما خواهد بود، مثلا MyCheckbox1 ، از بکار بردن نام های تکراری برای چندین
چک باکس بپرهیزید.
$checkboxText عنوان نمایشی چک باکس شما است، مثلا Sample
$checkboxState وضعیت چک باکس شما است، که باید enabled و یا disabled باشد.
checkboxValue مقدار تیک چک باکس است که یکی از اعداد 0 و 1 و 2 می باشد، 0 برای تیک نخورده، 1 برای تیک خورده و 2 برای نیمه تیک خورده
checkboxLeft موقعیت افقی x چک باکس شما روی صفحه است، مثلا 20
checkboxTop موقعیت عمودی y چک باکس شما روی صفحه است، مثلا 50
rightToLeft چپ به راست و یا راست به چپ بودن چک باکس را تعیین می کند. 0 برای چپ به راست و 1 برای راست به چپ
طول و عرض چک باکس بصورت خودکار با توجه به طول عنوان نمایشی تعیین خواهند شد.
بعد از مشخص کردن مقادیر بالا چک باکس را با فراخوانی کردن CreateCheckbox می سازید :
کد:
checkboxName$ = 'MyCheckbox1'
checkboxState$ = 'enabled'
checkboxText$ = 'Sample'
checkboxValue = 0
checkboxLeft = 20
checkboxTop = 50
rightToLeft = 0
RunScript("CreateCheckbox")
DeleteCheckbox چک باکس مورد نظر رو حذف خواهد کرد. قبل از فراخوانی اش، مقدار $checkboxName رو مشخص کنید :
کد:
checkboxName$ = 'MyCheckbox1'
RunScript("DeleteCheckbox")
GetCheckboxText عنوان نمایشی چک باکس را بر می گرداند، شما مقدار $checkboxName رو قبل از فراخوانی اش
مشخص کنید تا بعد از فراخوانی اش مقدار $checkboxText را تنظیم کند :
کد:
checkboxName$ = 'MyCheckbox1'
RunScript("GetCheckboxText")
SetCheckboxText می تواند عنوان نمایشی یک چک باکس را تغییر دهد، شما مقدار $checkboxName و $checkboxText را
قبل از فراخوانی اش مشخص کنید :
کد:
checkboxName$ = 'MyCheckbox1'
checkboxText$ = 'Sample'
RunScript("SetCheckboxText")
GetCheckboxState وضعیت چک باکس (enabled / disabled) را بر می گرداند. شما مقدار $checkboxName رو قبل از
فراخوانی اش مشخص کنید تا بعد از فراخوانی اش مقدار $checkboxState را تنظیم کند :
کد:
checkboxName$ = 'MyCheckbox1'
RunScript("GetCheckboxState")
SetCheckboxState وضعیت چک باکس (enabled / disabled) را تغییر می دهد. شما مقدار $checkboxName و همچنین
$checkboxState رو قبل از فراخوانی اش مشخص کنید :
کد:
checkboxName$ = 'MyCheckbox1'
checkboxState$ = 'disabled'
RunScript("SetCheckboxState")
GetCheckboxValue وضعیت تیک چک باکس (0 یا 1 یا 2) را بر می گرداند. شما مقدار $checkboxName رو قبل از
فراخوانی اش مشخص کنید تا بعد از فراخوانی اش مقدار checkboxValue را تنظیم کند :
کد:
checkboxName$ = 'MyCheckbox1'
RunScript("GetCheckboxValue")
SetCheckboxValue وضعیت تیک چک باکس (0 یا 1 یا 2) را تغییر می دهد. شما مقدار $checkboxName و همچنین
checkboxValue رو قبل از فراخوانی اش مشخص کنید :
کد:
checkboxName$ = 'MyCheckbox1'
checkboxValue = 1
RunScript("SetCheckboxValue")
GetCheckboxPos موقعیت و طول و عرض چک باکس را بر می گرداند. شما مقدار $checkboxName رو قبل از
فراخوانی اش مشخص کنید تا بعد از فراخوانی اش مقدار checkboxLeft و checkboxTop و checkboxWidth و checkboxHeight
را تنظیم کند :
کد:
checkboxName$ = 'MyCheckbox1'
RunScript("GetCheckboxPos")
MoveCheckbox موقعیت (x و y) چک باکس را تغییر می دهد، بدون آنکه در ابعاد آن تغییری ایجاد کند. شما مقدار
$checkboxName و checkboxLeft و checkboxTop رو قبل از فراخوانی اش مشخص کنید :
کد:
checkboxName$ = 'MyCheckbox1'
checkboxLeft = 20
checkboxTop = 50
RunScript("MoveCheckbox")
GetRightToLeft وضعیت راست به چپ چک باکس (0 یا 1) را بر می گرداند. شما مقدار $checkboxName رو قبل از
فراخوانی اش مشخص کنید تا بعد از فراخوانی اش مقدار rightToLeft را تنظیم کند :
کد:
checkboxName$ = 'MyCheckbox1'
RunScript("GetRightToLeft")
SetRightToLeft وضعیت راست به چپ چک باکس (0 یا 1) را تغییر می دهد. شما مقدار $checkboxName و همچنین
rightToLeft رو قبل از فراخوانی اش مشخص کنید :
کد:
checkboxName$ = 'MyCheckbox1'
rightToLeft = 1
RunScript("SetRightToLeft")
ShowCheckbox همانند دستور Show برای خارج کردن یک چک باکس از حالت پنهان بکار می رود. شما مقدار $checkboxName
رو قبل از فراخوانی اش مشخص کنید :
کد:
checkboxName$ = 'MyCheckbox1'
RunScript("ShowCheckbox")
HideCheckbox همانند دستور Hide برای پنهان کردن یک چک باکس بکار می رود. شما مقدار $checkboxName رو قبل از
فراخوانی اش مشخص کنید :
کد:
checkboxName$ = 'MyCheckbox1'
RunScript("HideCheckbox")
InvertCheckbox همانند دستور Invert برای آشکار / پنهان کردن یک چک باکس بکار می رود. شما مقدار $checkboxName رو قبل از
فراخوانی اش مشخص کنید :
کد:
checkboxName$ = 'MyCheckbox1'
RunScript("InvertCheckbox")
رخداد
CheckboxClick رو شما فراخوانی نمی کنید، بلکه داخلش اش هر کدی که خواستید بنویسید تا زمانی که روی
یک چک باکس کلیک شد و وضعیت تیک اش تغییر کرد اجرا گردد. نام چک باکس فشرده شده توسط $checkboxName در دسترس شما است.
به بقیه رخداد ها یعنی
CheckboxDown و
CheckboxUp و
CheckboxEnter و
CheckboxLeave کاری ندارید،
مگر اینکه بدانید چه چیزی را تغییر می دهید. این رخداد ها بصورت خودکار فراخوانی می شوند.
FindCheckbox برای پیدا کردن نام یک چک باکس در میان چک باکس ها فراخوانی می شود. شما اصولا کاری با آن ندارید.
متغیر
checkboxCount همواره تعداد چک باکس های ساخته شده را نشان می دهد. به هیچ وجه مقدار اش را تغییر ندهید.
$checkboxNames یک آرایه است که نام چک باکس ها در آن نوشته شده، مثلا [2]$checkboxNames نام دومین چک باکس است.
به هیچ وجه مقادیر این آرایه را تغییر ندهید.
$checkboxTexts یک آرایه است که عنوان نمایشی چک باکس ها در آن نوشته شده، مثلا [2]$checkboxTexts عنوان دومین
چک باکس است. به هیچ وجه مقادیر این آرایه را بصورت دستی تغییر ندهید، فقط از SetCheckboxText استفاده کنید.
$checkboxStates یک آرایه است که وضعیت enabled / disabled چک باکس ها در آن نوشته شده، مثلا [2]$checkboxStates وضعیت دومین
چک باکس است. به هیچ وجه مقادیر این آرایه را بصورت دستی تغییر ندهید، فقط از SetCheckboxState استفاده کنید.
checkboxValues یک آرایه است که وضعیت تیک چک باکس ها در آن نوشته شده، مثلا [2]checkboxValues وضعیت تیک دومین
چک باکس است. به هیچ وجه مقادیر این آرایه را بصورت دستی تغییر ندهید، فقط از SetCheckboxValue استفاده کنید.
checkboxRightToLefts یک آرایه است که وضعیت چپ به راست چک باکس ها در آن نوشته شده، مثلا [2]checkboxRightToLefts وضعیت چپ به راست دومین
چک باکس است. به هیچ وجه مقادیر این آرایه را بصورت دستی تغییر ندهید، فقط از SetRightToLeft استفاده کنید.
دیگه سفارش نکنم، در رو روی غریبه باز نکنید، به شیر گاز دست نزنید و بچه های خوبی باشید.
نکات قابل توجه :
- طول و عرض چک باکس بر اساس ابعاد عنوان نمایشی اش تعیین می شود، بدون آنکه در موقعیت x و y چک باکس تغییری رخ دهد.
- هر چک باکس از 2 جزء گرافیکی HotSpot و یک Text تشکیل شده، یعنی جمعا هر چک باکس 3 تیکه کنار هم است.
- برای ترکیب کردن این آموزش با آموزش های دیگر عجله نکنید، در آینده کد مجموعه این آموزش ها بصورت مناسبی با هم ادغام خواهند شد.
