FutureBasic Logo

<<    Index    >> FutureBasic

PathControl   statement / function

Statement syntax
pathcontrol tag, enabled, url, rect, style, wndTag

Function syntax
url = pathcontrol(tag)

The pathcontrol statement puts a new pathcontrol in the current output window, or alters an existing pathcontrol's characteristics. The pathcontrol function returns the URL of the control as a CFURLRef and is equivalent to calling fn PathControlURL.

tag A number (1 through 1000000) that you assign when you create the pathcontrol and that you refer to when altering the control. The number you assign must be different from the tag value of all other existing widgets in the current window. A negative tag hides the pathcontrol.
enabled A boolean value which specifies whether the control should be enabled or disabled.
url The path value displayed by the control.
rect The pathcontrol's enclosing rectangle. This can be specified in either of two ways:
(i) (x,y,w,h) where x,y are the origin and w,h the size of the control.
(ii) A CGRect value
style The control's path style:
NSPathStyleStandard (default)
wndTag An optional parameter for when the pathcontrol's window is not the current output window. Note specifying this parameter does not bring the window to the front or make it the output window.
Dialog events
_pathControlShouldDragItem // macOS 10.10+

Apple documentation