ppsGrid Class Library
GridCell Class
NamespacesppsGridGridCell
ppsGrid (c] 2004-2007 by Torsten Oberprieler
Stellt eine Zelle im ppsGrid dar.
Declaration Syntax
C#Visual BasicVisual C++
public class GridCell
Public Class GridCell
public ref class GridCell
Members
All MembersMethodsProperties



IconMemberDescription
BackColorCell
Ruft die Hintergrundfarbe der Zelle ab oder legt diese fest.

BackColorCellGradient
Ruft die zweite Hintergrundfarbe der Zelle für den Farbverlauf ab oder legt diese fest.

BackColorFixed
Ruft die Hintergrundfarbe der Zelle, wenn sie fixiert ist, ab oder legt diese fest.

BackColorFixedGradient
Ruft die zweite Hintergrundfarbe der Zelle für den Farbverlauf, wenn sie fixiert ist, ab oder legt diese fest.

BackColorFocus
Ruft die Hintergrundfarbe der Zelle, wenn diese die Fokuszelle ist, ab oder legt diese fest.

BackColorHighlight
Ruft die Hintergrundfarbe für die Zelle, wenn sie markiert ist, ab oder legt diese fest.

BackColorHover
Ruft die Hintergrundfarbe der Zelle unter dem Mauszeiger für alle Zellen der Zeile ab oder legt diese fest.

CellBorderSide
Ruft die Seiten der Zelle ab, an der Randlinien gezeichnet werden, oder legt diese fest.

CellFrameColor
Ruft die Farbe ab, mit der die Rahmen der Zelle gezeichnet werden, oder legt diese fest.

CellFrameDashStyle
Ruft das Linienmuster ab, das bestimmt, wie die Zelle gezeichnet werden, oder legt dieses fest.

CellGradientMode
Ruft die Art des Farbverlaufs der Zelle ab, oder legt diesen fest.

CellPadding
Ruft die Einstellungen für den Abstand zwischen den Zellrahmen und dem Zellinhalt ab.

CellSpanId
Ruft die CellSpanId ab, die bestimmt, ob die Anzeige der Zellinhalte auf leere Nachbarzellen erweitert wird, oder legt diese fest.

ControlDisplayInfo

ControlEditInfo

Cursor
Ruft den Cursor ab, der angezeigt wird, wenn sich der Mauszeiger über der Zelle befindet, oder legt diesen fest.

Enabled
Ruft einen Wert ab, der angibt, ob die Zelle 'Enabled' (verfügbar) gezeichnet wird.

Equals(Object)
Determines whether the specified Object is equal to the current Object.
(Inherited from Object.)
Finalize()()
Allows an Object to attempt to free resources and perform other cleanup operations before the Object is reclaimed by garbage collection.
(Inherited from Object.)
FixedGradientMode
Ruft die Art des Farbverlaufs der fixierten Zelle ab, oder legt diesen fest.

Focused
Ruft einen Wert ab, der angibt, ob die Zelle den Eingabefokus besitzt.

Font
Ruft die Schriftart für die Anzeige von Text in der Zelle ab oder legt diese fest.

ForeColorCell
Ruft die Vordergrundfarbe (Textfarbe) der Zelle ab oder legt diese fest.

ForeColorFixed
Ruft die Vordergrundfarbe für die fixierte Zelle ab oder legt diese fest.

ForeColorFocus
Ruft die Vordergrundfarbe (Textfarbe) der Zelle, wenn diese die Fokuszelle ist, ab oder legt diese fest.

ForeColorHighlight
Ruft die Vordergrundfarbe (Textfarbe) für die Zelle, wenn sie markiert ist, ab oder legt diese fest.

ForeColorHover
Ruft die Textfarbe der Zelle , wenn sie unter dem Mauszeiger erscheint, ab oder legt diese fest.

FormatString
Ruft das Textformat des in der Zelle angezeigten Wertes ab oder legt dieses fest.

GetHashCode()()
Serves as a hash function for a particular type. GetHashCode()() is suitable for use in hashing algorithms and data structures like a hash table.
(Inherited from Object.)
GetType()()
Gets the Type of the current instance.
(Inherited from Object.)
Image
Ruft das in der Zelle dargestellte Bild ab oder legt dieses fest.

ImageAlignHorz
Ruft die horizontale Ausrichtung eines Bildes in der Zelle ab oder legt diese fest.

ImageAlignVert
Ruft die vertikale Ausrichtung eines Bildes in der Zelle ab oder legt diese fest.

Invalidate()()
Erklärt eine Zelle für ungültig und veranlasst, dass eine Zeichnenmeldung an das Grid gesendet wird.

MemberwiseClone()()
Creates a shallow copy of the current Object.
(Inherited from Object.)
Name
Ruft den Name der Zelle ab oder legt diesen fest.

OutlineColor
Ruft die Farbe ab, mit der die Linien für die Strukturansicht in der Zelle gezeichnet werden, oder legt diese fest.

OutlineDashStyle
Ruft das Linienmuster ab, das bestimmt, wie die Verbindungslinien der Strukturknoten gezeichnet werden, oder legt dieses fest.

ResetBackColorCell()()
Setzt die BackColorCell-Eigenschaft auf den Standardwert zurück.

ResetBackColorCellGradient()()
Setzt die BackColorCellGradient-Eigenschaft auf den Standardwert zurück.

ResetBackColorFixed()()
Setzt die BackColorFixed-Eigenschaft auf den Standardwert zurück.

ResetBackColorFixedGradient()()
Setzt die BackColorFixed-Eigenschaft auf den Standardwert zurück.

ResetBackColorFocus()()
Setzt die BackColorFocus-Eigenschaft auf den Standardwert zurück.

ResetBackColorHighlight()()
Setzt die BackColorHighlight-Eigenschaft auf den Standardwert zurück.

ResetBackColorHover()()
Setzt die BackColorHover-Eigenschaft auf den Standardwert zurück.

ResetCellFrameColor()()
Setzt die CellFrameColor-Eigenschaft auf den Standardwert zurück.

ResetCellFrameType()()
Setzt die CellFrameType-Eigenschaft auf den Standardwert zurück.

ResetFont()()
Setzt die Font-Eigenschaft auf den Standardwert 'null' zurück.

ResetForeColorCell()()
Setzt die ForeColorCell-Eigenschaft auf den Standardwert zurück.

ResetForeColorFixed()()
Setzt die ForeColorFixed-Eigenschaft auf den Standardwert zurück.

ResetForeColorFocus()()
Setzt die ForeColorFocus-Eigenschaft auf den Standardwert zurück.

ResetForeColorHighlight()()
Setzt die ForeColorHighlight-Eigenschaft auf den Standardwert zurück.

ResetForeColorHover()()
Setzt die ForeColorHover-Eigenschaft auf den Standardwert zurück.

ResetImage()()
Setzt die Image-Eigenschaft auf den Standardwert 'null' zurück.

ResetOutlineColor()()
Setzt die OutlineColor-Eigenschaft auf den Standardwert zurück.

Selected
Ruft einen Wert ab, der angibt, ob die Zelle markiert ist, oder legt diesen fest.

ShouldSerializeBackColorCellGradient()()
Ruft einen Wert ab, der angibt, ob die BackColorCellGradient-Eigenschaft beibehalten werden soll.

ShouldSerializeBackColorFixedGradient()()
Ruft einen Wert ab, der angibt, ob die BackColorFixed-Eigenschaft beibehalten werden soll.

ShouldSerializeBackColorHover()()
Ruft einen Wert ab, der angibt, ob die BackColorHover-Eigenschaft beibehalten werden soll.

ShouldSerializeForeColorHover()()
Ruft einen Wert ab, der angibt, ob die ForeColorHover-Eigenschaft beibehalten werden soll.

StringAlignHorz
Ruft die horizontale Ausrichtung von Text in der Zelle ab oder legt diese fest.

StringAlignVert
Ruft die vertikale Ausrichtung von Texten in der Zelle ab oder legt diese fest.

StringTrimming
Gibt an, wie Zeichen in einer Zeichenfolge gekürzt werden, die nicht vollständig in die Zelle passt.

Tag
Ruft das Objekt ab, das benutzerdefinierte Daten über die Zelle enthält, oder legt dieses fest.

Text
Ruft den dieser Zelle zugeordneten Wert als textuelle Information ab.

ToolTipText
Ruft den QuickInfo-Text ab, der angezeigt wird, wenn mit dem Mauszeiger auf die Zelle gezeigt wird, oder legt diesen fest.

ToString()()
Returns a String that represents the current Object.
(Inherited from Object.)
Value
Ruft den Wert ab, der der Zelle zugeordnet ist, oder legt diesen fest.

Remarks
Das ppsGrid erlaubt den Programmierer über die Cells-Auflistung den Zugriff auf alle Zellen des Grid, über das GridCol auf alle Zellen einer Spalte und über das GridRow auf alle Zellen einer Zeile.

Beispiel:
CopyC#
Grid grd = new Grid();
grd.AddCols(10);                                    // fügt 10 Spalten ein
grd.AddRows(20);                                    // fügt 20 Zeilenm ein

for(int c=0; c < grd.Cols.Count;c++)                // alle Spalten..
  for(int r=0; r < grd.Rows.Count;r++){             // ..alle Zeilen
    grd.Cells[c,r].Value = ...;                     // ....Zugriff über die Cells-Auflistung
    grd[c,r].Value = ...;                           // ....gleichbedeutend
  }

foreach(GridCol col in grd.Cols)                    // Möglichkeit: alle Spalten..
  col[3].Value = ...;                               // ..Zugriff auf Zelle über Col-Objekt

foreach(GridRow row in grd.Rows)                    // Möglichkeit: Alle Zeilen..
  row[2].Value = ...;                               // ..Zugriff auf Zelle über Row-Objekt


Die Zelle ist im Steuerelement die kleinste Informationseinheit. Ausschließlich sie speichert alle anzuzeigenden Value. Die Ausgabe der Daten wird durch mehrere Eigenschaften unterstützt. Die Zelle hat für alle ambienten Eigenschaften im Grid die höchste Priorität aller Objekte (Grid, GridCol, GridRow); soll heißen: Wenn für die Zelle eine Eigenschaft gesetzt wurde, kann kein anderes Objekt die Ausgabe dafür verhindern oder verändern.

Beispiel:
CopyC#
grid[0,0].BackColorCell = Color.Yellow;              // gelbe Zelle
grid.Cols[0].BackColorCell = Color.Blue;             // blaue Spalte
grid.Rows[0].BackColorCell = Color.Red;              // rote Zeile
grid.BackColorCell = Color.White;                    // weißes Grid


Zu den wichtigsten Eigenschaften der Zelle gehört die Value-Eigenschaft (Benutzerdaten). Der Type dieser Eigenschaft ist Object. Somit können Sie Instanzen von jeder Klasse der Eigenschaft Value zuweisen. Normalerweise würde man hier wohl einfache Texte oder Zahlenwerte setzen. Bedingung ist das aber nicht. Wie letztendlich die Value-Eigenschaft dargestellt wird, hängt vor allem von der FormatString-Eigenschaft ab. Sie formatiert die Value-Eigenschaft zu einer darstellbaren Zeichenfolge. Weitere Möglichkeiten, die Darstellung der Zelle zu bestimmen, bieten die Eigenschaften für Farben, Schriftart, Ausrichtung, Abstände, Rahmen und vieles mehr.

Beispiel:
CopyC#
grid[0,0].BackColorCell = Color.Yellow;             // Hintergrundfarbe
grid[0,0].ForeColorCell = Color.Blue;               // Vordergrundfarbe (Textfarbe)
grid[0,0].BackColorHighlight = Color.Red;           // Hintergrundfarbe, wenn markiert
grid[0,0].Value = "Hallo Welt";                     // Wert der Zelle, Zeichenfolge
grid[0,0].Value = 123.45;                           // ..Fließkommazahl
grid[0,0].Value = DateTime.Now;                     // ..Datum
grid[0,0].FormatString = "dd.MM.yyyy";              // Formatierung von Value, Datumsformat
grid[0,0].FormatString = "C";                       // ..Währungsformat
grid[0,0].Font = new Font("Arial", 10);             // Schriftart
grid[0,0].StringAlignHorz = eContentAlign.Far;      // Textausrichtung rechts
grid[0,0].Image = new Bitmap(@"c:\tux.jpg");        // Abbildung
grid[0,0].ImageAlignHorz = eContentAlign.Far;       // Abbildung horz. Ausrichtung
Inheritance Hierarchy
Object
GridCell
See Also

Assembly: ppsGrid (Module: ppsGrid) Version: 1.3.4.0