combobutton statement

	<< Index >>	FutureBasic
combobutton		statement

Syntax
combobutton tag, enabled, title, image, menuID, menuItems, rect, style, wndTag

Requires
macOS 13.0+

Description
The combobutton statement puts a new combobutton in the current output window, or alters an existing combobutton's characteristics.

Notes: Clicking the button triggers an on dialog _btnClick event. Choosing a menu item triggers an on menu event.

Parameters

Parameter
Description

tag A number (1 through 1000000) that you assign when you create the combobutton and that you refer to when altering or closing the combobutton. 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 combobutton.

enabled A boolean value which specifies whether the combobutton should be enabled or disabled.

title The text that appears inside the combobutton as a CFString expression.

image This parameter can be NULL or one of the following:

The name of (or path to) an image resource

An ImageRef

menuID A menu index. This can be the menuID of a previously created menu.

menuItems A semicolon-delimited list or an array of titles. A dash ('-') inserts a menu separator.

rect The combobutton'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 button.
(ii) A CGRect value

style Specifies the style of the button:

NSComboButtonStyleSplit (default)
NSComboButtonStyleUnified

wndTag An optional parameter for when the button'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 event
_btnClick

Subclass
To subclass a nib combobutton, set its class name to "ComboButtonSC" in the nib.

Apple documentation
NSComboButton

Parameter	Description
tag	A number (1 through 1000000) that you assign when you create the combobutton and that you refer to when altering or closing the combobutton. 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 combobutton.
enabled	A boolean value which specifies whether the combobutton should be enabled or disabled.
title	The text that appears inside the combobutton as a CFString expression.
image	This parameter can be NULL or one of the following: The name of (or path to) an image resource An ImageRef
menuID	A menu index. This can be the menuID of a previously created menu.
menuItems	A semicolon-delimited list or an array of titles. A dash ('-') inserts a menu separator.
rect	The combobutton'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 button. (ii) A CGRect value
style	Specifies the style of the button: NSComboButtonStyleSplit (default) NSComboButtonStyleUnified
wndTag	An optional parameter for when the button'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.