ppsGrid Class Library
BackColorHighlight Property
NamespacesppsGridGridCellBackColorHighlight
ppsGrid (c] 2004-2007 by Torsten Oberprieler
Ruft die Hintergrundfarbe für die Zelle, wenn sie markiert ist, ab oder legt diese fest.
Declaration Syntax
C#Visual BasicVisual C++
public Color BackColorHighlight{ get; set;}
Public Property BackColorHighlight As Color
public:
property Color BackColorHighlight {
	Color get ();
	void set (Color value);
}
Value
Eine Color, die die Hintergrundfarbe darstellt, wenn die Zelle markiert ist. Der Standardwert ist der Wert Empty.
Remarks
Diese Eigenschaft ist ambient. Die Berechnung der Hintergrundfarbe einer markierten Zelle wird durch die Objekte Grid, GridRow, GridCol und GridCell wie folgt bestimmt:

Priorität, Objekt, EigenschaftBeschreibung
Höchste Priorität
GridCell.BackColorHighlight
Hat die Hintergrundfarbe der markierten Zelle einen Wert ungleich Empty, wird in jedem Fall diese Farbe benutzt.
Hohe Priorität
GridRow.BackColorHighlight
Hat die BackColorHighlight einen Wert ungleich Color.Empty, wird diese Farbe benutzt, wenn die Hintergrundfarbe der markierten Zelle den Wert Color.Empty hat.
Mittlere Priorität
GridCol.BackColorHighlight
Hat die BackColorHighlight einen Wert ungleich Color.Empty, wird diese Farbe benutzt, wenn die Hintergrundfarbe der markierten Zelle und die Hintergrundfarbe für markierte Zellen der Zeile den Wert Color.Empty haben.
Niedrigste Priorität
Grid.BackColorHighlight
Hat die BackColorHighlight einen Wert ungleich Color.Empty, wird diese Farbe benutzt, wenn die Hintergrundfarbe der markierten Zelle, die Hintergrundfarbe für markierte Zellen der Zeile und die Hintergrundfarbe für markierte Zellen der Spalte den Wert Color.Empty haben.


Examples
Beispiel 1:
CopyC#
grid.SelectionType = eSelectionType.Free;                 // frei Markieren
grid.Cells[0,0].BackColorHighlight = Color.Yellow;        // gelbe Zelle
grid.Cols[0].BackColorHighlight = Color.Blue;             // blaue Spalte
grid.Rows[0].BackColorHighlight = Color.Red;              // rote Zeile
grid.BackColorHighlight = Color.White;                    // weißes Grid

Obwohl die Hintergrundfarbe der Zelle ([0,0] = links oben) von allen anderen Objekten überschrieben wird, bleibt der Hintergrund dieser Zelle gelb (wenn sie markiert ist), weil das Zellenobjekt für die Darstellung immer die höchste Priorität genießt. Die Reihenfolge, wie die Eigenschaften gesetzt werden, spielt dabei keine Rolle.


Beispiel 2:
CopyC#
Random  rnd=new Random();
grid.Scrollbar = eScrollbar.Both;                                  // ohne Bildlaufleisten
grid.SelectionType = eSelectionType.Free;                          // ohne Markieren
grid.AddCols(11);                                                  // 10 Spalten einfügen
grid.AddRows(11);                                                  // ..und 10 Zeilen
grid.Cols[0].Fixed=true;
grid.Rows[0].Fixed=true;

for(int cl=grid.FixedColCount; cl<grid.Cols.Count; cl++){          // alle Spalten
  grid.Cols[cl].Width=25;                                          // ..schmal
  for(int rw=grid.FixedRowCount; rw<grid.Rows.Count; rw++){        // ..alle zeilen
    int r = rnd.Next(255), g = rnd.Next(255), b = rnd.Next(255);   // ....Zufallfarbe
    grid[cl,rw].BackColorHighlight = Color.FromArgb(r,g,b);        // ....Farbe setzen
  }
}

Das zweite Beispiel zeigt den Zugriff auf die Eigenschaft BackColorCell mittels zweier Schleifen. Die Farbe wird durch drei Zufallszahlen erzeugt.
See Also

Assembly: ppsGrid (Module: ppsGrid) Version: 1.3.4.0