ppsGrid Class Library
FormatString Property
NamespacesppsGridGridCellFormatString
ppsGrid (c] 2004-2007 by Torsten Oberprieler
Ruft das Textformat des in der Zelle angezeigten Wertes ab oder legt dieses fest.
Declaration Syntax
C#Visual BasicVisual C++
public string FormatString{ get; set;}
Public Property FormatString As String
public:
property String^ FormatString {
	String^ get ();
	void set (String^ value);
}
Value
Eine String, der die Formatierung der Value-Eigenschaft bestimmt. Der Standardwert ist null (nothing in Visual Basic).
Remarks
Diese Eigenschaft bestimmt die Formatierung der Value-Eigenschaft.
Die Eigenschaft ist ambient. Die Bestimmung des Textformat der Zelle wird durch die Klassen Grid, GridRow, GridCol und GridCell bestimmt.

Das Textformat einer Zelle bestimmt sich wie folgt:

Priorität, Klasse, EigenschaftBeschreibung
Höchste Priorität
GridCell.FormatString
Hat das Format der Zelle einen Wert ungleich null, wird in jedem Fall dieses Format benutzt.
Hohe Priorität
GridRow.FormatString
Hat das FormatString einen Wert ungleich null, wird dieses Format benutzt, wenn das Format der Zelle den Wert null hat.
Mittlere Priorität
GridCol.FormatString
Hat das FormatString einen Wert ungleich null, wird dieses Format benutzt, wenn die Formate der Zelle und der Zeile den Wert null haben.

Niedrigste Priorität
Grid.FormatString
Hat das FormatString einen Wert ungleich null, wird dieses Format benutzt, wenn die Formate der Zelle, der Zeile und der Spalte den Wert null haben.


Examples
Das nachfolgende Beispiel soll die Arbeitsweise der FormatString-Eigenschaft verdeutlichen. Es werden 10 Spalten und 10 Zeilen erzeugt. Alle Zellen bekommen den selben Wert (hier: aktuelle Datum) zugewiesen. Das Standardformat im Steuerelement ist "dd.MM". Jede andere Definition durch das Spalten-, Zeilen- oder Zellenobjekt ändert diese Einstellung. Die drei linken Spalten bekommen das Format "ddd", die drei oberen Zeilen das Format "MMM". Zum Schluß werden die 2x2 Zellen links oben auf das "hh:mm" gesetzt.
An dem Beispiel läßt sich gut erkennen, ob und wie die Formate dargestellt werden. Das Format vom Steuerelement wird nur dort gezeichnet, wo kein anderes Objekt zeichnet. Das Format der Spalten wird vom Format der Zeilen überzeichnet, welche wiederum von den Format der Zellen überzeichnet werden.

CopyC#
grid.Scrollbar = eScrollbar.None;                 // ohne Bildlaufleisten
grid.SelectionType = eSelectionType.None;         // ohne Markieren
grid.AddCols(10);                                 // 10 Spalten einfügen
grid.AddRows(10);                                 // ..und 10 Zeilen

foreach(GridCol col in grid.Cols)                 // alle Spalten
  col.Width=44;                                   // ...Breite einstellen

for(int c=0; c<grid.Cols.Count; c++)              // alle Zellen
  for(int r=0; r<grid.Rows.Count; r++)            // ..haben..
    grid[c,r].Value = DateTime.Now;               // ....gleichen Wert

grid.FormatString = "dd.MM";                      // Datumformat für das Grid
for(int c=0; c<2; c++)                            // die 2x2 Zellen
  for(int r=0; r<2; r++)                          // ..links oben
    grid[c,r].FormatString = "hh:mm";             // ....haben Zeitformat
for(int c=0; c<3; c++)                            // die ersten 3 Zeilen oben
  grid.Rows[c].FormatString = "MMM";              // ..abgekürzten Monat
for(int c=0; c<3; c++)                            // die ersten 3 Spalten links
  grid.Cols[c].FormatString = "ddd";              // ..abgekürzten Tag

Assembly: ppsGrid (Module: ppsGrid) Version: 1.3.4.0