TableLayoutPanel.SetColumnSpan(Control, Int32) Methode
Definitie
Belangrijk
Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.
Hiermee stelt u het aantal kolommen dat door het onderliggende besturingselement wordt beslaan.
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 -> unit
Public Sub SetColumnSpan (control As Control, value As Integer)
Parameters
- control
- Control
Een onderliggend besturingselement van de TableLayoutPanel.
- value
- Int32
Het aantal kolommen dat u wilt overspannen.
Uitzonderingen
value is kleiner dan 1.
Voorbeelden
In het volgende codevoorbeeld worden de GetColumnSpan en SetColumnSpan methoden gebruikt om de breedte van een Button besturingselement in een TableLayoutPanelbesturingselement in te stellen.
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
Opmerkingen
Kolomspanning is vaak handig voor het plaatsen van een besturingselement dat aanzienlijk breder is dan de peers.
Deze methode wordt aangeroepen door de ColumnSpan eigenschap, die het deelvenster toevoegt aan de onderliggende besturingselementen tijdens het ontwerp.