TableLayoutPanel.SetColumnSpan(Control, Int32) Methode
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Legt die Anzahl der Spalten fest, über die sich das untergeordnete Steuerelement erstreckt.
public:
void SetColumnSpan(System::Windows::Forms::Control ^ control, int value);public void SetColumnSpan (System.Windows.Forms.Control control, int value);member this.SetColumnSpan : System.Windows.Forms.Control * int -> unitPublic Sub SetColumnSpan (control As Control, value As Integer)- control
- Control
Ein untergeordnetes Steuerelement von TableLayoutPanel.
- value
- Int32
Die Anzahl der zu einzunehmenden Spalten.
value ist kleiner als 1.
Im folgenden Codebeispiel werden die GetColumnSpan Und SetColumnSpan Methoden verwendet, um die Breite eines Button Steuerelements in einem Steuerelement TableLayoutPanelfestzulegen.
private void toggleSpanBtn_Click(
System.Object sender,
System.EventArgs e)
{
Control c = this.TableLayoutPanel1.GetControlFromPosition(0, 0);
if ( c != null )
{
int xSpan = this.TableLayoutPanel1.GetColumnSpan(c);
int ySpan = this.TableLayoutPanel1.GetRowSpan(c);
if (xSpan>1)
{
xSpan = 1;
ySpan = 1;
}
else
{
xSpan = 2;
ySpan = 2;
}
this.TableLayoutPanel1.SetColumnSpan(c, xSpan);
this.TableLayoutPanel1.SetRowSpan(c, ySpan);
}
}
Private Sub toggleSpanBtn_Click( _
ByVal sender As System.Object, _
ByVal e As System.EventArgs) _
Handles toggleSpanBtn.Click
Dim c As Control = Me.TableLayoutPanel1.GetControlFromPosition(0, 0)
If c IsNot Nothing Then
Dim xSpan As Integer = Me.TableLayoutPanel1.GetColumnSpan(c)
Dim ySpan As Integer = Me.TableLayoutPanel1.GetRowSpan(c)
If xSpan > 1 Then
xSpan = 1
ySpan = 1
Else
xSpan = 2
ySpan = 2
End If
Me.TableLayoutPanel1.SetColumnSpan(c, xSpan)
Me.TableLayoutPanel1.SetRowSpan(c, ySpan)
End If
End Sub
Die Spaltenspanne ist häufig nützlich, um ein Steuerelement zu positionieren, das erheblich breiter ist als seine Peers.
Diese Methode wird von der ColumnSpan Eigenschaft aufgerufen, die der Bereich zu den untergeordneten Steuerelementen zur Entwurfszeit hinzufügt.