ppsGrid Class Library
StringTrimming Property
NamespacesppsGridGridCellStringTrimming
ppsGrid (c] 2004-2007 by Torsten Oberprieler
Gibt an, wie Zeichen in einer Zeichenfolge gekürzt werden, die nicht vollständig in die Zelle passt.
Declaration Syntax
C#Visual BasicVisual C++
public StringTrimming StringTrimming{ get; set;}
Public Property StringTrimming As StringTrimming
public:
property StringTrimming StringTrimming {
	StringTrimming get ();
	void set (StringTrimming value);
}
Value
Ein StringTrimming-Wert, der bestimmt, ob und wie die Zeichenfolge gekürzt wird, wenn sie nicht vollständig in die Zelle passt. Der Standardwert ist None.
Remarks
Für die Kürzung der Zellentexte können Sie die Werte wie folgt verwenden:
Character
Verkürzt die Zeichenfolge zum nächstliegenden Zeichen.
EllipsisCharacter
Wie zuvor, hängt ein Auslassungszeichen("...") an.
Word
Verkürzt die Zeichenfolge zum nächstliegenden Wort.
EllipsisWord
Wie zuvor, hängt ein Auslassungszeichen("...") an.
EllipsisPath
Verkürzt die Zeichenfolge in der Mitte und fügt ein Auslassungszeichen("...") ein.
None
Die Kürzung von Zellentext wird bestimmt von der übergeordneten Klasse (Grid, GridRow, GridCol).


Informationen zur Kürzung von Zellentexte finden Sie auch unter StringTrimming. Beachten Sie bei der Kürzung der Texte die aktuellen CellPadding der Zelle.

Diese Eigenschaft ist ambient. Die Kürzungsart der Texte in den Zellen wird durch die Klassen Grid, GridRow, GridCol und GridCell wie folgt bestimmt:

Priorität, Klasse, EigenschaftBeschreibung
Höchste Priorität
GridCell.StringTrimming
Hat die Kürzungsart der Zelle einen Wert ungleich None, wird in jedem Fall diese Kürzungsart benutzt.
Hohe Priorität
GridRow.StringTrimming
Hat die StringTrimming einen Wert ungleich None, wird diese Kürzungsart benutzt, wenn die Kürzungsart der Zelle den Wert None hat.
Mittlere Priorität
GridCol.StringTrimming
Hat die StringTrimming einen Wert ungleich None, wird diese Kürzungsart benutzt, wenn die Kürzungsart der Zelle und der Zeile den Wert None haben.

Niedrigste Priorität
Grid.StringTrimming
Hat die StringTrimming einen Wert ungleich None, wird diese Kürzungsart benutzt, wenn die Kürzungsart der Zelle, der Zeile und der Spalte den Wert None haben.


Examples
CopyC#
grid.Scrollbar = eScrollbar.Vertical;                             // Bildlaufleiste vertikal
grid.SelectionType = eSelectionType.None;                         // keine Markierungen
grid.AddCols(5);                                                  // fünf Spalten
grid.AddRows(100);                                                // ..und 100 Zeilen
grid.Rows[0].Fixed = true;                                        // ..erste ist fixiert

grid.Cols[0].StringTrimming = StringTrimming.Character;           // kürzen buchstabenweise
grid.Cols[1].StringTrimming = StringTrimming.Word;                // ...wortweise
grid.Cols[2].StringTrimming = StringTrimming.EllipsisCharacter;   // ...buchstabenweise, mit "..."
grid.Cols[3].StringTrimming = StringTrimming.EllipsisWord;        // ...wortweise, auch mit "..."
grid.Cols[4].StringTrimming = StringTrimming.EllipsisPath;        // ...in der Mitte, mit "..."

foreach(GridCol c in grid.Cols)                                   // alle Spalten...
  c[0].Value = c.StringTrimming.ToString();                       // ..Titel anzeigen

for(int x=grid.FixedColCount; x<grid.Cols.Count; x++)             // alle Spalten
  for(int y=grid.FixedRowCount; y<grid.Rows.Count; y++)           // ..alle Zeilen
    grid.Cells[x,y].Value = RandomString(rnd,32);                 // ....Zelle mit Zufallstext
...
...
private string RandomString(Random rnd, int max){                 // kleine Methode: Zufallstext
  int     cnt = rnd.Next(max);                                    // Länge des Textes
  byte[]  bff = new byte[max];                                    // Buffer bereitstellen

  for(int i=0; i<cnt; i++){                                       // über gesamten Buffer
    bff[i] = (byte)rnd.Next(97, 97+26);                           // ..Buchstaben per Zufall
    if(rnd.Next(8)==0 && i>0 && i<cnt-1)                          // ....evtl. Leerzeichen
      bff[i]=32;                                                  // ......einfügen
  }
  return(Encoding.ASCII.GetString(bff, 0, cnt));                  // Zufallstext zurück
}

Das Beispiel erzeugt eine Tabelle mit Zufallstexten. Verändern Sie die Spaltenbreiten, um die Arbeitsweise der verschiedenen "Trimming"-Methoden zu vergleichen.
See Also

Assembly: ppsGrid (Module: ppsGrid) Version: 1.3.4.0