PC SOFT

ONLINE HELP
FOR WINDEV, WEBDEV AND WINDEV MOBILE

Home | Sign in | English US

  • Order of items
  • Displaying the result in a list box or in a combo box
  • HFSQL type
WINDEV
WindowsLinuxUniversal Windows 10 AppJavaReports and QueriesUser code (UMC)
WEBDEV
WindowsLinuxPHPWEBDEV - Browser code
WINDEV Mobile
AndroidAndroid Widget iPhone/iPadApple WatchUniversal Windows 10 AppWindows Mobile
Others
Stored procedures
Returns the list of items:
  • found in a data file ( a query or a view) known to the HFSQL engine. The data files defined by HDeclare, HDeclareExternal and HDescribeFile are taken into account.
  • Versions 19 and later
    WINDEVWEBDEV - Server codeWindows Mobile found in a Record variable.
    New in version 19
    WINDEVWEBDEV - Server codeWindows Mobile found in a Record variable.
    WINDEVWEBDEV - Server codeWindows Mobile found in a Record variable.
Versions 15 and later
Android This function is now available for the Android applications.
New in version 15
Android This function is now available for the Android applications.
Android This function is now available for the Android applications.
Versions 17 and later
iPhone/iPad This function is now available for the iPhone/iPad applications.
New in version 17
iPhone/iPad This function is now available for the iPhone/iPad applications.
iPhone/iPad This function is now available for the iPhone/iPad applications.
Versions 18 and later
Android Widget This function is now available in Android Widget mode.
Universal Windows 10 App This function is now available in Windows Store apps mode.
Stored procedures This function is now available in the code of stored procedures.
New in version 18
Android Widget This function is now available in Android Widget mode.
Universal Windows 10 App This function is now available in Windows Store apps mode.
Stored procedures This function is now available in the code of stored procedures.
Android Widget This function is now available in Android Widget mode.
Universal Windows 10 App This function is now available in Windows Store apps mode.
Stored procedures This function is now available in the code of stored procedures.
Versions 21 and later
Universal Windows 10 App This function is now available in Universal Windows 10 App mode.
New in version 21
Universal Windows 10 App This function is now available in Universal Windows 10 App mode.
Universal Windows 10 App This function is now available in Universal Windows 10 App mode.
Note: From version 19, HFSQL is the new name of HyperFileSQL.
// Retrieve the items of a file found in the current analysis
ItemList is string
ItemList = HListItem(CUSTOMER, hLstDétail)

// Adds the list of items into COMBO_COMBO1
ListAdd(COMBO_COMBO1, ItemList)
// Run a "SELECT *" query and interrogate the items
dsListCITY is Data Source
sListItm is string
sRecContent is string
sQry is string = "SELECT * FROM ZIPCODES WHERE ZIPCODE ='34000'"

// Run the query
HExecuteSQLQuery(dsListCITY, hQueryDefault, sQry)
// List the items of the query.
sListItm = HListItem(dsListCITY)

// Browse the query
FOR EACH dsListCITY
sRecContent = ""
// The items must be browsed for each record
FOR EACH STRING sAnItem OF sListItm SEPARATED BY CR
sRecContent += {"dsListCITY." + sAnItem, indItem}
END
Info("Content of the record: " + sRecContent)
END
Syntax

Listing the items of a data file Hide the details

<Result> = HListItem(<File Name> [, <Path of WDD> [, <Password of WDD> [, <Options>]]])
<Result>: Character string
List of items found in the specified data file. The descriptions of each item are separated by CR characters (Carriage Return). The result is more or less detailed depending on the constant used:
hLstDetail is not specified<Name of Item 1> + CR + <Name of Item 2> + CR +...
hLstDetail is specified<Name of Item 1> + TAB + <Type> + TAB + <HFSQL Type> + TAB + <Size> + TAB + <Number of Subscripts> + TAB + <Caption> + CR +...
hLstDetailPlus<Name of Item 1> + TAB + <Type> + TAB + <HFSQL Type> + TAB + <Size> + TAB + <Number of Subscripts> + TAB + <Caption> + TAB + <Integer Part of Numeric Items> + TAB + <Decimal Part of Numeric Items> + CR +...
Where:
  • <Name of Item X>: Name of item
  • <Type>: Type of item: "T" for text (and currency) or "N" for numeric
  • <HFSQL Type>: HFSQL type of item. See the Notes for more details.
  • <Size>: Size of the item
  • <Number of Subscripts>: Number of elements in the array
  • <Caption>: Caption of item.
  • <Integer Part of Numeric Items>: Number of digits in the integer part of numeric items
  • <Decimal Part of Numeric Items>: Number of digits in the decimal part of numeric items
Java In Java, <Caption> corresponds to the name of item.
<File Name>: Character string (with or without quotes)
Name of data file (query or view) whose items will be listed.
If a query name is specified, this query must be currently run (HExecuteQuery or HExecuteSQLQuery) in order for HListItem to operate. Otherwise, a WLanguage error occurs.
<Path of WDD>: Optional character string
Full path of analysis (.WDD file) where the data file is described. If this parameter is not specified or if it is equal to an empty string (""), the data file is sought in the current analysis.
Java This parameter is ignored. The data file is sought in the current analysis.
<Password of WDD>: : Optional character string
Password defined for the analysis. If no password is defined, this parameter must be equal to an empty string ("").
Java This parameter is ignored.
<Options>: Optional Integer constant (or combination of constants)
Configures the type of list to perform:
hLstNormal
(default value)
Corresponds to hLstItem + hLstMemo + hLstKey
hLstKeyLists the key items (non-composite keys only)
Hyper File 5.5 This constant is ignored.
hLstCompositeKeyLists the composite key items only
Hyper File 5.5 This constant is ignored.
hLstDetailDetailed information (idem earlier versions).
hLstDetailPlusFor the numeric items, adds the number of digits in the integer part and in the decimal part.
Hyper File 5.5 This constant is ignored.
hLstMemoLists the memo items
Hyper File 5.5 This constant is ignored.
hLstLogicalOrderSorts the list in logical order of items (ignored if hLstSorted is specified)
Hyper File 5.5 This constant is ignored.
hLstItemLists the non-key and non-memo items
hLstOriginalItemUsed on a log file (xxxJNL.fic), lists the items of the source file (that was logged). For example, on CustomerLOG.Fic, lists the items of CUSTOMER file.
Hyper File 5.5 This constant is ignored.

Java This constant is not available.
hLstAllLists all the type of items (hLstItem + hLstMemo + hLstKey + hLstCompositeKey)
Hyper File 5.5 This constant is ignored.
hLstSortedSorts the list in alphabetical order
Hyper File 5.5 This constant is ignored.
Versions 19 and later
WINDEVWEBDEV - Server codeWindows Mobile

Listing the items of a Record variable Hide the details

<Result> = HListItem(<Record> [, <Options>])
<Result>: Character string
List of items found in the specified Record variable . The descriptions of each item are separated by CR characters (Carriage Return). The result is more or less detailed depending on the constant used:
hLstDetail is not specified<Name of Item 1> + CR + <Name of Item 2> + CR +...
hLstDetail is specified<Name of Item 1> + TAB + <Type> + TAB + <HFSQL Type> + TAB + <Size> + TAB + <Number of Subscripts> + TAB + <Caption> + CR +...
hLstDetailPlus<Name of Item 1> + TAB + <Type> + TAB + <HFSQL Type> + TAB + <Size> + TAB + <Number of Subscripts> + TAB + <Caption> + TAB + <Integer Part of Numeric Items> + TAB + <Decimal Part of Numeric Items> + CR +...
Where:
  • <Name of Item X>: Name of item
  • <Type>: Type of item: "T" for text (and currency) or "N" for numeric
  • <HFSQL Type>: HFSQL type of item. See the Notes for more details.
  • <Size>: Size of the item
  • <Number of Subscripts>: Number of elements in the array
  • <Caption>: Caption of item.
  • <Integer Part of Numeric Items>: Number of digits in the integer part of numeric items
  • <Decimal Part of Numeric Items>: Number of digits in the decimal part of numeric items
<Record>: Record variable
Name of Record variable from which the list of items will be retrieved.
<Options>: Optional Integer constant (or combination of constants)
Configures the type of list to perform:
hLstNormal
(default value)
Corresponds to hLstItem + hLstMemo + hLstKey
hLstKeyLists the key items (non-composite keys only).
Hyper File 5.5 This constant is ignored.
hLstCompositeKeyLists the composite key items only.
Hyper File 5.5 This constant is ignored.
hLstDetailDetailed information (idem earlier versions).
hLstDetailPlusFor the numeric items, adds the number of digits in the integer part and in the decimal part.
Hyper File 5.5 This constant is ignored.
hLstMemoLists the memo items
Hyper File 5.5 This constant is ignored.
hLstLogicalOrderSorts the list in logical order of items (ignored if hLstSorted is specified).
Hyper File 5.5 This constant is ignored.
hLstItemLists the non-key and non-memo items
hLstOriginalItemUsed on a log file (xxxJNL.fic), lists the items of the source file (that was logged). For example, on CustomerLOG.Fic, lists the items of CUSTOMER file.
Hyper File 5.5 This constant is ignored.
hLstAllLists all the type of items (hLstItem + hLstMemo + hLstKey + hLstCompositeKey).
Hyper File 5.5 This constant is ignored.
hLstSortedSorts the list in alphabetical order.
Hyper File 5.5 This constant is ignored.
New in version 19
WINDEVWEBDEV - Server codeWindows Mobile

Listing the items of a Record variable Hide the details

<Result> = HListItem(<Record> [, <Options>])
<Result>: Character string
List of items found in the specified Record variable . The descriptions of each item are separated by CR characters (Carriage Return). The result is more or less detailed depending on the constant used:
hLstDetail is not specified<Name of Item 1> + CR + <Name of Item 2> + CR +...
hLstDetail is specified<Name of Item 1> + TAB + <Type> + TAB + <HFSQL Type> + TAB + <Size> + TAB + <Number of Subscripts> + TAB + <Caption> + CR +...
hLstDetailPlus<Name of Item 1> + TAB + <Type> + TAB + <HFSQL Type> + TAB + <Size> + TAB + <Number of Subscripts> + TAB + <Caption> + TAB + <Integer Part of Numeric Items> + TAB + <Decimal Part of Numeric Items> + CR +...
Where:
  • <Name of Item X>: Name of item
  • <Type>: Type of item: "T" for text (and currency) or "N" for numeric
  • <HFSQL Type>: HFSQL type of item. See the Notes for more details.
  • <Size>: Size of the item
  • <Number of Subscripts>: Number of elements in the array
  • <Caption>: Caption of item.
  • <Integer Part of Numeric Items>: Number of digits in the integer part of numeric items
  • <Decimal Part of Numeric Items>: Number of digits in the decimal part of numeric items
<Record>: Record variable
Name of Record variable from which the list of items will be retrieved.
<Options>: Optional Integer constant (or combination of constants)
Configures the type of list to perform:
hLstNormal
(default value)
Corresponds to hLstItem + hLstMemo + hLstKey
hLstKeyLists the key items (non-composite keys only).
Hyper File 5.5 This constant is ignored.
hLstCompositeKeyLists the composite key items only.
Hyper File 5.5 This constant is ignored.
hLstDetailDetailed information (idem earlier versions).
hLstDetailPlusFor the numeric items, adds the number of digits in the integer part and in the decimal part.
Hyper File 5.5 This constant is ignored.
hLstMemoLists the memo items
Hyper File 5.5 This constant is ignored.
hLstLogicalOrderSorts the list in logical order of items (ignored if hLstSorted is specified).
Hyper File 5.5 This constant is ignored.
hLstItemLists the non-key and non-memo items
hLstOriginalItemUsed on a log file (xxxJNL.fic), lists the items of the source file (that was logged). For example, on CustomerLOG.Fic, lists the items of CUSTOMER file.
Hyper File 5.5 This constant is ignored.
hLstAllLists all the type of items (hLstItem + hLstMemo + hLstKey + hLstCompositeKey).
Hyper File 5.5 This constant is ignored.
hLstSortedSorts the list in alphabetical order.
Hyper File 5.5 This constant is ignored.
WINDEVWEBDEV - Server codeWindows Mobile

Listing the items of a Record variable Hide the details

<Result> = HListItem(<Record> [, <Options>])
<Result>: Character string
List of items found in the specified Record variable . The descriptions of each item are separated by CR characters (Carriage Return). The result is more or less detailed depending on the constant used:
hLstDetail is not specified<Name of Item 1> + CR + <Name of Item 2> + CR +...
hLstDetail is specified<Name of Item 1> + TAB + <Type> + TAB + <HFSQL Type> + TAB + <Size> + TAB + <Number of Subscripts> + TAB + <Caption> + CR +...
hLstDetailPlus<Name of Item 1> + TAB + <Type> + TAB + <HFSQL Type> + TAB + <Size> + TAB + <Number of Subscripts> + TAB + <Caption> + TAB + <Integer Part of Numeric Items> + TAB + <Decimal Part of Numeric Items> + CR +...
Where:
  • <Name of Item X>: Name of item
  • <Type>: Type of item: "T" for text (and currency) or "N" for numeric
  • <HFSQL Type>: HFSQL type of item. See the Notes for more details.
  • <Size>: Size of the item
  • <Number of Subscripts>: Number of elements in the array
  • <Caption>: Caption of item.
  • <Integer Part of Numeric Items>: Number of digits in the integer part of numeric items
  • <Decimal Part of Numeric Items>: Number of digits in the decimal part of numeric items
<Record>: Record variable
Name of Record variable from which the list of items will be retrieved.
<Options>: Optional Integer constant (or combination of constants)
Configures the type of list to perform:
hLstNormal
(default value)
Corresponds to hLstItem + hLstMemo + hLstKey
hLstKeyLists the key items (non-composite keys only).
Hyper File 5.5 This constant is ignored.
hLstCompositeKeyLists the composite key items only.
Hyper File 5.5 This constant is ignored.
hLstDetailDetailed information (idem earlier versions).
hLstDetailPlusFor the numeric items, adds the number of digits in the integer part and in the decimal part.
Hyper File 5.5 This constant is ignored.
hLstMemoLists the memo items
Hyper File 5.5 This constant is ignored.
hLstLogicalOrderSorts the list in logical order of items (ignored if hLstSorted is specified).
Hyper File 5.5 This constant is ignored.
hLstItemLists the non-key and non-memo items
hLstOriginalItemUsed on a log file (xxxJNL.fic), lists the items of the source file (that was logged). For example, on CustomerLOG.Fic, lists the items of CUSTOMER file.
Hyper File 5.5 This constant is ignored.
hLstAllLists all the type of items (hLstItem + hLstMemo + hLstKey + hLstCompositeKey).
Hyper File 5.5 This constant is ignored.
hLstSortedSorts the list in alphabetical order.
Hyper File 5.5 This constant is ignored.
Remarks

Order of items

The items listed in <Result> are sorted according to the physical order of items in the data file (except if the hLstSorted constant is used).

Displaying the result in a list box or in a combo box

<Result> can be directly assigned to a list box or to a combo box by ListAdd. Each row will contain the description of an item.

HFSQL type

The possible HFSQL types are as follows:
0unknown type1automatic identifier on 8 bytes
2text item3signed integer item on 2 bytes
4signed integer item on 1 byte5signed integer item on 4 bytes
6simple real item (on 4 bytes)7simple real item (on 8 bytes)
8record number item (unsigned integer)9unsigned integer item on 2 bytes
10date item on 611time item
12unsigned integer item on 1 byte13turbo real item
14date item on 815text memo item
16binary memo 4.0 item17currency item
18binary memo, image memo item,
Sound memo, OLE memo or other binary memo
19signed integer item on 8 bytes
20unsigned integer item on 8 bytes21image item
22unsigned integer item on 4 bytes23character string item
24date+time item25duration item
26character item27boolean item
28automatic identifier item (on 4 bytes)29Unicode text item
30Unicode text memo item31high-precision numeric item
32
Versions 20 and later
Enumeration item
New in version 20
Enumeration item
Enumeration item
33
Versions 20 and later
Combination item
New in version 20
Combination item
Combination item
Components
WINDEVWEBDEV - Server codeReports and Queries wd230hf.dll
Windows Mobile wp230hf.dll
Java wd230java.jar
Linux wd230hf.so
Android wd230android.jar
Minimum required version
  • Version 9
This page is also available for…
Comments
Example - Table with create column use HListItem
FiltraUsuarios("")

//AlteraNomeColunasQuery("TABLE_usuario","QRY_Select_All_Usuarios")

//usando a estrutura da query
sColuna is string = pTableNameControl+".COL_Column"
ItemList is string = HListItem( {pQueryName,indFile} , hLstDetail)
CountCampos is int = StringCount(ItemList,CRLF)

//c is int
//
//loop (CountCampos)
// c+=1
//
// //TableInsertColumn /// windev
//
//END


ItemList = Replace(ItemList,CRLF,";")
ItemList = Replace(ItemList,TAB,";")
x is int = 6
y is int = 0
VARTEXT is string
LOOP(CountCampos)
y+= 1
VARTEXT = ExtractString(ItemList,x,";",FromBeginning)
{sColuna+y,indControl}..Caption = VARTEXT
{sColuna+y,indControl}..Visible = True
x+= 6
END
BOLLER
Jun. 25 2018