pathcontrol statement

	<< Index >>	FutureBasic
PathControl		statement / function

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

Function syntax


url = pathcontrol(tag)

Description
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.

Parameters

Parameter
Description

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)
NSPathStylePopUp

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
_pathControlShouldDragPathComponentCell
_pathControlValidateDrop
_pathControlAcceptDrop
_pathControlWillDisplayOpenPanel
_pathControlWillPopUpMenu
_pathControlShouldDragItem // macOS 10.10+

Subclass
To subclass a nib pathcontrol, set its class name to "PathControlSC" in the nib.

Apple documentation
NSPathControl
NSPathControlDelegate

Parameter	Description
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) NSPathStylePopUp
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.