کنترل ListAndForm

کنترل ListAndForm مناسب برای پیاده سازی نمایش های تعاملی Master-Detail  در داخل Power Form است، زیرا این کار به شما کمک می کند تا فرم های جزئی کاملا کاربردی را درون یک فرم اصلی ایجاد کنید. این فیلد شامل ۲ کنترل است، یک دیتاگرید و یک Sub form

List Query

یک query list از پیش تعریف شده به مقدار کنترل وصل می شود. بنابراین در حین فرم اولیه، کوئری لیست مشخص شده اجرا می شود و اگر هر یک از آیتم ها را بازگرداند، اولین آن را انتخاب می کند:

Extra Configuration

Filters
نام های داخل ستون را برای فیلدهای لیستی که باید توسط (مثلا شناسه، عنوان) فیلتر شوند، اضافه کنید.
ShowFilter
کنترل فیلتر را نشان می دهد یا مخفی می کند.
ShowGrid
جدول لیست Details را نشان می دهد یا پنهان می کند.
AutoSelectFirst
به صورت خودکار رکورد اول را انتخاب می کند (اگر وجود داشته باشد)
ContentType
نوع محتوای فرم را تعریف کنید.
GridHeight
ارتفاع جدول را تعریف کنید.
AfterUpdateScript
پس از به روز رسانی یک آیتم، اسکریپت اجرا می شود .
DataLoadedScript
شما می توانید یک اسکریپت بنویسید که در زمان بارگذاری داده ها در داخل جدول، اجرا شود (زمانی که کنترل به لیست Query متصل باشد.). از متغیر ‘item’ می توانید استفاده کنید که حاوی موارد بازیابی شده است.

for (var i=0; i < items.length; i++) { items[i].KPILookup = GetNameFromLookup(items[i].KPILookup); }

Properties

Name: نام فیلد. این باید با یک حرف شروع شود و تنها حاوی حروف، اعداد و کارکترهای underscore  باشد

Header: عنوان فیلد

Width: عرض ستون جدول را مشخص میکند. اگر خالی بگذارید به طور خودکار عرض همه ی ستون ها را مساوی در نظر میگیرد.

ForeColor : رنگ پیش زمینه سلول

FontBold :  پررنگ بودن متن

FontSize: اندازه قلم مورد استفاده

HAlign : تراز افقی متن را تنظیم می کند. مقادیر ممکن: – (پیش فرض)، چپ، راست، مرکز

Default Values
اضافه کردن Name/Value  به منظور به روز رسانی ویژگی های آیتم ها یی است که کنترل آن به یک لیست متصل شده است. مقادیر می توانند به صورت ایستا یا محاسبه ای باشند. (به طور مثال:  Name=Priority ، Value=High یا Name=Customer ، Value={value:c_ID}..) شما می توانید از {ParentID} استفاده کنید؛ کلمه کلیدی برای مشخصه مقدار برای تنظیم ID  و شناسه ی آیتم اصلی(حتی اگر هنوز ذخیره نشده است).

Properties

Name : نام ستون را وارد کنید

Value: مقدار پیش فرض ستون را وارد کنید. یا مقادیر استاتیک یا مقادیر محاسبه شده را بر اساس کنترلهای فرم تنظیم کنید (به عنوان مثال {value: Field1}). شما می توانید از کلمه کلیدی {ParentID} برای مشخصه مقدار استفاده کنید تا شناسه اسناد والد را تنظیم کنید (حتی اگر هنوز ذخیره نشده باشد).

Script

کد اسکریپت که در حالت value-change کنترل اجرا می شود، تعیین می کند.

مثال :

var value = form.GetControl(“c_Title”).GetValue(); if (value == “تکمیل شده”) form.HideSection(“Details”); else form.ShowSection(“Details”);

اطلاعات بیشتر در :

http://www.bpc-components.com/pages/sharepoint/power-forms-html/kb/api/list-and-form