Topics   All   MacOS (Only)   Windows (Only)   Linux (Only, Not)   iOS (Only, Not)  
Components   Crossplatform Mac & Win   Server   Client   Old   Deprecated   Guides   Examples
Videos
New in version: 9.0   9.1   9.2   9.3   9.4   9.5   10.0   10.1   10.2   10.3    Statistic  

TextView.CreateWithControl

Creates a new text view on the given window covering the area of the given control.

Component Version macOS Windows Server FileMaker Cloud FileMaker iOS SDK
TextView 9.2 Yes Yes No No Yes
MBS( "TextView.CreateWithControl"; WindowRef; ControlName { ; DX; DY } )   More

Parameters

Parameter Description Example value
WindowRef Window Reference is the unique OS level window ID. You can obtain this by using the Window.FindByTitle or Window.FindByIndex functions. Pass zero to access the frontmost window. 0
ControlName The name of the control on your FileMaker form.
e.g. you can place a rectangle there to define the position.
"mymedia"
DX Optional
A delta to move text view more to left or right.
0
DY Optional
A delta to move text view more to top or bottom.
0

Result

Returns text view reference number on success.

Description

Creates a new text view on the given window covering the area of the given control.
Use TextView.Release later to destroy the text view.
If you use a register (tab controls) on the window, be aware that the text view actually is in front of the register (tab controls). You may hide the text view if another register is visible.
Text view reference numbers are starting at 81000 and counting up for each new text view.
When creating on a card window, please pass reference to parent window or just 0 for front window. On MacOS you may need to pass delta y value to adjust position.

If you create a control on a new window, you may do window update command in your script first to have FileMaker actually build the window with controls and display it. A short script pause or using FM.RunScriptLater with 0.1 delay can help having all controls draw themselves. Then you can use this command to put our control on top. We use GetControl() to query left, top, width and height and this gives empty value if control is not yet here.

Creation fails to pick the right window in case the window is selected by name and the window name is not unique. In that case better work with window reference numbers or just pass 0 for current front window.

See also

Example Databases

Blog Entries

Release notes

Created 15th April 2019, last changed 9th June 2020


TextView.Copy   -   TextView.CreateWithSize

Feedback: Report problem or ask question.




Links
MBS Xojo Chart Plugins