DataGridView.AutoSizeColumnsMode Eigenschap
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 wordt een waarde opgehaald of ingesteld die aangeeft hoe kolombreedten worden bepaald.
public:
property System::Windows::Forms::DataGridViewAutoSizeColumnsMode AutoSizeColumnsMode { System::Windows::Forms::DataGridViewAutoSizeColumnsMode get(); void set(System::Windows::Forms::DataGridViewAutoSizeColumnsMode value); };public System.Windows.Forms.DataGridViewAutoSizeColumnsMode AutoSizeColumnsMode { get; set; }member this.AutoSizeColumnsMode : System.Windows.Forms.DataGridViewAutoSizeColumnsMode with get, setPublic Property AutoSizeColumnsMode As DataGridViewAutoSizeColumnsModeWaarde van eigenschap
Een DataGridViewAutoSizeColumnsMode waarde. De standaardwaarde is None.
Uitzonderingen
De opgegeven waarde bij het instellen van deze eigenschap is geen geldige DataGridViewAutoSizeColumnsMode waarde.
De opgegeven waarde bij het instellen van deze eigenschap is ColumnHeader, kolomkoppen zijn verborgen en ten minste één zichtbare kolom heeft een AutoSizeMode eigenschapswaarde van NotSet.
– of –
De opgegeven waarde bij het instellen van deze eigenschap is Fill en ten minste één zichtbare kolom met een AutoSizeMode eigenschapswaarde is NotSet geblokkeerd.
Voorbeelden
In het volgende codevoorbeeld ziet u hoe u deze eigenschap gebruikt in een hoofd-/detailscenario waarin twee DataGridView besturingselementen gegevens uit twee tabellen weergeven in een bovenliggende/onderliggende relatie. In dit voorbeeld is Nonede kolomgroottemodus voor het hoofdbeheer en worden de kolombreedten programmatisch geïnitialiseerd om de geladen waarden aan te passen. Het besturingselement details wordt ingesteld op een modus voor automatische kolomgrootte, zodat kolommen automatisch worden aangepast wanneer de waarden veranderen (bijvoorbeeld wanneer de gebruiker de huidige rij in de bovenliggende tabel wijzigt). Dit voorbeeld maakt deel uit van een groter voorbeeld dat beschikbaar is in Hoe u kunt: Een model-/detailformulier maken met behulp van twee Windows Forms DataGridView-besturingselementen.
private void Form1_Load(object sender, System.EventArgs e)
{
// Bind the DataGridView controls to the BindingSource
// components and load the data from the database.
masterDataGridView.DataSource = masterBindingSource;
detailsDataGridView.DataSource = detailsBindingSource;
GetData();
// Resize the master DataGridView columns to fit the newly loaded data.
masterDataGridView.AutoResizeColumns();
// Configure the details DataGridView so that its columns automatically
// adjust their widths when the data changes.
detailsDataGridView.AutoSizeColumnsMode =
DataGridViewAutoSizeColumnsMode.AllCells;
}
Private Sub Form1_Load(ByVal sender As Object, ByVal e As System.EventArgs) _
Handles Me.Load
' Bind the DataGridView controls to the BindingSource
' components and load the data from the database.
masterDataGridView.DataSource = masterBindingSource
detailsDataGridView.DataSource = detailsBindingSource
GetData()
' Resize the master DataGridView columns to fit the newly loaded data.
masterDataGridView.AutoResizeColumns()
' Configure the details DataGridView so that its columns automatically
' adjust their widths when the data changes.
detailsDataGridView.AutoSizeColumnsMode = _
DataGridViewAutoSizeColumnsMode.AllCells
End Sub
Opmerkingen
Met deze eigenschap kunt u het besturingselement zo configureren dat kolombreedten automatisch worden aangepast om het besturingselement te vullen of de celinhoud aan te passen. Wijzigingen in de grootte vinden plaats in de vulmodus wanneer de breedte van het besturingselement verandert. In de modus voor het aanpassen van de grootte op basis van inhoud vinden aanpassingen plaats wanneer de inhoud van de cel verandert of, indien WrapMode ingeschakeld, wanneer de rijhoogte verandert. Met sommige modi voor het aanpassen van de grootte op basis van inhoud kunt u de grootte van de momenteel weergegeven rijen beperken om de prestaties te verbeteren.
Als u de groottemodus voor een afzonderlijke kolom wilt wijzigen, stelt u AutoSizeMode de eigenschap in. De standaardwaarde van deze eigenschap is NotSet, waarmee wordt aangegeven dat de kolom het gedrag en InheritedAutoSizeMode de eigenschapswaarde van het besturingselement overneemt.
Kolommen in de vulmodus delen de beschikbare besturingsbreedte in verhoudingen die worden aangegeven door hun FillWeight eigenschapswaarden. De breedte die beschikbaar is voor de vulmodus wordt bepaald door de breedte van alle andere kolommen af te trekken van de breedte van het clientgebied van het besturingselement. Als deze breedte kleiner is dan de gecombineerde MinimumWidth waarden van alle kolommen in de opvulmodus, wordt de horizontale schuifbalk weergegeven, worden alle kolommen in de opvulmodus weergegeven met de minimale breedte en wordt het formaat van de gebruikerskolommen uitgeschakeld. Zie Opvullingsmodus in het Windows Forms DataGridView-besturingselement voor meer informatie over de kolomopvullingsmodus.
Alleen kolommen met een Visible eigenschapswaarde worden true automatisch gewijzigd en als u de zichtbaarheid van een kolom wijzigt, wordt de grootte niet gewijzigd. Wanneer kolommen zijn ingesteld om het formaat automatisch te wijzigen, kan de gebruiker de kolombreedten niet met de muis aanpassen.
Als u de kolombreedte programmatisch wilt aanpassen, gebruikt u de AutoResizeColumn of AutoResizeColumns methoden of stelt u de kolomeigenschap Width in.
Zie Sizing Options in the Windows Forms DataGridView Control voor meer informatie over automatische grootte op basis van inhoud.
