PC SOFT

ONLINE HELP
FOR WINDEV, WEBDEV AND WINDEV MOBILE

Home | Sign in | English US

X
Y
  • ListView control
  • Display error
  • Limits
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
..FileLink is used to find out and modify the link between a control:
  • and an item found in a data file.
  • and a variable.
  • Versions 15 and later
    and several variables (in this case, each variable can be linked to a different property of the control).
    New in version 15
    and several variables (in this case, each variable can be linked to a different property of the control).
    and several variables (in this case, each variable can be linked to a different property of the control).
Reminder: In most cases, the link between a control and an item or variable is defined in the window editor or in the page editor during the control description ("Link" tab). This link allows you to specify the file item that will be used by the synchronization functions (ScreenToFile, ScreenToSource, PageToFile, PageToSource, FileToScreen, FileToPage, SourceToScreen, SourceToPage).
Example of multi-file link:
'Link' tab of control description
This property is equivalent to ControlAlias.
Versions 15 and later
Android This property is now available for the Android applications.
New in version 15
Android This property is now available for the Android applications.
Android This property is now available for the Android applications.
Versions 17 and later
iPhone/iPad This property is now available for the iPhone/iPad applications.
New in version 17
iPhone/iPad This property is now available for the iPhone/iPad applications.
iPhone/iPad This property is now available for the iPhone/iPad applications.
Versions 18 and later
Universal Windows 10 App This property is now available in Windows Store Apps mode.
Android Widget This property is now available in Android Widget mode.
New in version 18
Universal Windows 10 App This property is now available in Windows Store Apps mode.
Android Widget This property is now available in Android Widget mode.
Universal Windows 10 App This property is now available in Windows Store Apps mode.
Android Widget This property is now available in Android Widget mode.
Versions 20 and later
AndroidiPhone/iPad This property is now available for the Table controls and for the table columns in the Android applications and in the iPhone/iPad applications.
New in version 20
AndroidiPhone/iPad This property is now available for the Table controls and for the table columns in the Android applications and in the iPhone/iPad applications.
AndroidiPhone/iPad This property is now available for the Table controls and for the table columns in the Android applications and in the iPhone/iPad applications.
Versions 21 and later
Universal Windows 10 App This property is now available in Universal Windows 10 App mode.
New in version 21
Universal Windows 10 App This property is now available in Universal Windows 10 App mode.
Universal Windows 10 App This property is now available in Universal Windows 10 App mode.
Example
// Links the EDT_Edit1 control with the Name item of Customer file
EDT_Edit1..FileLink = "Customer.Name"
// Same but from the Orders file with 1 link
EDT_Edit2..FileLink = "Orders.CustomerID" + TAB + "Customer.CustomerID:Name"
// Same but from the OrdLine file with 2 links
EDT_Edit3..FileLink = "OrdLine.OrdID" + TAB + ...
"Orders.OrdID:CustomerID" + TAB + "Customer.CustomerID:Name"
// Links the TABLE_Table1 table with the Array_Month array
TABLE_Table1..FileLink = ":Array_Month"
// Update on the screen
FileToScreen()
// Whenever SourceToScreen is called, the EDT_Current_Allowed control will have:
// - its displayed value updated by the Authorizing property of a class instance,
// - a background color assigned by the value of a global variable
gclContact is cContact
gsColor is int = PastelBlue
EDT_Current_Allowed..FileLink = ":gclContact.Authorizing" + TAB + ...
"value" + CR + ":gsColor" + TAB + "BackgroundColor"
// Update on the screen
SourceToScreen()
Syntax

Finding out the link between a control and an item or variable Hide the details

<Current Link> = <Control Name>..FileLink
<Current Link>: Character string
Different types of links can be found:
  • No link: empty string ("")
  • Simple link with an item of a data file:
    "<Base File>.<Base Item>"
  • Complex link with an item of a data file:
    "<Base File>.<Base Item>[ + TAB + <Link> [+ TAB + <Link>]]"

    where <Link> corresponds to:
    <Linked File>.<Key>:<Linked Item>[<Subscript>]
  • Link with a variable:
    ":<prefix><Variable Name>"
    or
    ":<Variable Name>"
    (the prefix is found only if the programming charter is enabled in the project).
    AndroidAndroid Widget Java Not available.
<Control Name>: Character string (with or without quotes)
Name of control whose file link is requested.

Modifying the link between a control and an item or variable Hide the details

<Control Name>..FileLink = <New Link>
<Control Name>: Character string (with or without quotes)
Name of control whose file link will be modified.
<New Link>: Character string
Different types of links can be defined:
  • No link: empty string ("")
  • Simple link with an item of a data file:
    "<Base File>.<Base Item>"
  • Complex link with an item of a data file:
    "<Base File>.<Base Item>[ + TAB + <Link> [+ TAB + <Link>]]"

    where <Link> corresponds to:
    <Linked File>.<Key>:<Linked Item>[<Subscript>]
    Note: the following syntax is also accepted:
    <[Base File>.<Item>[<[Subscript]>] [: <Link> [: <Link>] ]

    where <Link> = <Linked file>.<Key>:<DispItem> [<[Subscript]>]
  • Link with a variable:
    ":<prefix><Variable Name>"
    or
    ":<Variable Name>"
    The prefix must be specified only if the programming charter is enabled in the project (no matter whether prefixes are displayed or not).
    AndroidAndroid Widget Java Not available.
  • Versions 15 and later
    Link several properties with several variables: the character string describing the link must have the following format:
    ":" + <Name of Variable 1> + TAB + <Name of Property 1> + CR + ...
    ":" + <Name of Variable 2> + TAB + <Name of Property 2> + CR + ...
    ":" + <Name of Variable N> + TAB + <Name of Property N>
    New in version 15
    Link several properties with several variables: the character string describing the link must have the following format:
    ":" + <Name of Variable 1> + TAB + <Name of Property 1> + CR + ...
    ":" + <Name of Variable 2> + TAB + <Name of Property 2> + CR + ...
    ":" + <Name of Variable N> + TAB + <Name of Property N>
    Link several properties with several variables: the character string describing the link must have the following format:
    ":" + <Name of Variable 1> + TAB + <Name of Property 1> + CR + ...
    ":" + <Name of Variable 2> + TAB + <Name of Property 2> + CR + ...
    ":" + <Name of Variable N> + TAB + <Name of Property N>
Remarks
WINDEVWindows MobileJava

ListView control

..FileLink is used to find out and modify the link between the captions of a listview and an item of a data file.
WINDEVWindows MobileJava

Display error

ControlError is used to customize the error message displayed in the controls when the control value cannot be displayed.

Limits

..FileLink only applies to the controls found in a window or in a page.
AndroidAndroid Widget Java ..FileLink can only be used to create a link with a data file. You cannot create a link with a variable.
Versions 22 and later
AndroidAndroid Widget Java ..FileLink can now be used to create a link with a variable.
New in version 22
AndroidAndroid Widget Java ..FileLink can now be used to create a link with a variable.
AndroidAndroid Widget Java ..FileLink can now be used to create a link with a variable.
Android Widget This property only applies to the following controls:
  • Button control.
  • Static control.
  • Image control.
Minimum required version
  • Version 9
This page is also available for…
Comments
Click [Add] to post a comment