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

دوشنبه ۱۰ خرداد ۱۴۰۰
بازدید ۹۷۱ نفر
سعید سیفی زاده
(5 امتیاز از 1 رای)
Loading...

تصویر wpf-listbox_10391 کنترل ListBox در WPF - آموزش WPF

کنترل ListBox در WPF

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

تصویر wpf-listbox_10391_1 کنترل ListBox در WPF - آموزش WPF

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

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

ردیف	توضیحات
1	Background به منظور گرفتن یا تنظیم یک brush برای رنگ پس زمینه کنترل استفاده می شود (به ارث رسیده از Control).
2	BorderThickness به منظور گرفتن یا تنظیم میزان ضخامت border کنترل استفاده می شود (به ارث رسیده از Control).
3	FontFamily به منظور گرفتن و یا تنظیم نوع فونت محتوای کنترل استفاده می شود (به ارث رسیده از Control).
4	FontSize به منظور گرفتن و یا تنظیم اندازه فونت محتوای کنترل استفاده می شود (به ارث رسیده از Control).
5	FontStyle به منظور گرفتن و یا تنظیم استایل فونت محتوای کنترل استفاده می شود (به ارث رسیده از Control).
6	FontWeight به منظور گرفتن و یا تنظیم میزان ضخامت فونت استفاده می شود (به ارث رسیده از Control).
7	Foreground به منظور گرفتن و یا تنظیم رنگ پیش زمینه (رنگ رویی) استفاده می شود (به ارث رسیده از Control).
8	GroupStyle به منظور گرفتن مجموعه از شیء GroupStyle که برای ظاهر هر سطح از گروه بندی ایتم ها استفاده می شود (به ارث رسیده از ItemsControl).
9	Height به منظور گرفتن و یا تنظیم میزان ارتفاع کنترل استفاده می شود (به ارث رسیده از FrameworkElement).
10	HorizontalAlignment به منظور گرفتن و یا تنظیم تراز افقی کنترل در داخل کنترل والد استفاده می شود (به ارث رسیده از FrameworkElement).
11	IsEnabled به منظور گرفتن و یا تنظیم وضعیت فعال بودن یا نبودن کنترل استفاده می شود. زمانی که کنترلی غیرفعال باشد، کاربر نمی تواند با آن تعامل کند (به ارث رسیده از Control).
12	Items به منظور گرفتن مجموعه ای از داده ها که برای تولید محتوای کنترل استفاده می شوند، کاربرد دارد (به ارث رسیده از ItemsControl).
13	ItemSource به منظور گرفتن یا تنظیم یک شیء به عنوان منبع داده برای تولید محتوای ItemsControl استفاده می شود (به ارث رسیده از ItemsControl).
14	Margin میزان فاصله بیرونی کنترل را مشخص می کند (به ارث رسیده از FrameworkElement).
15	Name به منظور گرفتن یا تنظیم یک نام شناسایی برای کنترل استفاده می شود. زمانی که پردازنده XAML درخت اشیاء را ایجاد می کند، کد Run-time می تواند با استفاده از نام یک کنترل به آن ارجاع دهد (به ارث رسیده از FrameworkElement).
16	Opacity میزان شفافیت کنترل را مشخص می کند. مقدار قابل قبول باید بین 0.0 تا 1.0 باشد (به ارث رسیده از UIElement).
17	SelectedIndex به منظور گرفتن و یا تنظیم اندیس مربوط به آیتم انتخاب شده استفاده می شود (به ارث رسیده از Selector).
18	SelectedItem به منظور گرفتن و یا تنظیم آیتم انتخاب شده استفاده می شود (به ارث رسیده از Selector).
19	SelectedValue به منظور گرفتن یا تنظیم مقدار انتخاب شده با استفاده از SelectedValuePath استفاده می شود (به ارث رسیده از Selector).
20	Style استایل مربوط به کنترل را تنظیم می کند (به ارث رسیده از FrameworkElement).
21	VerticalAlignment تراز عمودی کنترل را در داخل کنترل والد مشخص می کند (به ارث رسیده از FrameworkElement).
22	Width به منظور گرفتن و یا تنظیم میزان عرض کنترل استفاده می شود (به ارث رسیده از FrameworkElement).

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

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

ردیف	توضیحات
1	DragEnter زمانی که سیستم ورودی یک رویداد drag که هدفش این کنترل است را گزارش دهد، این رویداد رخ می دهد (به ارث رسیده از UIElement).
2	DragLeave زمانی که سیستم ورودی یک رویداد drag که منشاء آن این کنترل است را گزارش دهد، این رویداد رخ می دهد (به ارث رسیده از UIElement).
3	DragOver زمانی که سیستم ورودی یک رویداد drag را با این کنترل به عنوان هدف drop شدن، گزارش دهد، این رویداد رخ می دهد (به ارث رسیده از UIElement).
4	DragStarting زمانی که عملیات drag کردن شروع شود، این رویداد رخ می دهد (به ارث رسیده از UIElement).
5	KeyDown زمانی که یک کلید از کیبورد فشار داده شود و فوکوس جاری بر روی کنترل باشد، این رویداد رخ می دهد (به ارث رسیده از UIElement).
6	KeyUp زمانی که کلید فشار داده شده رها شود و فوکوس جاری بر روی کنترل باشد، این رویداد رخ می دهد (به ارث رسیده از UIElement).
7	SelectionChanged زمانی که آیتم انتخاب شده تغییر کند، رخ می دهد (به ارث رسیده از Selector).

مثال

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

<Window x:Class = "WPFListBoxControl.MainWindow" 
   xmlns = "http://schemas.microsoft.com/winfx/2006/xaml/presentation" 
   xmlns:x = "http://schemas.microsoft.com/winfx/2006/xaml" 
   xmlns:d = "http://schemas.microsoft.com/expression/blend/2008" 
   xmlns:mc = "http://schemas.openxmlformats.org/markup-compatibility/2006" 
   xmlns:local = "clr-namespace:WPFListBoxControl"
   mc:Ignorable = "d" Title = "MainWindow" Height = "350" Width = "604">
	
   <Grid> 
      <ListBox Name = "listbox" Margin = "118,77,293,103">
         <ListBoxItem Content = "XAML Tutorials" /> 
         <ListBoxItem Content = "WPF Tutorials" /> 
         <ListBoxItem Content = "Silverlight Tutorials" /> 
         <ListBoxItem Content = "Windows 10 Tutorials" /> 
         <ListBoxItem Content = "iOS Tutorials" /> 
      </ListBox> 
		
      <TextBox Height = "23" x:Name = "textBox1" Width = "120" Margin = "361,116,0,0"  
         HorizontalAlignment = "Left" VerticalAlignment = "Top"  
         Text="{Binding SelectedItem.Content, ElementName=listbox}" /> 
   </Grid> 
	
</Window>