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 durante l'impostazione di questa proprietà ha la proprietà DataGridView impostata.
Esempio
Nell'esempio di codice seguente viene illustrato come usare il modello di riga per specificare un'altezza della riga iniziale e un'altezza minima di 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
A volte si vuole maggiore controllo sull'aspetto delle DataGridView righe rispetto a quello fornito dalle varie DataGridView proprietà dello stile di cella. La RowTemplate proprietà consente di creare e inizializzare un DataGridViewRow oggetto per l'uso come modello per 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 della riga predefinita per fornire spazio aggiuntivo sotto il contenuto normale della cella per visualizzare il contenuto che si estende su più colonne.
L'impostazione del modello di riga è necessaria quando i dati esterni vengono visualizzati usando tipi personalizzati derivati dalla DataGridViewRow classe. Con i controlli non in ingresso DataGridView è possibile popolare a livello di codice la Rows raccolta con istanze del tipo di riga personalizzato. Quando si visualizzano 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 oggetto DataGridViewRow .
