ppsGrid Class Library
CellSpanId Property
NamespacesppsGridGridCellCellSpanId
ppsGrid (c] 2004-2007 by Torsten Oberprieler
Ruft die CellSpanId ab, die bestimmt, ob die Anzeige der Zellinhalte auf leere Nachbarzellen erweitert wird, oder legt diese fest.
Declaration Syntax
C#Visual BasicVisual C++
public int CellSpanId{ get; set;}
Public Property CellSpanId As Integer
public:
property int CellSpanId {
	int get ();
	void set (int value);
}
Value
Ein Int32, der die CellSpanId für die Zelle angibt.
Remarks
Eine Zelle kann, wenn sein angezeigter Wert nicht in den Grenzen der Zelle angezeigt werden kann, auf die Nachbarzellen erweitert gezeichnet werden. Voraussetzung dafür ist, daß diese die gleiche CellSpanId hat wie die Ursprungszelle. Die Richtung, in der erweitert wird, ist abhängig von der eigenen Ausrichtung. Linksbündige Ausrichtung erweitert nach rechts, rechtsbündige Ausrichtung nach links und zentrierte Ausrichtung erweitert in beide Richtungen. Eine Erweiterung auf die Nachbarzellen findet nur statt, wenn diese leer sind (Text = "") und die CellspanID-Werte gleich sind. Alle Einstellungen der Zelle (Farbe, Schriftart, Ausrichtung usw. werden von der Ursprungszelle für den Zeitpunkt der Ausgabe übernommen. Beachten Sie bitte auch, daß die CellSpan-Funktionalität im Steuerlement eingeschaltet sein muß (CellSpan).

Diese Eigenschaft ist ambient. Die Berechnung der CellSpanId einer Zelle wird durch die Objekte GridCol, GridRow und GridCell bestimmt.
Die CellSpanId einer Zelle bestimmt sich wie folgt:

Priorität, Objekt, EigenschaftBeschreibung
Höchste Priorität
GridCell.CellSpanId
Hat die CellSpanId der Zelle einen Wert ungleich 0, wird in jedem Fall diese ID benutzt.
Hohe Priorität
GridRow.CellSpanId
Hat die CellSpanId einen Wert ungleich 0, wird diese ID benutzt, wenn die ID der Zelle den Wert 0 hat.
Mittlere Priorität
GridCol.BackColorCell
Hat die CellSpanId einen Wert ungleich 0, wird diese ID benutzt, wenn die ID der Zelle und der Zeile den Wert 0 haben.


Examples
Das nachfolgende Beispiel soll die Arbeitsweise der CellSpanId-Eigenschaft verdeutlichen. Es werden 10 schmale Spalten erzeugt, die mittels gleicher CellSpanId 'verbunden' sind. Die Zellen(8,1) und (1,2) bekommen eine andere CellSpanId, weshalb die Zellenerweiterung hier jeweils endet. Wenn Sie die Spaltenbreite in der fixierten Zeile ändern, können Sie den Effekt der Zellenerweiterung gut beobachten.

CopyC#
grid.Scrollbar = eScrollbar.None;                                // ohne Bildlaufleisten
grid.SelectionType = eSelectionType.None;                        // ohne Markieren
grid.CellPadding.All = 0;                                        // alle Zellen ohne Abstand
grid.CellSpan = true;                                            // CellSpan anschalten

grid.AddCols(10);                                                // 10 Spalten
grid.AddRows(3);                                                 // 2 Zeilen
grid.Rows[0].Fixed = true;                                       // Zeile 'fixed', für Weite ändern
grid.Rows[1].CellSpanId = 1;                                     // ganze zeile selbe ID
grid.Rows[2].CellSpanId = 1;                                     // ..untere Zeile auch

foreach(GridCol c in grid.Cols)                                  // alle Spalten
  c.Width=24;                                                    // ..relativ schmal

grid[0,1].Value = "Xaver jagt im Taxi quer durch Bayern";        // wert für Zeile 1
grid[0,1].StringAlignHorz = eContentAlign.Near;                  // ..linksbündig
grid[0,1].BackColorCell = Color.Yellow;                          // ..gelber Hintergrund
grid[9,2].Value = "The quick brown fox jump over the lazy dog";  // wert für Zeile 2
grid[9,2].StringAlignHorz = eContentAlign.Far;                   // ..rechtsbündig
grid[9,2].BackColorCell = Color.Yellow;                          // ..gelber Hintergrund

grid[8,1].CellSpanId = 2;                                        // 'Begrenzung' für Zeile 1
grid[1,2].CellSpanId = 2;                                        // ..und Zeile 2

Assembly: ppsGrid (Module: ppsGrid) Version: 1.3.4.0