کنترل ListBox در WPF – آموزش WPF

  • دوشنبه ۱۰ خرداد ۱۴۰۰
  • بازدید ۹۰ نفر

wpf listbox 10391 تصویر

کنترل ListBox در WPF

ListBox کنترلی است که امکان نمایش لیستی از آیتم ها به کاربر را به ما می دهد. کابر می تواند یک یا چند آیتم را از لیست نمایش داده شده انتخاب کند. در تصویر زیر می توانید سلسله مراتب مربوط به ارث بری کنترل ListBox را مشاهده کنید.

wpf listbox 10391 1 تصویر

خاصیت های پر استفاده

در جدول زیر می توانید خاصت های پر استفاده مربوط به ListBox را به همراه توضیح مختصری در مورد هر کدام مشاهده کنید.

ردیف

توضیحات

۱

Background

به منظور گرفتن یا تنظیم یک brush برای رنگ پس زمینه کنترل استفاده می شود (به ارث رسیده از Control).

۲

BorderThickness

به منظور گرفتن یا تنظیم میزان ضخامت border کنترل استفاده می شود (به ارث رسیده از Control).

۳

FontFamily

به منظور گرفتن و یا تنظیم نوع فونت محتوای کنترل استفاده می شود (به ارث رسیده از Control).

۴

FontSize

به منظور گرفتن و یا تنظیم اندازه فونت محتوای کنترل استفاده می شود (به ارث رسیده از Control).

۵

FontStyle

به منظور گرفتن و یا تنظیم استایل فونت محتوای کنترل استفاده می شود (به ارث رسیده از Control).

۶

FontWeight

به منظور گرفتن و یا تنظیم میزان ضخامت فونت استفاده می شود (به ارث رسیده از Control).

۷

Foreground

به منظور گرفتن و یا تنظیم رنگ پیش زمینه (رنگ رویی) استفاده می شود (به ارث رسیده از Control).

۸

GroupStyle

به منظور گرفتن مجموعه از شیء GroupStyle که برای ظاهر هر سطح از گروه بندی ایتم ها استفاده می شود  (به ارث رسیده از ItemsControl).

۹

Height

به منظور گرفتن و یا تنظیم میزان ارتفاع کنترل استفاده می شود (به ارث رسیده از FrameworkElement).

۱۰

HorizontalAlignment

به منظور گرفتن و یا تنظیم تراز افقی کنترل در داخل کنترل والد استفاده می شود (به ارث رسیده از FrameworkElement).

۱۱

IsEnabled

به منظور گرفتن و یا تنظیم وضعیت فعال بودن یا نبودن کنترل استفاده می شود. زمانی که کنترلی غیرفعال باشد، کاربر نمی تواند با آن تعامل کند (به ارث رسیده از Control).

۱۲

Items

به منظور گرفتن مجموعه ای از داده ها که برای تولید محتوای کنترل استفاده می شوند، کاربرد دارد (به ارث رسیده از ItemsControl).

۱۳

ItemSource

به منظور گرفتن یا تنظیم یک شیء به عنوان منبع داده برای تولید محتوای ItemsControl استفاده می شود (به ارث رسیده از ItemsControl).

۱۴

Margin

میزان فاصله بیرونی کنترل را مشخص می کند (به ارث رسیده از FrameworkElement).

۱۵

Name

به منظور گرفتن یا تنظیم یک نام شناسایی برای کنترل استفاده می شود. زمانی که پردازنده XAML درخت اشیاء را ایجاد می کند، کد Run-time می تواند با استفاده از نام یک کنترل به آن ارجاع دهد (به ارث رسیده از FrameworkElement).

۱۶

Opacity

میزان شفافیت کنترل را مشخص می کند. مقدار قابل قبول باید بین ۰٫۰ تا ۱٫۰ باشد (به ارث رسیده از UIElement).

۱۷

SelectedIndex

به منظور گرفتن و یا تنظیم اندیس مربوط به آیتم انتخاب شده استفاده می شود (به ارث رسیده از Selector).

۱۸

SelectedItem

به منظور گرفتن و یا تنظیم آیتم انتخاب شده استفاده می شود (به ارث رسیده از Selector).

۱۹

SelectedValue

به منظور گرفتن یا تنظیم مقدار انتخاب شده با استفاده از SelectedValuePath استفاده می شود (به ارث رسیده از Selector).

۲۰

Style

استایل مربوط به کنترل را تنظیم می کند (به ارث رسیده از FrameworkElement).

۲۱

VerticalAlignment

تراز عمودی کنترل را در داخل کنترل والد مشخص می کند (به ارث رسیده از FrameworkElement).

۲۲

Width

به منظور گرفتن و یا تنظیم میزان عرض کنترل استفاده می شود (به ارث رسیده از FrameworkElement).

رویدادهای پر استفاده

در جدول زیر می توانید رویدادهای پر استفاده مربوط به کنترل ListBox را به همراه توضیح مختصری در مورد هر کدام مشاهده کنید.

ردیف

توضیحات

۱

DragEnter

زمانی که سیستم ورودی یک رویداد drag که هدفش این کنترل است را گزارش دهد، این رویداد رخ می دهد (به ارث رسیده از UIElement).

۲

DragLeave

زمانی که سیستم ورودی یک رویداد drag که منشاء آن این کنترل است را گزارش دهد، این رویداد رخ می دهد (به ارث رسیده از UIElement).

۳

DragOver

زمانی که سیستم ورودی یک رویداد drag را با این کنترل به عنوان هدف drop شدن، گزارش دهد، این رویداد رخ می دهد (به ارث رسیده از UIElement).

۴

DragStarting

زمانی که عملیات drag کردن شروع شود، این رویداد رخ می دهد (به ارث رسیده از UIElement).

۵

KeyDown

زمانی که یک کلید از کیبورد فشار داده شود و فوکوس جاری بر روی کنترل باشد، این رویداد رخ می دهد (به ارث رسیده از UIElement).

۶

KeyUp

زمانی که کلید فشار داده شده رها شود و فوکوس جاری بر روی کنترل باشد، این رویداد رخ می دهد (به ارث رسیده از UIElement).

۷

SelectionChanged

زمانی که آیتم انتخاب شده تغییر کند، رخ می دهد (به ارث رسیده از Selector).

مثال

برای درک بهتر یک پروژه WPF با نام WPFListBoxControl ایجاد کرده و آن را به شکل زیر تغییر دهید. کدهای XAML مربوط به MainWindow.xaml:

زمانی که مثال فوق را کامپایل و اجرا کنید، خروجی زیر را تولید خواهد کرد:

wpf listbox 10391 2 تصویر

هنگامی که کاربر آیتمی را از لیست انتخاب کند، مقدار آن در TextBox کناری نمایش داده خواهد شد.

ثبت نظر
ریفریش کنید!
نظرات کاربران (۰ مورد)

هیچ نظری ثبت نشده است