DataGridViewRow Třída
Definice
Důležité
Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.
Představuje řádek v ovládacím DataGridView prvku.
public ref class DataGridViewRow : System::Windows::Forms::DataGridViewBand[System.ComponentModel.TypeConverter(typeof(System.Windows.Forms.DataGridViewRowConverter))]
public class DataGridViewRow : System.Windows.Forms.DataGridViewBand[<System.ComponentModel.TypeConverter(typeof(System.Windows.Forms.DataGridViewRowConverter))>]
type DataGridViewRow = class
inherit DataGridViewBandPublic Class DataGridViewRow
Inherits DataGridViewBand- Dědičnost
- Atributy
Příklady
Následující příklad kódu znázorňuje použití tohoto typu. Tento příklad je součástí většího příkladu dostupného v části Postupy: Manipulace s řádky v ovládacím prvku Windows Forms DataGridView.
// Set row labels.
void Button6_Click( Object^ /*sender*/, System::EventArgs^ /*e*/ )
{
int rowNumber = 1;
System::Collections::IEnumerator^ myEnum = safe_cast<System::Collections::IEnumerable^>(dataGridView->Rows)->GetEnumerator();
while ( myEnum->MoveNext() )
{
DataGridViewRow^ row = safe_cast<DataGridViewRow^>(myEnum->Current);
if ( row->IsNewRow )
continue;
row->HeaderCell->Value = String::Format( L"Row {0}", rowNumber );
rowNumber = rowNumber + 1;
}
dataGridView->AutoResizeRowHeadersWidth( DataGridViewRowHeadersWidthSizeMode::AutoSizeToAllHeaders );
}
// Set row labels.
private void Button6_Click(object sender, System.EventArgs e)
{
int rowNumber = 1;
foreach (DataGridViewRow row in dataGridView.Rows)
{
if (row.IsNewRow) continue;
row.HeaderCell.Value = "Row " + rowNumber;
rowNumber = rowNumber + 1;
}
dataGridView.AutoResizeRowHeadersWidth(
DataGridViewRowHeadersWidthSizeMode.AutoSizeToAllHeaders);
}
' Set row labels.
Private Sub Button6_Click(ByVal sender As Object, _
ByVal e As System.EventArgs) Handles Button6.Click
Dim rowNumber As Integer = 1
For Each row As DataGridViewRow In dataGridView.Rows
If row.IsNewRow Then Continue For
row.HeaderCell.Value = "Row " & rowNumber
rowNumber = rowNumber + 1
Next
dataGridView.AutoResizeRowHeadersWidth( _
DataGridViewRowHeadersWidthSizeMode.AutoSizeToAllHeaders)
End Sub
Poznámky
Třída DataGridViewRow představuje řádek v ovládacím DataGridView prvku. Řádky můžete načíst prostřednictvím Rows ovládacích prvků a SelectedRows kolekcí.
Na rozdíl od , DataGridViewColumnDataGridViewRow fyzicky obsahuje kolekci všech buněk v daném řádku. K této kolekci Cells můžete přistupovat prostřednictvím vlastnosti.
Třída DataGridViewRow se používá pro přístup k jednotlivým prvkům buňky a také k úpravě vzhledu a chování uživatelského rozhraní řádku, jako je výška a styl buňky. Obvykle budete chtít, aby všechny řádky nebo většina řádků v ovládacím prvku sdílely stejné charakteristiky. Chcete-li nastavit styly buněk pro všechny řádky v ovládacím prvku, nastavte vlastnosti objektu vráceného DataGridView.RowsDefaultCellStyle vlastností. Pokud chcete nastavit styly pro střídavé řádky, použijte DataGridView.AlternatingRowsDefaultCellStyle tuto vlastnost. Další informace o stylech buněk naleznete v části Styly buněk v ovládacím prvku Windows Forms DataGridView. Vlastnost můžete také použít DataGridView.RowTemplate k definování řádku, který se použije jako základ pro všechny řádky přidané do ovládacího prvku.
Ovládací DataGridView prvek bude sdílet DataGridViewRow objekty v několika řádcích dat, kdykoli je to možné, aby se zabránilo pokutám za výkon. Pokud nepracujete s velkým množstvím dat a dochází k problémům s výkonem, můžete obvykle ignorovat sdílení řádků. Sdílený řádek je označen Index hodnotou vlastnosti -1. Některé členy DataGridViewRow třídy nelze použít se sdílenými řádky, ale řádek můžete zrušit tak, že k němu přistupujete prostřednictvím DataGridViewRowCollection.Item[] vlastnosti. Řádky se také můžou nesdílet jinými způsoby. Pokud chcete získat přístup k řádku bez jeho sdílení, použijte metodu DataGridViewRowCollection.SharedRow . Při práci s velkými objemy dat byste měli vědět, jak se řádky sdílejí a nesdílejí, abyste se vyhnuli sankcím za výkon. Další informace naleznete v tématu Osvědčené postupy pro škálování ovládacího prvku Windows Forms DataGridView.
Poznámky pro dědice
Při odvozené DataGridViewRow třídě a přidání nových vlastností do odvozené třídy nezapomeňte přepsat metodu Clone() kopírování nových vlastností během operací klonování. Měli byste také volat metodu základní třídy Clone() tak, aby vlastnosti základní třídy byly zkopírovány do nové buňky.
Konstruktory
| Name | Description |
|---|---|
| DataGridViewRow() |
Inicializuje novou instanci DataGridViewRow třídy bez použití šablony. |
Vlastnosti
| Name | Description |
|---|---|
| AccessibilityObject |
DataGridViewRow.DataGridViewRowAccessibleObject Získá přiřazeno DataGridViewRow. |
| Cells |
Získá kolekci buněk, které naplní řádek. |
| ContextMenuStrip |
Získá nebo nastaví místní nabídku pro řádek. |
| DataBoundItem |
Získá objekt vázaný na data, který naplnil řádek. |
| DataGridView |
Získá ovládací prvek DataGridView přidružený k tomuto prvku. (Zděděno od DataGridViewElement) |
| DefaultCellStyle |
Získá nebo nastaví výchozí styly pro řádek, které se používají k vykreslení buněk v řádku, pokud styly nejsou přepsány. |
| DefaultHeaderCellType |
Získá nebo nastaví typ běhu výchozí buňky záhlaví. (Zděděno od DataGridViewBand) |
| Displayed |
Získá hodnotu označující, zda je tento řádek zobrazen na obrazovce. |
| DividerHeight |
Získá nebo nastaví výšku oddělovače řádků v pixelech. |
| ErrorText |
Získá nebo nastaví text chybové zprávy pro chyby na úrovni řádků. |
| Frozen |
Získá nebo nastaví hodnotu určující, zda je řádek zablokovaný. |
| HasDefaultCellStyle |
Získá hodnotu určující, zda DefaultCellStyle byla vlastnost nastavena. (Zděděno od DataGridViewBand) |
| HeaderCell |
Získá nebo nastaví buňku záhlaví řádku. |
| HeaderCellCore |
Získá nebo nastaví buňku DataGridViewBandzáhlaví . (Zděděno od DataGridViewBand) |
| Height |
Získá nebo nastaví aktuální výšku řádku. |
| Index |
Získá relativní pozici pásma uvnitř DataGridView ovládacího prvku. (Zděděno od DataGridViewBand) |
| InheritedStyle |
Získá styl buňky v efektu pro řádek. |
| IsNewRow |
Získá hodnotu určující, zda řádek je řádek pro nové záznamy. |
| IsRow |
Získá hodnotu určující, zda pruh představuje řádek. (Zděděno od DataGridViewBand) |
| MinimumHeight |
Získá nebo nastaví minimální výšku řádku. |
| ReadOnly |
Získá nebo nastaví hodnotu určující, zda je řádek jen pro čtení. |
| Resizable |
Získá nebo nastaví hodnotu určující, zda uživatelé mohou změnit velikost řádku nebo indikovat, že chování je zděděno z AllowUserToResizeRows vlastnosti. |
| Selected |
Získá nebo nastaví hodnotu určující, zda je řádek vybrán. |
| State |
Získá aktuální stav řádku. |
| Tag |
Získá nebo nastaví objekt, který obsahuje data pro přidružení k pásmu. (Zděděno od DataGridViewBand) |
| Visible |
Získá nebo nastaví hodnotu určující, zda je řádek viditelný. |
