Class GridDesignViewModel
Diese Klasse repräsentiert das Control Grid. Die Properties und Events dieser Klasse werden im Form-Designer angeboten.
Inheritance
Implements
Inherited Members
Namespace: FrameworkSystems.FrameworkStudio.General.DevObjects.Form.Designer.ViewModels
Assembly: FrameworkSystems.FrameworkStudio.General.dll
Syntax
[DocfxBrowsable]
public class GridDesignViewModel : ContainerDesignViewModel, INotifyPropertyChanged, IDisposable, INamedRecordProperties
BackColor2
Bestimmt die zeilenweise alternierende Hintergrundfarbe einer Tabelle. Für den Hintergrund der Grid-Zeilen wird abwechselnd BackColor und BackColor2 verwendet. Wenn keine Farbe angegeben ist, dann wird für alle Grid-Zeilen die BackColor verwendet
DataSource
Gibt den Datasource an, dessen Daten im Grid angezeigt werden sollen. Es ist wichtig, dass Sie hier eine Collection angeben.
GridColor
GridRowHeight
Definiert die Höhe einer Zeile. Die Angabe erfolgt in Pixeln. Wenn kein Wert angegeben ist, dann berechnet der Client die Höhe der Zeile anhand der Schriftart.
HeaderColor
Gibt die Hintergrundfarbe der Tabellenüberschrift an.
IsEditable
Gibt an, ob am Grid Daten geändert werden dürfen. Ist IsEditable auf False gesetzt, wirkt sichdas auf alle Columns aus – egal, was dort angegeben ist.
MainMemorySortingThreshold
Grids bieten grundsätzlich die Möglichkeit, die dargestellten Daten nach einer Spalte zu sortieren oder zu filtern. Dazu stehen zwei Mechanismen (Datenbanksortierung und Hauptspeichersortierung) zur Verfügung.
Multiselect
Gibt an, ob mehrere Zeilen ausgewählt werden können. Bei False kann nur maximal eine Zeile ausgewählt werden. Bei True ist die Auswahl mehrerer Zeilen möglich. Welche Zeilen ausgewählt sind, lässt sich in der SelectRowsCollection auswerten und setzen (siehe Property SelectedRows).
NewRowIcon
Pfad für ein Icon, das im Row-Header angezeigt wird, wenn die Zeile neu hinzugefügt wurde. Das Icon wird angezeigt, wenn an dem Objekt der Zeile (Component) das Property State den Wert New hat.
RowChangedIcon
Pfad für ein Icon, das im Row-Header angezeigt wird, wenn die Zeile geändert wurde. Das Icon wird angezeigt, wenn an dem Objekt der Zeile (Component) das Property State den Wert Changed hat.
RowDeletedIcon
Pfad für ein Icon, das im Row-Header angezeigt wird, wenn die Zeile zum Löschen markiert
wurde. Das Icon wird angezeigt, wenn an dem Objekt der Zeile (Component) das Property
StateBeforeUpdate den Wert true hat.
RowHeader
Bestimmt, ob im Row-Header die Zeilennummer oder der Status des Rows angezeigt wird.
RowHeaderWidth
Höhe der Spalten.
SelectedRows
Hier kann ein Form Property zugeordnet werden, das sich merkt, welche Zeilen im Grid markiert sind. Dieses Property muss vom Typ SelectedRowsCollection sein. Diese Collection enthält guids.
ShowHorizontalLines
Gibt an, ob die horizontalen Rasterlinien in einem Grid angezeigt werden sollen oder nicht.
ShowVerticalLines
Gibt an, ob die vertikalen Rasterlinien in einem Grid angezeigt werden sollen oder nicht.
TransferReloadRowCount
Definiert, wie viele Zeilen nachgelesen werden, wenn in der Tabelle in den entsprechenden Bereich gescrollt wurde. Bei 0 werden alle Zeilen zurückgegeben.
TransferStartupRowCount
Definiert, wie viele Zeilen bei einem Load zunächst an den Client zurückgegeben werden. Bei 0 werden alle Zeilen zurückgegeben. Es wird nicht empfohlen, sich standardmäßig alle Zeilen zurückgeben zu lassen, da dies bei großen Datenmengen zu starker Belastung des Clients und des Webservers kommt. Es ist deshalb besser, sich zunächst einen Block zurückgeben zu lassen und bei Bedarf die Daten dynamisch nachlesen zu lassen.
Events
OnAppendNewRow
Dieser Vorgang wird ausgelöst, wenn in der letzten Zeile im letzten editierbaren Feld die Tab-Taste gedrückt wird.
OnCellDoubleClick
Tritt auf, wenn doppelt in eine Gridzelle (nicht RowHeader und nicht ColumnHeader) geklickt wurde. Das Event Argument stellt Spaltennummer (ColNum) und Datensatznummer (RowID) zur Verfügung.
OnColumnChanged
Wird ausgelöst, wenn sich der Inhalt einer Spalte geändert hat. Sie können über das EventArg e.RowID das Objekt ermitteln, bei dem das Event aufgetreten ist.
OnGridCornerClick
Tritt auf, wenn bei sichtbarer RowHeader-Spalte in die linke, obere Ecke geklickt wurde.
OnGridCornerDoubleClick
Tritt auf, wenn bei sichtbarer RowHeader-Spalte doppelt in die linke, obere Ecke geklickt wurde.
OnRowClick
Tritt auf, wenn auf die Zeile geklickt wurde.
OnRowDoubleClick
Tritt auf, wenn auf die Zeile doppelt geklickt wurde.
OnRowSelectionChanged
Tritt auf, wenn sich die Selektion im Grid ändert - auch bei Deselektion von Datensätzen.
Wenn dem Grid eine SelectedRowsCollection zugeordnet ist, wird diese durch das Event aktualisiert.
OnRowsReloadEntry
Tritt auf, wenn Grid-Zeilen erstmalig an den Client übertragen werden, sowohl bei der initialien Übertragung als auch beim Nachladen von Zeilen.