Zweck
Ermittelt verschiedene Einstellungen von Datenspalten.
Klasse
Typ
Methode
Syntax
<oBrowser>:GetFormatFromColumns(
<iOptions>,
[<auColumn>]
) Æ auFormat
Argumente
<iOptions> | Die Optionen definieren die Spalten und deren Einstellungen, die ermittelt werden sollen. Mehrere Optionen können kombiniert werden. Folgende Optionen werden unterstützt: |
Option |
Beschreibung |
Name im Rückgabe-Array |
BGFFCO_NONE |
Es werden keine Einstellungen aus den Datenspalten zurückgegeben. Der Rückgabewert ist ein leeres Array. |
|
BGFFCO_ALLCOLUMNS |
Es werden Einstellungen zu allen unterstützten Datenspalten (siehe bBrowser:ColumnList) zurückgegeben. |
|
BGFFCO_OPENCOLUMNS |
Es werden Einstellungen zu allen geöffneten Datenspalten (siehe bBrowser:ColumnOpenList) zurückgegeben. |
|
BGFFCO_FORMAT_AUTOEDIT |
Gibt den Wert aus dem Zugriff bDataColumn:AutoEdit zurück. |
#AutoEdit |
BGFFCO_FORMAT_CAPTION |
Gibt den Wert aus dem Zugriff bDataColumn:Caption zurück. |
#Caption |
BGFFCO_FORMAT_CAPTIONVIEW |
Gibt den Wert aus dem Zugriff bBrowserColumn:CaptionView zurück. |
#CaptionView |
BGFFCO_FORMAT_CAPTIONVISIBLE |
Gibt den Wert aus dem Zugriff bBrowserColumn:CaptionVisible zurück. |
#CaptionVisible |
BGFFCO_FORMAT_DATAVIEW |
Gibt den Wert aus dem Zugriff bBrowserColumn:DataView zurück. |
#DataView |
BGFFCO_FORMAT_EDITABLE |
Gibt den Wert aus dem Zugriff bDataColumn:Editable zurück. |
#Editable |
BGFFCO_FORMAT_EDITCLOSEFLAGS |
Gibt den Wert aus dem Zugriff bDataColumn:EditCloseFlags zurück. |
#EditCloseFlags |
BGFFCO_FORMAT_EDITSTARTFLAGS |
Gibt den Wert aus dem Zugriff bDataColumn:EditStartFlags zurück. |
#EditStartFlags |
BGFFCO_FORMAT_FIELDSPEC |
Gibt den Wert aus dem Zugriff bDataColumn:FieldSpec zurück. |
#FieldSpec |
BGFFCO_FORMAT_FOOTER |
Gibt den Wert aus dem Zugriff bBrowserColumn:Footer zurück. |
#Footer |
BGFFCO_FORMAT_FOOTERVIEW |
Gibt den Wert aus dem Zugriff bBrowserColumn:FooterView zurück. |
#FooterView |
BGFFCO_FORMAT_FOOTERVISIBLE |
Gibt den Wert aus dem Zugriff bBrowserColumn:FooterVisible zurück. |
#FooterVisible |
BGFFCO_FORMAT_HEIGHTVARIABLE |
Gibt den Wert aus dem Zugriff bDataColumn:HeightVariable zurück. |
#HeightVariable |
BGFFCO_FORMAT_MOVABLE |
Gibt den Wert aus dem Zugriff bBrowserColumn:Movable zurück. |
#Movable |
BGFFCO_FORMAT_RESIZABLE |
Gibt den Wert aus dem Zugriff bBrowserColumn:Resizable zurück. |
#Resizable |
BGFFCO_FORMAT_SELECTABLE |
Gibt den Wert aus dem Zugriff bDataColumn:Selectable zurück. |
#Selectable |
BGFFCO_FORMAT_SUSPENDEMPTYVALUES |
Gibt den Wert aus dem Zugriff bDataColumn:SuspendEmptyValues zurück. |
#SuspendEmptyValues |
BGFFCO_FORMAT_TEXTFORMAT |
Gibt den Wert aus dem Zugriff bDataColumn:TextFormat zurück. |
#TextFormat |
BGFFCO_FORMAT_TOOLTIPTEXT |
Gibt den Wert aus dem Zugriff bDataColumn:TooltipText zurück. |
#TooltipText |
BGFFCO_FORMAT_VALUETRANSFORMLIST |
Gibt den Wert aus dem Zugriff bDataColumn:ValueTransformList zurück. |
#ValueTransformList |
BGFFCO_FORMAT_VIEWEMPTYVALUEAS |
Gibt den Wert aus dem Zugriff bDataColumn:ViewEmptyValuesAs zurück. |
#ViewEmptyValuesAs |
BGFFCO_FORMAT_VIEWVALUEAS |
Gibt den Wert aus dem Zugriff bDataColumn:ViewValueAs zurück. |
#ViewValueAs |
BGFFCO_FORMAT_WIDTH |
Gibt den Wert aus dem Zugriff bBrowserColumn:Width zurück. |
#Width |
BGFFCO_FORMAT_WIDTHMAX |
Gibt den Wert aus dem Zugriff bDataColumn:WidthMax zurück. |
#WidthMax |
BGFFCO_FORMAT_WIDTHMIN |
Gibt den Wert aus dem Zugriff bDataColumn:WidthMin zurück. |
#WidthMin |
BGFFCO_FORMATSETTINGS_CAPTION |
Kombination aller Optionen, die sich auf die Einstellungen der Spaltenbezeichnung einer Datenspalte beziehen. Dies sind die folgenden Optionen: •BGFFCO_FORMAT_CAPTION •BGFFCO_FORMAT_CAPTIONVIEW •BGFFCO_FORMAT_CAPTIONVISIBLE |
|
BGFFCO_FORMATSETTINGS_DATA |
Kombination aller Optionen, die sich auf die Einstellungen der Spaltendaten einer Datenspalte beziehen. Dies sind die folgenden Optionen: •BGFFCO_FORMAT_DATAVIEW •BGFFCO_FORMAT_SUSPENDEMPTYVALUES •BGFFCO_FORMAT_TEXTFORMAT •BGFFCO_FORMAT_VALUETRANSFORMLIST •BGFFCO_FORMAT_VIEWEMPTYVALUEAS •BGFFCO_FORMAT_VIEWVALUEAS |
|
BGFFCO_FORMATSETTINGS_FOOTER |
Kombination aller Optionen, die sich auf die Einstellungen des Spaltenfußes einer Datenspalte beziehen. Dies sind die folgenden Optionen: •BGFFCO_FORMAT_FOOTER •BGFFCO_FORMAT_FOOTERVIEW •BGFFCO_FORMAT_FOOTERVISIBLE |
|
BGFFCO_FORMATSETTINGS_GENERAL |
Kombination aller Optionen, die sich auf die allgemeinen Einstellungen einer Datenspalte beziehen. Dies sind die folgenden Optionen: •BGFFCO_FORMAT_AUTOEDIT •BGFFCO_FORMAT_EDITABLE •BGFFCO_FORMAT_EDITCLOSEFLAGS •BGFFCO_FORMAT_EDITSTARTFLAGS •BGFFCO_FORMAT_FIELDSPEC •BGFFCO_FORMAT_HEIGHTVARIABLE •BGFFCO_FORMAT_MOVABLE •BGFFCO_FORMAT_RESIZABLE •BGFFCO_FORMAT_SELECTABLE •BGFFCO_FORMAT_TOOLTIPTEXT •BGFFCO_FORMAT_WIDTH •BGFFCO_FORMAT_WIDTHMAX •BGFFCO_FORMAT_WIDTHMIN |
Datentyp: | DWord |
<auColumn> | Array mit den Datenspalten, zu denen die Einstellungen ermittelt werden sollen. Für eine Datenspalte kann entweder dessen Namen als String oder Symbol oder das Spaltenobjekt angegeben werden. Das Argument wird nur berücksichtigt, wenn keine der beiden Optionen BGFFCO_ALLCOLUMNS oder BGFFCO_OPENCOLUMNS im Argument iOptions definiert ist. |
Datentyp: | Array |
Rückgabewert
auFormat | Array mit den ermittelten Einstellungen zu den Datenspalten. Jedes Array-Element besteht aus einem Array mit zwei Elementen. Das erste Element enthält den Namen der Datenspalte als Symbol. Das zweite Element ist ein Objekt der Klasse bNameArray und enthält die ermittelten Einstellungen zu der Datenspalte. |
Datentyp: | Array |
Beschreibung
bBrowser:GetFormatFromColumns() ermittelt verschiedene Einstellungen zu Datenspalten im Browser. Zu jeder Datenspalte kann eine oder mehrere Einstellungen ermittelt werden.
Anmerkungen
Mit Hilfe der Methode können beispielsweise alle wichtigen Einstellungen der geöffneten Datenspalten ermittelt und anschließend gespeichert werden, um diese beim nächsten Anzeigen des Browsers wiederherzustellen. Der Rückgabewert der Methode kann der Methode bBrowser:FormatColumns() übergeben werden.
Beispiele
In dem folgenden Beispiel werden einige Eigenschaften aller unterstützter Datenspalten aus einem bBrowser ermittelt und in einen String konvertiert. Dieser könnte anschließend in eine Datei gespeichert werden, um ihn zu einem späteren Zeitpunkt wieder zu laden.
LOCAL cSettings AS STRING
LOCAL iOptions AS DWORD
LOCAL auSettings AS ARRAY
LOCAL onaFormat AS bNameArray
LOCAL iColPos AS DWORD
LOCAL iColCount AS DWORD
LOCAL iPos, iCount AS DWORD
iOptions := _Or(BGFFCO_ALLCOLUMNS,;
BGFFCO_FORMAT_EDITABLE,;
BGFFCO_FORMAT_EDITCLOSEFLAGS,;
BGFFCO_FORMAT_EDITSTARTFLAGS,;
BGFFCO_FORMAT_WIDTH,;
BGFFCO_FORMAT_WIDTHMAX,;
BGFFCO_FORMAT_WIDTHMIN)
auSettings := oBrowser:GetFormatFromColumns(iOptions)
cSettings := ""
iColCount := ALen(auSettings)
FOR iColPos := 1 upto iColCount
cSettings += "Name=" + Symbol2String(auSettings[iColPos, 1])
onaFormat := auSettings[iColPos, 2]
iCount := onaFormat:Count
FOR iPos := 1 upto iCount
cSettings += "," + Symbol2String(onaFormat:GetName(iPos)) + "=" + AsString(onaFormat:Get(iPos))
NEXT
cSettings += CRLF
NEXT
Siehe auch
Page url: http://www.YOURSERVER.com/index.html?bbrowser_getformatfromcolumns.htm