تصدير (0) طباعة
توسيع الكل
هذه المقالة مترجمة آليًا. حرك المؤشر فوق الجمل في المقالة لعرض النص الأصلي. المزيد من المعلومات.
الترجمة
الأصلي

CheckedListBox الفئة

.NET Framework 4

Dهوplays ListBoxفيه خانة اختيار هو dهوplayed إلى يسار كل عنصر.

مساحة الاسم:  System.Windows.Forms
التجميع:  System.Windows.Forms (في System.Windows.Forms.dll)

[LookupBindingPropertiesAttribute]
[ComVisibleAttribute(true)]
[ClassInterfaceAttribute(ClassInterfaceType.AutoDispatch)]
public class CheckedListBox : ListBox

وهذا عنصر تحكم تقدم قائمة عناصر التي يمكن للمستخدم الانتقال باستخدام لوحة المفاتيح أو شريط التمرير الجانب الأيسر من عنصر تحكم. يمكن وضع مستخدم فحص وضع علامة بأحد أو يمكن أن يكون الانتقال من عناصر وعناصر فحص ed مع CheckedListBox.CheckedItemCollectionو CheckedListBox.CheckedIndexCollection.

إلى إضافة الالكائنات إلى القائمة في وقت التشغيل، قم بتعيين صفيفة مراجع كائن مع AddRangeالأسلوب. قائمة ثم يعرض القيمة السلسلة الافتراضية لكل كائن. يمكنك إضافة عناصر الفردية بالنسبة إلى القائمة مع Addالأسلوب.

CheckedListBox كائن يدعم ثلاث حالات من خلال CheckStateالتعداد: Checked ، Indeterminate و Unchecked يجب تعيين الحالة Indeterminateفي تعليمات برمجية لأن واجهة مستخدم CheckedListBoxلا توفر إليه للقيام so.

إذا UseTabStopsهو true، CheckedListBoxيتعرف و المتوقعة و فوق الأحرف في نص أحد العناصر، قم بإنشاء أعمدة. التعيين المسبق لعلامات التبويب هذه و ولا يمكن تغييرها. لاستخدام علامات الجدولة المخصصة، قم بتعيين UseTabStopsإلى false، قم بتعيين UseCustomTabOffsetsإلى true، ثم قم بإضافة قيم مخصصة CustomTabOffsetsالتعيين.

ملاحظةملاحظة

إذا UseCompatibleTextRenderingخاصية هو falseCustomTabOffsetsسيتم تجاهل خاصية واستبداله بعلامة تبويب قياسية الإزاحات.

CheckedListBox فئة يدعم المجموعات المفهرسة الثلاثة التالية:

المجموعة

تغليف الفئة

كل العناصر الموجودة في CheckedListBoxعنصر تحكم.

CheckedListBox.ObjectCollection

التحقق من عناصر (بما فيها عناصر في الولاية غير معرف)، الذي هو مجموعة فرعية من عناصر الموجودة في CheckedListBoxعنصر التحكم.

CheckedListBox.CheckedItemCollection

محدد من فهارس، وهي مجموعة فرعية من فهارس في مجموعة عناصر. تحديد فهارس هذه عناصر في محدد أو الولاية غير معرفة.

CheckedListBox.CheckedIndexCollection

الجداول الثلاثة التالية أمثلة عن الثلاثة تمت الفهرسة المجموعات التي CheckedListBoxيدعم فئة.

يوفر الجدول أول مثال تمت الفهرسة مجموعة من عناصر في عنصر التحكم (كل العناصر الموجودة في عنصر التحكم).

الفهرس

العنصر

الولاية الاختيار

0

كائن 1

Unchecked

1

كائن 2

Checked

2

كائن 3

Unchecked

3

كائن 4

Indeterminate

4

كائن 5

Checked

يوفر الجدول الثاني مثال تمت الفهرسة مجموعة من عناصر المحددة.

الفهرس

العنصر

0

كائن 2

1

كائن 4

2

كائن 5

يحتوي الجدول الثالث يوفر مثالاً لمجموعة مفهرسة من الفهارس للعناصر المحددة.

الفهرس

فهرس عنصر

0

1

1

3

2

4

ملاحظةلا يمكن يربط بيانات إلى CheckedListBox. استخدام ComboBoxأو ListBoxهذا بدلاً من ذلك. لمزيد من المعلومات، راجع كيفية القيام بما يلي: يربط بيانات Windows Forms مربع تحرير وسرد أو عنصر تحكم مربع قائمة.

The following مثال illustrates how you can استخدم the وظائف, خصائص, و collections of a CheckedListBox. This هو a إكمال نموذج جاهز إلى تشغيل once you have copied it إلى your مشروع. You can فحص و إلغاء تحديد عناصر, استخدم the صندوق نص إلى إضافة عناصر و once you have clicked the حفظ زر, مسح the محدد عناصر.


namespace WindowsApplication1
{
   using System;
   using System.Drawing;
   using System.Collections;
   using System.ComponentModel;
   using System.Windows.Forms;
   using System.Data;
   using System.IO ;

   public class Form1 : System.Windows.Forms.Form
   {
      private System.Windows.Forms.CheckedListBox checkedListBox1;
      private System.Windows.Forms.TextBox textBox1;
      private System.Windows.Forms.Button button1;
      private System.Windows.Forms.Button button2;
      private System.Windows.Forms.ListBox listBox1;
      private System.Windows.Forms.Button button3;
        private System.ComponentModel.Container components;

      public Form1()
      {
            InitializeComponent();

         // Sets up the initial objects in the CheckedListBox.
            string[] myFruit = {"Apples", "Oranges","Tomato"};
         checkedListBox1.Items.AddRange(myFruit);

            // Changes the selection mode from double-click to single click.
         checkedListBox1.CheckOnClick = true;
      }

      protected override void Dispose( bool disposing )
	  {
		if( disposing )
		{
			if (components != null) 
			{
			  components.Dispose();
			}
		}
		base.Dispose( disposing );
	  }

      private void InitializeComponent()
      {
         this.components = new System.ComponentModel.Container();
         this.textBox1 = new System.Windows.Forms.TextBox();
         this.checkedListBox1 = new System.Windows.Forms.CheckedListBox();
         this.listBox1 = new System.Windows.Forms.ListBox();
         this.button1 = new System.Windows.Forms.Button();
         this.button2 = new System.Windows.Forms.Button();
         this.button3 = new System.Windows.Forms.Button();
         this.textBox1.Location = new System.Drawing.Point(144, 64);
         this.textBox1.Size = new System.Drawing.Size(128, 20);
         this.textBox1.TabIndex = 1;
         this.textBox1.TextChanged += new System.EventHandler(this.textBox1_TextChanged);
         this.checkedListBox1.Location = new System.Drawing.Point(16, 64);
         this.checkedListBox1.Size = new System.Drawing.Size(120, 184);
         this.checkedListBox1.TabIndex = 0;
         this.checkedListBox1.ItemCheck += new System.Windows.Forms.ItemCheckEventHandler(this.checkedListBox1_ItemCheck);
         this.listBox1.Location = new System.Drawing.Point(408, 64);
         this.listBox1.Size = new System.Drawing.Size(128, 186);
         this.listBox1.TabIndex = 3;
         this.button1.Enabled = false;
         this.button1.Location = new System.Drawing.Point(144, 104);
         this.button1.Size = new System.Drawing.Size(104, 32);
         this.button1.TabIndex = 2;
         this.button1.Text = "Add Fruit";
         this.button1.Click += new System.EventHandler(this.button1_Click);
         this.button2.Enabled = false;
         this.button2.Location = new System.Drawing.Point(288, 64);
         this.button2.Size = new System.Drawing.Size(104, 32);
         this.button2.TabIndex = 2;
         this.button2.Text = "Show Order";
         this.button2.Click += new System.EventHandler(this.button2_Click);
         this.button3.Enabled = false;
         this.button3.Location = new System.Drawing.Point(288, 104);
         this.button3.Size = new System.Drawing.Size(104, 32);
         this.button3.TabIndex = 2;
         this.button3.Text = "Save Order";
         this.button3.Click += new System.EventHandler(this.button3_Click);
         this.ClientSize = new System.Drawing.Size(563, 273);
         this.Controls.AddRange(new System.Windows.Forms.Control[] {this.listBox1,
                                                        this.button3,
                                                        this.button2,
                                                        this.button1,
                                                        this.textBox1,
                                                        this.checkedListBox1});
         this.Text = "Fruit Order";
      }

      [STAThread]
      public static void Main(string[] args) 
      {
         Application.Run(new Form1());
      }

      // Adds the string if the text box has data in it.
      private void button1_Click(object sender, System.EventArgs e)
      {
         if(textBox1.Text != "")
         {
            if(checkedListBox1.CheckedItems.Contains(textBox1.Text)== false)
               checkedListBox1.Items.Add(textBox1.Text,CheckState.Checked);
            textBox1.Text = "";
         }

      }
      // Activates or deactivates the Add button.
      private void textBox1_TextChanged(object sender, System.EventArgs e)
      {
         if (textBox1.Text == "")
         {
            button1.Enabled = false;
         }
         else
         {
            button1.Enabled = true;
         }

        }

      // Moves the checked items from the CheckedListBox to the listBox.
      private void button2_Click(object sender, System.EventArgs e)
      {
         listBox1.Items.Clear();
         button3.Enabled=false;
         for (int i=0; i< checkedListBox1.CheckedItems.Count;i++)
         {
            listBox1.Items.Add(checkedListBox1.CheckedItems[i]);
         }
         if (listBox1.Items.Count>0)
            button3.Enabled=true;

      }
        // Activates the move button if there are checked items.
      private void checkedListBox1_ItemCheck(object sender, ItemCheckEventArgs e)
      {
         if(e.NewValue==CheckState.Unchecked)
         {
            if(checkedListBox1.CheckedItems.Count==1)
            {
               button2.Enabled = false;
            }
         }
         else
         {
            button2.Enabled = true;
         }
      }

        // Saves the items to a file.
      private void button3_Click(object sender, System.EventArgs e)
      {   
         // Insert code to save a file.
         listBox1.Items.Clear();
         IEnumerator myEnumerator;
         myEnumerator = checkedListBox1.CheckedIndices.GetEnumerator();
         int y;
         while (myEnumerator.MoveNext() != false)
         {
            y =(int) myEnumerator.Current;
            checkedListBox1.SetItemChecked(y, false);
         }
         button3.Enabled = false ;
      }        
    }
}
   


يتم تأمين العملية الجزئية لأي عضو عمومي ثابت (مشترك في Visual Basic) من هذا النوع. لن يتم ضمان تأمين العملية الجزئية لأي عضو مثيل.

نظام التشغيل Windows 7, Windows Vista, Windows XP SP2, Windows XP Media Center Edition, الإصدار x64 من نظام التشغيل Windows XP Professional, Windows XP Starter Edition, Windows Server 2008, نظام التشغيل Windows Server 2003, نظام التشغيل Windows Server 2000 المزود بحزمة الخدمة SP4, نظام التشغيل Windows Millennium Edition, نظام التشغيل Windows 98

لا يدعم .NET Framework و .NET Compact Framework كافة الإصدارات الخاصة بكل نظام أساسي. للحصول على قائمة بالإصدارات المدعمة، راجع متطلبات النظام إطار عمل .NET.

.NET Framework

مدعوم في: 4, 3.5, 3.0, 2.0, 1.1, 1.0

NET Framework. Client Profile

مدعوم في: 4

إضافات المجتمع

إضافة
إظهار:
© 2014 Microsoft