PC SOFT

WINDEVWEBDEV AND WINDEV MOBILE
ONLINE HELP

Home | Sign in | English UK
  • Use conditions
  • Special cases
  • Tip for the browsing Table and Treeview Table controls
  • Native SQL Server Connector
  • Various
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
Refreshes the display of a Table or TeeeView Table control from a given position:
  • a browsing Table control: the modifications performed in the linked data file are applied to the control.
  • a memory Table control: the calculated columns are re-calculated.
Example
// Refresh the "TABLE_ProductTable" control from the beginning
TABLE_ProductTable.Display(taStart)
Syntax
<Table control>.Display([<Position>])
<Table control>: Control name
Name of control to refresh. This control can correspond to:
  • a Table control,
  • a TreeView Table control.
<Position>: Integer, character or constant (optional)
Indicates the start position for the refresh. If this parameter is not specified:
  • For a browsing control, the function behaves like if the taInit constant was passed in parameter.
  • For a memory control, the function has no effect.
This parameter can correspond to:
  • An integer. The refresh is performed from this position. The row selected in the control is not modified.
    For a browsing control, the event "Displaying a row" of the <Position> row is run. The row selected in the control corresponds to the current record in the data file.
    For a memory control, the <Position> row is redisplayed.
  • A character or a constant:
    Browsing Table or TreeView Table controlTable control or browsing Table control loaded in memoryMemory Table or Treeview Table control
    taStart
    (Default value)
    • Refreshes the control while being positioned at the beginning of control.
    • The first control row is selected. This row corresponds to the first record of the datafile.
    No effect.No effect.
    taCurrentSelection
    • Refreshes the control from the position of the selection bar.
    • The position of selection bar is not modified. The current record in the data file will correspond to the record selected in the control (after the call to <Table>.Display).
    • Redisplays the control while re-initializing the values of calculated columns.
    • The selected row is unchanged.
    • Redisplays the control while re-calculating the values of calculated columns.
    • The selected row is unchanged.
    taCurrentRecord
    • Re-runs the linked query if necessary.
    • Takes into account the records added, modified or deleted by other computers.
    • Selects the current record (if the browse defined in the control is performed on a unique key). If the current record is deleted or if it does not correspond to the filter, selects the next record that has not been deleted.
      If duplicates are found on the browse item, the row selected among the duplicates will be undefined.
    • The scrollbar position is stored as long as the selection remains visible.
    • Runs the initialization start and end events, then the event "Selecting a row" for the selected row (even if it is not modified).
    No effect.No effect.
    taCurrentFirst
    • Refreshes the control from the current record in the data file.
    • The first control row is selected. This row corresponds to the current record.
    • Redisplays the control while recalculating the values of calculated columns.
    • The selected row is unchanged.
    taInit
    • Runs the initialization codes of control (initialization code and end of initialization code).
    • Runs the initialization code of columns found in the control.
    • Fills the control.
    • The first row of Table control is selected. This row corresponds to the current record in the data file at the end of the initialization code in the control.
    No effect.No effect.
    taPrevious
    • Refreshes the control while being positioned at the beginning of control of previous page (same as using the pager to access the previous page).
    • The first visible control row is selected. This row corresponds to the current record in the data file.
    No effect.No effect.
    taReExecuteQuery
    • Re-runs the query linked to the control. See Table control and queries for more details.
    • Refreshes the control while being positioned at the beginning of control.
    • The first control row is selected. This row corresponds to the first record in the query result.
    Caution: Only the query linked to the control is run. If specific options have been specified by HExecuteQuery (with hModifyFile for example), these options are ignored.
    No effect.No effect.
    taNext
    • Refreshes the control while being positioned at the beginning of the Table control of the next page (same as using the pager to access the next page).
    • The first visible control row is selected. This row corresponds to the current record in the data file.
    No effectNo effect.
Remarks

Use conditions

<Table>.Display can be used on:
  • a browsing or memory control.
  • a single-selection or multiselection control.

Special cases

<Table>.Display has no effect:
  • If <Position> is an integer and if this integer is invalid.
  • If <Position> is an integer and <Table control> is a browsing Table control with a "bouncing scrollbar".
Reminder: The bouncing scrollbar is an old operating mode. With a bouncing scrollbar, the cursor returns to the middle of the track each time you click on the scrollbar arrow buttons (or by using the up arrow or down arrow of the keyboard). To create a bouncing scrollbar, uncheck "Proportional scrollbar" in the "Details" tab of the control description window.

Tip for the browsing Table and Treeview Table controls

To display a calculation in a calculated column or to format a cell ("red background if value greater than 50" for example), use the event "Displaying a row" of the control.
Native Connectors (Native Accesses)

Native SQL Server Connector

If <Table>.Display handles a control linked to a data file accessed by the Native SQLServer Connector, we recommend that you use the taCurrentFirst and taStart constants.
Reports and Queries

Various

The taFromFile constant and the taCurrentFirst constant are identical. This constant is kept for backward compatibility and it is displayed in orange in the code editor.
Component : wd240obj.dll
Minimum version required
  • Version 23
This page is also available for…
Comments
Click [Add] to post a comment