Note: This page includes content based on the F1 documentation for Centura development. It may be partially converted to support APF development, but should be regarded to be of uncertain actuality. It is provided as is. Eventually, it should be replaced by documentation available from within Visual Studio.
SalBoolean WinNameToWinHandle( SalWindowHandle hWndParent, SalString sWindowName, ref SalArray<SalWindowHandle> hWndWindows )
The WinNameToWinHandle finds all child windows with a certain name for a Form Window, Table Window, Dialog Box or MDI Window.
| Name | Description |
|---|---|
| SalWindowHandle hWndParent | The window for which to find matching child windows. |
| SalString sWindowName | The name the child windows are required to have to be included in the list of found windows. |
| ref SalWindowHandle hWndWindows | The resulting list of all child windows to hWndParent with the name sWindowName. |
Unknown
For Form Windows, Table Windows and Dialog Boxes, a maximum of one matching child window will be found. This is because it is not possible to have two child windows with the same name in the contents section of the outline.
MDI Windows on the other hand can have several instances of the same window as children, hence for MDI Windows any number of matching child windows might be found.