DataGridView.RowTemplate Proprietà
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
Ottiene o imposta la riga che rappresenta il modello per tutte le righe nel controllo .
public:
property System::Windows::Forms::DataGridViewRow ^ RowTemplate { System::Windows::Forms::DataGridViewRow ^ get(); void set(System::Windows::Forms::DataGridViewRow ^ value); };[System.ComponentModel.Browsable(true)]
public System.Windows.Forms.DataGridViewRow RowTemplate { get; set; }[<System.ComponentModel.Browsable(true)>]
member this.RowTemplate : System.Windows.Forms.DataGridViewRow with get, setPublic Property RowTemplate As DataGridViewRowValore della proprietà
Oggetto DataGridViewRow che rappresenta il modello di riga.
- Attributi
Eccezioni
La riga specificata quando si imposta questa proprietà ha la relativa DataGridView proprietà impostata.
Esempio
Nell'esempio di codice seguente viene illustrato come usare il modello di riga per specificare un'altezza di riga iniziale e un'altezza minima della riga.
DataGridViewRow^ row = this->dataGridView1->RowTemplate;
row->DefaultCellStyle->BackColor = Color::Bisque;
row->Height = 35;
row->MinimumHeight = 20;
DataGridViewRow row = this.dataGridView1.RowTemplate;
row.DefaultCellStyle.BackColor = Color.Bisque;
row.Height = 35;
row.MinimumHeight = 20;
With Me.dataGridView1.RowTemplate
.DefaultCellStyle.BackColor = Color.Bisque
.Height = 35
.MinimumHeight = 20
End With
Commenti
In alcuni casi è necessario un maggiore controllo sull'aspetto delle DataGridView righe rispetto a quanto fornito dalle varie DataGridView proprietà dello stile di cella. La RowTemplate proprietà consente di creare e inizializzare un DataGridViewRow oggetto da utilizzare come modello da tutte le righe, inclusa la riga per i nuovi record se AllowUserToAddRows è true.
Ciò è utile quando si impostano valori predefiniti per le proprietà, ad esempio l'altezza della riga. Ad esempio, è possibile aumentare l'altezza predefinita della riga per fornire spazio aggiuntivo sotto il contenuto normale della cella per la visualizzazione di contenuto che si estende su più colonne.
L'impostazione del modello di riga è necessaria quando vengono visualizzati dati esterni usando tipi personalizzati derivati dalla DataGridViewRow classe . Con i controlli non associati DataGridView , è possibile popolare la Rows raccolta a livello di codice con istanze del tipo di riga personalizzato. Quando vengono visualizzati dati esterni, tuttavia, le righe vengono generate automaticamente, ma sono basate sul modello di riga, che è possibile impostare su un'istanza del tipo di riga personalizzato.
Se questa proprietà non è stata impostata la prima volta che si recupera il relativo valore, viene creato e restituito un nuovo DataGridViewRow oggetto .
