NSSegmentedControlMBS.Constructor

dim t as new NSSegmentedControlMBS

On success the handle property is not zero.

See also:

• Constructor(Handle as Integer)
• Constructor(left as Double, top as Double, width as Double, height as Double)

NSSegmentedControlMBS.Constructor(Handle as Integer)

dim t as new NSSegmentedControlMBS(0, 0, 100, 100)
dim v as new NSSegmentedControlMBS(t.handle)

MsgBox str(v.Bounds.Width)+" x "+str(v.Bounds.Height)

The handle is casted to a NSSegmentedControl and the plugin retains this handle.

See also:

• Constructor
• Constructor(left as Double, top as Double, width as Double, height as Double)

NSSegmentedControlMBS.Constructor(left as Double, top as Double, width as Double, height as Double)

dim x as new NSSegmentedControlMBS(0, 0, 100, 100)

On success the handle property is not zero.

See also:

• Constructor
• Constructor(Handle as Integer)

NSSegmentedControlMBS.imageForSegment(segment as Integer) as NSImageMBS

image: The image to apply to the segment or nil if you want to clear the existing image. Images are not scaled to fit inside a segment. If the image is larger than the available space, it is clipped.
segment: The index of the segment whose image you want to set. This method raises an NSRangeException if the index is out of bounds.
(Read and Write computed property)

Some examples using this property:

• /MacBase/Custom NSWindows/NSWindow like AppStore/AppStore NSWindow
• /MacControls/Toolbar/Toolbar buttons/Toolbar buttons

NSSegmentedControlMBS.imageScalingForSegment(segment as Integer) as Integer

scaling: One of the image scaling constants. For a list of possible values, see constants.
segment: The index of the segment whose enabled state you want to get. This method raises an NSRangeException if the index is out of bounds.
Available in Mac OS X v10.5 and later.
(Read and Write computed property)

NSSegmentedControlMBS.isEnabledForSegment(segment as Integer) as Boolean

True to enable the segment; otherwise, false to disable it.
segment: The index of the segment you want to enable or disable. This method raises an NSRangeException if the index is out of bounds.
(Read and Write computed property)

Some examples using this property:

• /MacControls/Toolbar/Toolbar buttons/Toolbar buttons

NSSegmentedControlMBS.isSelectedForSegment(segment as Integer) as Boolean

True if you want to select the segment; otherwise, false.

segment: The index of the segment whose selection state you want to set. This method raises an NSRangeException if the index is out of bounds.

If the receiver allows only a single selection, this method deselects any other selected segments.
(Read and Write computed property)

NSSegmentedControlMBS.labelForSegment(segment as Integer) as string

label: The label you want to display in the segment. If the width of the string is greater than the width of the segment, the string's text is truncated during drawing.
segment: The index of the segment whose label you want to set. This method raises an NSRangeException if the index is out of bounds.
(Read and Write computed property)

Some examples using this property:

• /MacControls/NSSegmentedControl
• /MacControls/NSSegmentedControl control

NSSegmentedControlMBS.makeNextSegmentKey

The next segment is the one to the right of the currently selected segment. For the last segment, the selection wraps back to the beginning of the control.

Some examples using this method:

• /MacControls/NSSegmentedControl
• /MacControls/NSSegmentedControl control

NSSegmentedControlMBS.makePreviousSegmentKey

The previous segment is the one to the left of the currently selected segment. For the first segment, the selection wraps around to the last segment of the control.

Some examples using this method:

• /MacControls/NSSegmentedControl
• /MacControls/NSSegmentedControl control

NSSegmentedControlMBS.menuForSegment(segment as Integer) as NSMenuMBS

menu: The menu you want to add to the segment or nil to clear the current menu. This menu is displayed when the user clicks and holds the mouse button while the mouse is over the segment.
segment: The index of the segment whose menu you want to set. This method raises an NSRangeException if the index is out of bounds.

Adding a menu to a segment allows that segment to be used as a pop-up button.
(Read and Write computed property)

Some examples using this property:

• /MacControls/Toolbar/Toolbar buttons/Toolbar buttons

NSSegmentedControlMBS.selectSegmentWithTag(Tag as Integer) as Boolean

tag: The tag associated with the desired segment.
True if the segment was selected successfully; otherwise, false.

Typically, you use Interface Builder to specify the tag for each segment. You may also set this value programmatically using the setTag:forSegment: method of NSSegmentedCell.

NSSegmentedControlMBS.tagForSegment(segment as Integer) as Integer

segment: The index of the segment whose width you want to get. This method raises an NSRangeException if the index is out of bounds.

The tag is an integer you define to identify your items.
(Read and Write computed property)

Some examples using this property:

• /MacBase/Custom NSWindows/NSWindow like AppStore/AppStore NSWindow
• /MacControls/Toolbar/Toolbar buttons/Toolbar buttons

NSSegmentedControlMBS.ToolTipForSegment(segment as Integer) as string

segment: The index of the segment whose tool tip you want to set. This method raises an NSRangeException if the index is out of bounds.

Tool tips are currently not displayed. Apple may change that in the future.
(Read and Write computed property)

NSSegmentedControlMBS.widthForSegment(segment as Integer) as Double

width: The width of the segment, measured in points. Specify the value 0 if you want the segment to be sized to fit the available space automatically.
segment: The index of the segment whose width you want to set. This method raises an NSRangeException if the index is out of bounds.
(Read and Write computed property)

Some examples using this property:

• /MacBase/Custom NSWindows/NSWindow like AppStore/AppStore NSWindow
• /MacControls/Toolbar/Toolbar buttons/Toolbar buttons