Control.ClientSize Özellik

  • Başvuru

Tanım

Ad Alanı:
System.Windows.Forms
Bütünleştirilmiş Kod:
System.Windows.Forms.dll

Denetimin istemci alanının yüksekliğini ve genişliğini alır veya ayarlar.

public:
 property System::Drawing::Size ClientSize { System::Drawing::Size get(); void set(System::Drawing::Size value); };
[System.ComponentModel.Browsable(false)]
public System.Drawing.Size ClientSize { get; set; }
[<System.ComponentModel.Browsable(false)>]
member this.ClientSize : System.Drawing.Size with get, set
Public Property ClientSize As Size

Özellik Değeri

Size

Size Denetimin istemci alanının boyutlarını temsil eden bir.

Öznitelikler
BrowsableAttribute

Örnekler

Aşağıdaki kod örneği, denetimin biçimlendirilmiş metni barındırması için belirtilen denetimi yeniden boyutlandırır. Biçimlendirilmiş metin, denetimin metne atandığı Font özelliktirText. AutoSizeControl Bu örnekteki yöntemi, denetimin tüm kenarlarına uygulanacak doldurmayı temsil eden bir textPadding parametreye de sahiptir. Doldurmanın eşit görünmesini sağlamak için, denetiminiz destekliyorsa metni değerle ContentAlignment.MiddleCenter hizalayın.

private:
   void AutoSizeControl( Control^ control, int textPadding )
   {
      
      // Create a Graphics object for the Control.
      Graphics^ g = control->CreateGraphics();
      
      // Get the Size needed to accommodate the formatted Text.
      System::Drawing::Size preferredSize = g->MeasureString( control->Text, control->Font ).ToSize();
      
      // Pad the text and resize the control.
      control->ClientSize = System::Drawing::Size( preferredSize.Width + (textPadding * 2), preferredSize.Height + (textPadding * 2) );
      
      // Clean up the Graphics object.
      delete g;
   }

private void AutoSizeControl(Control control, int textPadding)
{
   // Create a Graphics object for the Control.
   Graphics g = control.CreateGraphics();

   // Get the Size needed to accommodate the formatted Text.
   Size preferredSize = g.MeasureString(
      control.Text, control.Font).ToSize();

   // Pad the text and resize the control.
   control.ClientSize = new Size(
      preferredSize.Width + (textPadding * 2), 
      preferredSize.Height+(textPadding * 2) );

   // Clean up the Graphics object.
   g.Dispose();
}

Private Sub AutoSizeControl(control As Control, textPadding As Integer)
   ' Create a Graphics object for the Control.
   Dim g As Graphics = control.CreateGraphics()
   
   ' Get the Size needed to accommodate the formatted Text.
   Dim preferredSize As Size = g.MeasureString( _
     control.Text, control.Font).ToSize()
   
   ' Pad the text and resize the control.
   control.ClientSize = New Size( _
     preferredSize.Width + textPadding * 2, _
     preferredSize.Height + textPadding * 2)
   
   ' Clean up the Graphics object.
   g.Dispose()
End Sub

Açıklamalar

Denetimin istemci alanı, kaydırma çubukları, kenarlıklar, başlık çubukları ve menüler gibi istemci olmayan öğeler çıkarılarak denetimin sınırlarıdır. SetClientSizeCore özelliğini ayarlamak için yöntemi çağrılırClientSize. ClientSize özelliği her zaman yöntemi aracılığıyla set değiştirilmez, bu nedenle özelliği ayarlandığında kodunuzun SetClientSizeCore yürütülmesini ClientSize sağlamak için yöntemini geçersiz kılmanız gerekir.

ve Size.Height özellikleri, Size.Width denetimin istemci alanının genişliğini ve yüksekliğini gösterir. Denetimin yüzeyinde çizim yapma gibi görevler için denetimin istemci alanının boyutunu almak için bu özelliği kullanabilirsiniz.

Denetimler üzerinde çizim yapma hakkında daha fazla bilgi için bkz. Windows Forms Denetimi İşleme.

Not

Uygulama ayarlarını bu özelliğe bağlayamazsınız. Uygulama ayarları hakkında daha fazla bilgi için bkz. Uygulama Ayarlarına Genel Bakış.

Şunlara uygulanır

Ayrıca bkz.