کنترل Button در WPF
کنترل Button نشان دهنده پایه ای ترین نوع یک دکمه است. در شکل زیر میتوانید سلسله مراتب مربوط به ارث بری این کنترل پر کاربرد را مشاهده کنید.
خاصیت های پرکاربرد
در جدول زیر می توانید خاصت های پر استفاده مربوط به کنترل Button را به همراه توضیح مختصری در مورد هر کدام مشاهده کنید.
ردیف | توضیحات |
1 | Background رنگ پس زمینه دکمه را مشخص می کند (به ارث رسیده از Control). |
2 | BorderBrush رنگ حاشیه دکمه را مشخص می کند (به ارث رسیده از Control). |
3 | BorderThickness میزان ضخامت حاشیه کنترل را مشخص می کند (به ارث رسیده از Control). |
4 | Content محتوای کنترل را مشخص می کند (به ارث رسیده از ContentControl). |
5 | ClickMode نوع کلیک کردن بر روی دکمه را مشخص می کند. حالت های قابل تنظیم عبارت اند از Hover، Press و Release (به ارث رسیده از ButtonBase). |
6 | ContentTemplate این خاصیت برای تنظیم قالب نمایش محتوای کنترل استفاده می شود (به ارث رسیده از ContentControl). |
7 | FontFamily نوع فونتی که برای نمایش محتوای کنترل استفاده می شود را مشخص می کند (به ارث رسیده از Control). |
8 | FontSize اندازه فونتی که برای نمایش محتوای کنترل استفاده می شود را مشخص می کند (به ارث رسیده از Control). |
9 | FontStyle حالت فونت را مشخص می کند. مقادیر قابل تنظیم عبارت اند از Normal، Italic و Oblique (به ارث رسیده از Control). |
10 | FontWeight میزان ضخامت فونتی که برای نمایش محتوای دکمه استفاده می شود را مشخص می کند (به ارث رسیده از Control). |
11 | Foreground رنگ پیش زمینه یا همان رنگ متن را مشخص می کند (به ارث رسیده از Control). |
12 | Height میزان ارتفاع کنترل را مشخص می کند (به ارث رسیده از Control). |
13 | HorizontalAlignment تراز افقی کنترل را در داخل کنترل والد مشخص می کند (به ارث رسیده از Control). |
14 | IsEnabled وضعیت فعال بودن یا نبودن کنترل را مشخص می کند. زمانی که کنترلی غیرفعال باشد، کاربر نمی تواند با آن تعامل کند (به ارث رسیده از Control). |
15 | IsPressed یک مقدار بولی را برمیگرداند که نشان دهنده این است که آیا ButtonBase در یک حالت فشار داده شده قرار دارد یا خیر (به ارث رسیده از ButtonBase). |
16 | Margin میزان فاصله بیرونی کنترل را مشخص می کند (به ارث رسیده از FrameworkElement). |
17 | Name به منظور تنظیم یک نام شناسایی برای کنترل استفاده می شود. زمانی که پردازنده XAML درخت اشیاء را ایجاد می کند، کد Run-time می تواند با استفاده از نام یک کنترل به آن ارجاع دهد (به ارث رسیده از FrameworkElement). |
18 | Opacity میزان شفافیت کنترل را مشخص می کند. مقدار قابل قبول باید بین 0.0 تا 1.0 باشد (به ارث رسیده از UIElement). |
19 | Resources منابع مربوط به کنترل را مشخص می کند (به ارث رسیده از FrameworkElement). |
20 | Style استایل مربوط به کنترل را تنظیم می کند (به ارث رسیده از FrameworkElement). |
21 | Template قالب کنترل را مشخص می کند. قالب کنترل مشخص می کند که یک کنترل چگونه باید نمایش داده شود (به ارث رسیده از Control). |
22 | VerticalAlignment تراز عمودی کنترل را در داخل کنترل والد مشخص می کند (به ارث رسیده از FrameworkElement). |
23 | Visibility وضعیت نمایش یک کنترل را مشخص می کند. کنترلی که قابل مشاهده نباشد، رندر نمی شود، بر اندازه لایه های دیگر تاثیر نمی گذارد و رویدادها و دستورات را هندل نمی کند (به ارث رسیده از UIElement). |
24 | Width میزان عرض کنترل را مشخص می کند (به ارث رسیده از FrameworkElement). |
متدهای پرکاربرد
در جدول زیر می توانید متدهای پر استفاده مربوط به کنترل Button را به همراه توضیح مختصری در مورد هر کدام مشاهده کنید.
ردیف | توضیحات |
1 | ClearValue مقدار یک Dependency Property را پاک می کند (به ارث رسیده از DependencyObject). |
2 | FindName شیء که نام مشخص شده را داشته باشد را پیدا می کند (به ارث رسیده از FrameworkElement). |
3 | OnApplyTemplate هر زمان که در کد برنامه یا فرآیندهای داخلی متد ApplyTemplate فراخوانی شود، این متد invoke می شود. به زبان ساده تر این متد قبلا از اینکه ظاهر کنترل نمایش داده شود، invoke می شود (به ارث رسیده از FrameworkElement). |
4 | OnContentChanged زمانی که مقدار خاصیت Content تغییر کنید این متد invoke می شود. (به ارث رسیده از ContentControl). |
5 | OnDragEnter قبل از اینکه رویداد DragEnter اتفاق افتد، این متد فراخوانی می شود (به ارث رسیده از Control). |
6 | OnDragLeave قبل از اینکه رویداد DragLeave اتفاق افتد، این متد فراخوانی می شود (به ارث رسیده از Control). |
7 | OnDragOver قبل از اینکه رویداد DragOver اتفاق افتد، این متد فراخوانی می شود (به ارث رسیده از Control). |
8 | OnDrop قبل از اینکه رویداد OnDrop اتفاق افتد، این متد فراخوانی می شود (به ارث رسیده از Control). |
9 | OnGotFocus قبل از اینکه رویداد GotFocus اتفاق افتد، این متد فراخوانی می شود (به ارث رسیده از Control). |
10 | OnKeyDown قبل از اینکه رویداد KeyDown اتفاق افتد، این متد فراخوانی می شود (به ارث رسیده از Control). |
11 | OnKeyUp قبل از اینکه رویداد KeyUp اتفاق افتد، این متد فراخوانی می شود (به ارث رسیده از Control). |
12 | OnLostFocus قبل از اینکه رویداد LostFocus اتفاق افتد، این متد فراخوانی می شود (به ارث رسیده از Control). |
13 | SetBinding این متد به منظور بایند کردن مقادیر استفاده می شود (به ارث رسیده از FrameworkElement). |
رویدادهای پرکاربرد
در جدول زیر می توانید رویدادهای پر استفاده مربوط به کنترل Button را به همراه توضیح مختصری در مورد هر کدام مشاهده کنید.
ردیف | توضیحات |
1 | Click زمانی که بر روی دکمه کلیک شود، این رویداد رخ می دهد (به ارث رسیده از ButtonBase). |
2 | DataContextChanged زمانی که مقدار خاصیت DataContext تغییر کند، این رویداد رخ می دهد (به ارث رسیده از FrameworkElement). |
3 | DragEnter زمانی که سیستم ورودی یک رویداد drag که هدفش این کنترل است را گزارش دهد، این رویداد رخ می دهد (به ارث رسیده از UIElement). |
4 | DragLeave زمانی که سیستم ورودی یک رویداد drag که منشاء آن این کنترل است را گزارش دهد، این رویداد رخ می دهد (به ارث رسیده از UIElement). |
5 | DragOver زمانی که سیستم ورودی یک رویداد drag را با این کنترل به عنوان هدف drop شدن، گزارش دهد، این رویداد رخ می دهد (به ارث رسیده از UIElement). |
6 | DragStarting زمانی که عملیات drag کردن شروع شود، این رویداد رخ می دهد (به ارث رسیده از UIElement). |
7 | GotFocus زمانی که بر روی کنترل فوکوس شود، این رویداد رخ می دهد (به ارث رسیده از UIElement). |
8 | IsEnabledChanged زمانی که مقدار خایت IsEnabled تغییر کند، این رویداد رخ می دهد (به ارث رسیده از Control). |
9 | KeyDown زمانی که یک کلید از کیبورد فشار داده شود و فوکوس جاری بر روی کنترل باشد، این رویداد رخ می دهد (به ارث رسیده از UIElement). |
10 | KeyUp زمانی که کلید فشار داده شده رها شود و فوکوس جاری بر روی کنترل باشد، این رویداد رخ می دهد (به ارث رسیده از UIElement). |
11 | LostFocus زمانی که کنترل فوکوس را از دست بدهد، این رویداد رخ می دهد (به ارث رسیده از UIElement). |
12 | SizeChanged زمانی که مقدار یکی از خاصیت های ActualHeight و یا ActualWidth تغییر کند، این رویداد رخ می دهد (به ارث رسیده از FrameworkElement). |
مثال
در ادامه برای درک بهتر موارد گفته شده یک مثال ساده ایجاد خواهیم کرد. ابتدا یک پروژه WPF ایجاد کنید و سپس از بخش Toolbox یک دکمه را بر روی صفحه طراحی قرار دهید. حال مقادیر مربوط به خاصیت های زیر را تنظیم کنید.
خاصیت | مقدار |
Content | Click Me |
Margin | 200 |
Height | 20 |
Width | 75 |
حال اگر به کدهای XAML مربوط به برنامه نگاه کنید خروجی زیر را مشاهده خواهید کرد.
1 2 3 4 5 6 7 8 9 10 11 12 13 | <Window x:Class = "WPFButtonControl.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:WPFButtonControl" mc:Ignorable = "d" Title = "MainWindow" Height = "350" Width = "525"> <Grid> <Button x:Name = "button" Content = "Click Me" HorizontalAlignment = "Left" Margin = "194,150,0,0" VerticalAlignment = "Top" Width = "75"/> </Grid> </Window> |
حال در پنجره طراحی برنامه بر روی دکمه ای که ایجاد کردید دوبار کلیک کنید تا هندلر مربوط به رویداد کلیک برای آن دکمه ایجاد شود. بعد از آن کد برنامه را به شکل زیر تغییر دهید.
1 2 3 4 5 6 7 8 9 10 11 12 | using System.Windows; namespace WPFButtonControl { public partial class MainWindow : Window { public MainWindow() { InitializeComponent(); } private void button_Click(object sender, RoutedEventArgs e) { MessageBox.Show("You have clicked the button"); } } } |
همانطور که در کد فوق مشاهده می کنید ما در داخل هندلر مربوط به رویداد کلیک دکمه یک پیام ساده را نمایش می دهیم. اگر برنامه را کامپایل و اجرا کنید، خروجی زیر را مشاهده خواهید کرد.
حال بر روی دکمه کلیک کنید تا خروجی زیر را مشاهده کنید.
هیچ نظری ثبت نشده است