کادر فهرست

کادر فهرست

کادر فهرست
شی فرم List Box ( ) یک جعبه لیست را نشان می دهد . اگر از یک لیست به عنوان منبع استفاده می کنید، می توانید با استفاده از Shift-click یا Ctrl-click بیش از یک مورد را در لیست انتخاب کنید. برای سایر منابع، فقط می توانید یک مقدار را از لیست انتخاب کنید. نام شی جعبه لیست را در قسمت Name وارد کنید .
پنجره تنظیمات شامل بخش های زیر است.
منبع
در این قسمت منبع داده را برای لیست باکس تعریف می کنید. این بخش شامل یک درخت با نمای فیلتر شده از درختان در پنجره های Application Builder و Model Builder است. گره ها یا نوعی از داده ها را نشان می دهند یا فرزندانی دارند که این کار را انجام می دهند. برای یک لیست، درخت شامل متغیرها و پارامترهایی در مدل و متغیرها است، مانند یک آرایه 1 بعدی که در قسمت Declarations اضافه کرده‌اید ، از جمله گره‌های مجموعه واحد . می‌توانید فهرست گره‌های داده موجود را با کلیک کردن روی دکمه Switch to Model Builder و Activate Data Access ( ) در سرصفحه بخش Source ، که شما را به Model Builder می‌برد و سپس انتخاب یک گره درشعبه Model Builder که می خواهید به داده های آن دسترسی داشته باشید. با فعال بودن این دکمه، پنجره تنظیمات گره انتخاب شده یک کادر انتخاب منبع داده (یک مربع سبز رنگ) را در کنار تنظیماتی که می توانید وارد کنید نمایش می دهد. کلیک کنید تا چک باکس را انتخاب کنید تا داده ها به عنوان یک گره منبع موجود برای جعبه های فهرست قرار گیرند.
هنگامی که گره ای را انتخاب می کنید که نشان دهنده داده باشد، دکمه Use as Source نوار ابزار ( ) در زیر درخت فعال می شود. می‌توانید روی آن کلیک کنید یا، Enter را فشار دهید، دوبار کلیک کنید، یا روی گره راست کلیک کنید و Use as Source را انتخاب کنید تا آن را به عنوان منبع انتخابی اضافه کنید. همچنین می توانید روی دکمه Create New Declaration and Use It as Source ( ) یا Create New Form Declaration and Use It as Source ( ) در سربرگ بخش Source کلیک کنید تا یک اعلان متغیر جهانی جدید (به شکل) ایجاد کنید. باکس لیست و از آن به عنوان منبع استفاده کنید. اعلامیه ایجاد و استفادهکادر محاوره ای باز می شود تا بتوانید نوع داده منبع (در صورت وجود)، نام و مقدار اولیه آن (در صورت وجود) را انتخاب کنید. نام نمی تواند با هیچ اعلان متغیر موجود در تضاد باشد. روی دکمه ویرایش گره نوار ابزار ( ) در زیر درخت کلیک کنید تا به گره مربوطه بروید. در صورت لزوم، برنامه به Model Builder سوئیچ می کند.
پس از انتخاب یک گره به عنوان منبع، گره به عنوان منبع انتخاب شده در زیر منبع انتخاب شده ظاهر می شود .
 
اگر سعی کنید از یک منبع داده در چندین شیء استفاده کنید، ممکن است با عوارض جانبی عجیبی روبرو شوید. مقدار اولیه منبع ممکن است آن چیزی نباشد که شما انتظار دارید. همچنین اگر مقدار اولیه یک شی فرم برای یکی از اشیاء فرم دیگر نامعتبر باشد، ممکن است با خطاهای جدی مواجه شوید.
در لیست مقدار اولیه ، روشی را برای تعریف مقدار اولیه برای کادر فهرست انتخاب کنید. گزینه ها اولین مقدار مجاز هستند . از منبع داده (به طور پیش فرض، برای استفاده از مقدار مشخص شده توسط منبع داده انتخاب شده)؛ و ارزش سفارشی برای گزینه مقدار سفارشی ، یک لیست Value مقادیر مجاز موجود در حال حاضر برای شی فرم را نشان می دهد که به لیست های انتخابی موجود و مقادیر آنها بستگی دارد. اگر منبع داده تنظیمی از مدل تعبیه شده است که دارای لیستی از مقادیر مجاز است، آن مقادیر نیز در مقدار گنجانده می شود.فهرست برای مثال، اگر یک مقدار اولیه انتخاب شده نامعتبر شود زیرا از لیست انتخاب حذف شده است، به عنوان یک مقدار اولیه با متن مقدار اولیه نامعتبر و به دنبال آن مقدار نگهداری می شود.
هنگامی که منبع داده یک آرایه رشته ای است، لیست مقدار اولیه به همراه گزینه آرایه خالی وجود دارد که یک آرایه خالی را به عنوان پیش فرض برای منبع انتخاب شده تنظیم می کند. همچنین گزینه های اضافی برای نحوه انتخاب مقادیر وجود دارد. از فهرست انتخاب مقادیر در فهرست، گزینه Dialog را انتخاب کنید تا از یک گفتگو برای نمایش کادر فهرست استفاده کنید و عنوان گفتگو را در فیلد زیر وارد کنید، یا برای استفاده از کادر فهرست چند انتخابی، فهرست کادر را انتخاب کنید. گفتگو _گزینه از لیستی با دکمه های زیر استفاده می کند که کاربران می توانند از آن برای افزودن، حذف و جابجایی موارد در لیست موارد انتخاب شده استفاده کنند. این برای لیستی با موارد بسیار مناسب است که می‌خواهید بهتر کنترل کنید کدام آیتم‌ها انتخاب شده‌اند (در مقایسه با یک فهرست استاندارد چند انتخابی).
لیست انتخاب
در لیست انتخاب شده، گره‌های فهرست انتخابی را اضافه کنید که مقادیر مجاز را به کادر فهرست اضافه می‌کنند. اگر منبع داده انتخابی یک لیست با مجموعه ای از مقادیر مجاز باشد، تنها زیر مجموعه ای از مقادیر می توانند در مقادیر مجاز کادر فهرست ظاهر شوند. تمام مقادیر دیگر در لیست های انتخابی انتخاب شده نادیده گرفته می شوند. گره‌های فهرست انتخاب موجود در زیر در دسترس ظاهر می‌شوند . روی دکمه افزودن انتخاب شده  کلیک کنید تا گره انتخابی فهرست انتخابی را به لیست زیر انتخاب شده اضافه کنید یا روی دکمه حذف انتخاب شده  کلیک کنید تا یک گره فهرست انتخابی انتخاب شده از لیست زیر انتخاب شده حذف شود. همچنین می توانید روی a دوبار کلیک کنیدگره فهرست انتخاب برای انتقال آن از موجود به انتخاب شده و برعکس. روی دکمه افزودن فهرست انتخاب جدید ( ) یا افزودن فهرست انتخاب فرم جدید ( ) در نوار ابزار قسمت انتخاب فهرست کلیک کنید تا یک لیست انتخاب یا پنجره فهرست انتخاب فرم باز شود که در آن می توانید یک لیست انتخاب جدید در زیر گره اعلامیه های جهانی یا یک اعلامیه های محلی تعریف کنید. گره زیر گره Form به ترتیب. مقادیر مجاز را در ستون Value و نام های مربوط به آنها را در ستون Display name اضافه کنید. کلیکبرای اضافه کردن لیست انتخاب جدید به عنوان یک گره فهرست انتخاب ( ) در زیر Declarations و مستقیماً در Selected .
اگر در قسمت Source یک ویژگی را انتخاب کنید که دارای لیستی از مقادیر مجاز است، آن ویژگی به گره ای تبدیل می شود که ابتدا در لیست انتخاب شده قرار می گیرد . می‌توانید آن را به فهرست موجود منتقل کنید و بدین ترتیب فهرست مقادیر مجاز را پاک کنید. می‌توانید آن را دوباره به عقب برگردانید یا یک لیست انتخاب سفارشی با مقادیری اضافه کنید که به لیست مقادیر مربوط به ویژگی نیز تعلق دارند. اگر لیست ویژگی و یک گره لیست انتخاب هر دو در لیست انتخاب شده باشند، ادغام می شوند. مقادیر یکسان توضیحات را از اولین مورد در لیست در زیر انتخاب شده انتخاب می کنند. به این ترتیب می توانید نام یکی از موارد موجود در لیست اموال را تغییر دهید. اگر تصمیم دارید منبع را به ویژگی دیگری در مدل تعبیه شده تغییر دهید که دارای لیستی از مقادیر مجاز است، گره لیست ویژگی قبلی از هر دو لیست موجود و انتخاب شده حذف می شود و گره جدید به لیست انتخاب شده اضافه می شود.
موقعیت و اندازه
این بخش شامل تمام تنظیمات طرح بندی برای یک لیست باکس در شبکه فرم والد است.
در حالت شبکه، می‌توانید تراز افقی و عمودی کادر فهرست را با استفاده از لیست‌های زیر کنترل کنید:
از لیست تراز افقی ، چپ ، مرکز ، راست یا پر را انتخاب کنید ، که به طور خودکار شی فرم را گسترش می دهد تا سلول را در جهت افقی یا عمودی پر کند (در صورت لزوم).
از لیست تراز عمودی ، میانی ، بالا ، پایین یا پر را انتخاب کنید ، که به طور خودکار شی فرم را برای پر کردن سلول در جهت افقی یا عمودی (در صورت لزوم) گسترش می دهد.
نیاز به تعیین تراز هنگام کار در حالت شبکه آشکارتر است، زیرا نحوه تراز شدن شی فرم در سلول شبکه خود را کنترل می کند. تراز کردن شی فرم می تواند در حالت طرح نیز مفید باشد. سپس می توانید از ابزارهای تراز در منوی Arrange در بخش Sketch نوار ابزار Form استفاده کنید. هنگام اجرای برنامه در هر کلاینت دیگری غیر از کلاینت ویندوز، ممکن است اشیاء فرم دقیقاً همانطور که در پنجره های فرم دیده می شود قرار نگیرند. این به این دلیل است که اشیاء فرم ممکن است در سایر کلاینت‌ها اندازه متفاوتی داشته باشند و موقعیت کمی متفاوت به آنها بدهد. تعیین تراز تضمین می کند که اشیاء فرم همانطور که می خواهید در همه کلاینت ها تراز شوند.
همچنین می توانید عرض و ارتفاع کادر لیست را مشخص کنید. در قسمت Width یک عرض (بر حسب نقطه) و در قسمت Height یک ارتفاع (به نقطه) وارد کنید . اگر از لیست تراز افقی Fill را انتخاب کرده اید ، می توانید در عوض حداقل عرض را تعیین کنید . برای محاسبه حداقل عرض به صورت خودکار، Automatic را انتخاب کنید (معمولاً این به معنای حداقل اندازه 0 است) یا دستی را انتخاب کنید تا حداقل عرض را در قسمت متن زیر مشخص کنید. اگر Fill را از لیست تراز عمودی انتخاب کرده اید، می توانید در عوض حداقل ارتفاع را تعیین کنید . خودکار را انتخاب کنیدبرای محاسبه حداقل ارتفاع به صورت خودکار (معمولاً این به معنای حداقل اندازه 0 است) یا دستی را انتخاب کنید تا حداقل ارتفاع را در قسمت متن زیر مشخص کنید.
علاوه بر این، در حالت طرح، می توانید موقعیت مطلق کادر فهرست را با استفاده از فیلدهای Position x و Position y مشخص کنید. در حالت شبکه، می‌توانید شی را در شبکه قرار دهید و موقعیت شبکه را به‌عنوان مقادیر Row ، Column ، Row span و Column span ببینید.
 
پنجره های فرم این تنظیمات اندازه و موقعیت یابی را از طریق عملیات ترسیمی که در آنجا انجام می شود، مانند تغییر اندازه و جابجایی شی به روز می کنند.
حاشیه سلول
در قسمت حاشیه سلول (فقط در حالت شبکه)، می توانید حاشیه های اطراف شی فرم را کنترل کنید. به طور پیش فرض، حاشیه ها از فرم والد گرفته می شوند. از لیست حاشیه سلول ، انتخاب کنید:
هیچ ، بدون حاشیه در اطراف شی فرم
از فرم والد (پیش فرض)، برای استفاده از حاشیه های تنظیم شده برای فرم والد
سفارشی ، برای تعیین حاشیه برای شی فرم درفیلدهای متنی افقی و عمودی
ظاهر
در این قسمت می توانید ظاهر متن را در کادر لیست کنترل کنید.
از لیست رنگ متن ، رنگی را برای استفاده برای متن انتخاب کنید: ارث بری (پیش‌فرض؛ شی فرم سپس از تنظیمات فرمی که در آن قرار دارد استفاده می‌کند)، هر یک از رنگ‌های اصلی از پیش تعریف‌شده، یا سفارشی ، که این امکان را فراهم می‌کند. برای انتخاب یک رنگ سفارشی از یک پالت رنگ.
فونت و اندازه فونت متن به طور پیش فرض از تنظیمات فونت گره Forms استفاده می کند. یک فونت را از لیست فونت انتخاب کنید: فونت پیش‌فرض یا هر یک از فونت‌های موجود. در صورت نیاز، اندازه قلم (به واحد) را در کادر ترکیبی اندازه قلم انتخاب یا وارد کنید. اندازه فونت پیش فرض اندازه پیش فرض است .
همچنین می‌توانید کادر Bold را برای استفاده از فونت پررنگ یا کادر Italic را برای استفاده از حروف کج (یک فونت ایتالیک) انتخاب کنید.
در بخش State ، می‌توانید وضعیت اولیه کادر فهرست را زمانی که کاربران برنامه را اجرا می‌کنند، کنترل کنید. به طور پیش فرض، کادر لیست قابل مشاهده و فعال است. اگر می‌خواهید حالت اولیه را ایجاد کنید تا کادر فهرست پنهان یا در دسترس نباشد، کادر بررسی Visible یا Enabled را پاک کنید. سپس می توانید آن را قابل مشاهده کنید یا با استفاده از یک روش آن را فعال کنید. در ویرایشگر فرم، وضعیت شی فرم با تغییر در ظاهر آن نشان داده می شود. اشیایی که پنهان هستند با انتخاب در ویرایشگر فرم قابل مشاهده می شوند.
مناسبت ها
شما می توانید یک روش یا دنباله دستوری را مشخص کنید که برنامه زمانی که داده های کادر لیست تغییر می کند اجرا کند. فهرست تغییر داده‌های On شامل None (پیش‌فرض) و هر روش یا ترتیب دستوری موجود است. می‌توانید انواع رویدادهای زیر را با انتخاب از منوی Create Global Method ( ) در سمت راست لیست On data change اضافه کنید:
برای ایجاد یک متد جهانی، Create Global Method ( ) را انتخاب کنید. نام متد جهانی را در قسمت نام کادر محاوره ای Create Global Method که باز می شود تایپ کنید و سپس روی OK کلیک کنید . سپس متد جهانی در زیر Methods اضافه می شود و پنجره Method Editor آن باز می شود.
برای ایجاد روش فرم، Create Form Method ( ) را انتخاب کنید. نام روش فرم را در قسمت نام کادر محاوره ای Create Form Method که باز می شود تایپ کنید و سپس روی OK کلیک کنید . سپس متد فرم در زیر گره Methods در زیر گره Form اضافه می شود و پنجره Method Editor آن باز می شود.
برای ایجاد یک متد محلی، Create Local Method ( ) را انتخاب کنید. پنجره ویرایشگر روش آن باز می شود.
برای ایجاد یک توالی دستورات با استفاده از کادر محاوره ای Create Command Sequence که باز می شود، Create Command Sequence ( ) را انتخاب کنید . در آنجا می‌توانید دستورات را از پوشه‌های Forms ، GUI Commands ، Declarations ، Form Declarations ، Methods ، Form Methods ، Libraries و Model انتخاب کنید. برای افزودن یک دستور، روی گره فرمان مورد نظر کلیک راست کرده و دستور مورد استفاده ( Run ) را انتخاب کنید، مثلا). سپس دستور در لیست دستورات زیر ظاهر می شود. شما می توانید دنباله دستورات را با استفاده از دکمه های نوار ابزار برای جابجایی و حذف دستورات زیر جدول ویرایش کنید. روی دکمه Convert to Method ( ) کلیک کنید و Convert to Method یا Convert to Form Method را انتخاب کنید تا دنباله دستور به متد تبدیل شود. روی دکمه Go to Method ( ) در زیر جدول کلیک کنید تا روش را در درخت Application Builder انتخاب کنید و روش را در پنجره Method Editor باز کنید. برای دستوراتی که دارای آرگومان هستند، روی دکمه Edit Argument ( ) کلیک کنید تا در کادر گفتگوی Edit Argument که باز می شود، آرگومان انتخاب شود.
فقط یک روش محلی و یک دنباله دستور وجود دارد، بنابراین اگر یکی یا هر دوی آنها را اضافه کنید، منو به ترتیب حاوی Remove Local Method ( ) و Remove Command Sequence ( ) خواهد بود. روی یکی از آنها کلیک کنید تا متد محلی یا دنباله دستور حذف شود.
روش انتخاب شده در لیست On data change سپس به روش ایجاد شده یا دنباله دستور تغییر می کند. همچنین می‌توانید روی شی جعبه فهرست Ctrl+Alt کلیک کنید یا روی آن کلیک راست کنید تا یک متد محلی ایجاد کنید یا (با انتخاب روش ویرایش یا ویرایش روش محلی ) متد مرتبط با دستور را باز کنید. برای باز کردن متد یا دنباله دستور انتخاب شده، روی دکمه Go to Source ( ) کلیک کنید. سپس فوکوس به ترتیب به پنجره ویرایشگر روش یا کادر محاوره‌ای Command Sequence منتقل می‌شود.
برای رویدادهایی که با تغییر داده ایجاد می شوند، رویداد پس از ذخیره مقدار داده جدید در منبع داده فعال می شود.
 
اگر بیش از یک شی فرم را انتخاب کنید و همه آنها از رویداد On data change پشتیبانی می کنند، می توانید روشی را مشخص کنید تا مثلاً آنها را به اطلاع کاربران مبنی بر نامعتبر بودن نمودارها و خروجی ها برسانید.