Control.ClientSize Özellik
Tanım
Önemli
Bazı bilgiler ürünün ön sürümüyle ilgilidir ve sürüm öncesinde önemli değişiklikler yapılmış olabilir. Burada verilen bilgilerle ilgili olarak Microsoft açık veya zımni hiçbir garanti vermez.
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 Denetimin istemci alanının boyutlarını temsil eden bir.
- Öznitelikler
Ö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ış.