Class CCSegmentedButton

A segmented button displays multiple buttons in a single view, with only one selected at a time.

Hierarchy (View Summary)

Constructors

constructor

Properties

_isEnabled acceptsFirstResponder action isFocused isHidden needsDraw needsLayout needsUpdateConstraints nextResponder? subviews superview? userInteractionEnabled window?

Accessors

backgroundColor buttonActiveColor buttonColor buttonCount buttonSelectedColor frame isEnabled selectedButton textColor textDisabledColor textSelectedColor

Methods

addButton addConstraint addConstraints addSubview becomeFirstResponder bringSubviewToFront convertToWindowSpace cursorPos didAddSubview didMoveToSuperview didRemoveSubview display draw getButton hitTest horizontalScrollWheel interpretKeyEvents keyDown keyUp layoutSubtree mouseDown mouseDragged mouseEntered mouseExited mouseMoved mouseUp noResponder otherMouseDown otherMouseDragged otherMouseUp removeButton removeConstraint removeFromSuperview resignFirstResponder rightMouseDown rightMouseDragged rightMouseUp scrollWheel sendSubviewToBack setNeedsDisplay setNeedsLayout textInput tryToCall validateProposedFirstResponder addConstraintsByCode

Constructors

constructor

  • new CCSegmentedButton(
        frame: CCRect,
        buttons: string[],
        action: (this: void, sender: CCSegmentedButton, selection: number) => void,
    ): CCSegmentedButton

  • Creates a new segmented button.

    Parameters

    • frame: CCRect

      The frame for the button. This should have a height of 1.

    • buttons: string[]

      The text for each button. This must have at least one button.

    • action: (this: void, sender: CCSegmentedButton, selection: number) => void

      The action to call when a selection changes

    Returns CCSegmentedButton

    Throws

    If the button text list is empty

Properties

Protected_isEnabled

_isEnabled: boolean = true

acceptsFirstResponder

acceptsFirstResponder: boolean = true

Whether the object can become the first responder.

action

action: (this: void, sender: CCSegmentedButton, selection: number) => void

The function to call when the selection changes.

isFocused

isFocused: boolean = false

Whether the view is currently focused.

isHidden

isHidden: boolean = false

Whether the view is hidden.

needsDraw

needsDraw: boolean = true

Whether the view needs to be redrawn.

needsLayout

needsLayout: boolean = false

Whether the view needs to be laid out.

needsUpdateConstraints

needsUpdateConstraints: boolean = false

Whether constraints need to be updated.

OptionalnextResponder

nextResponder?: CCResponder

The next responder in the responder chain.

subviews

subviews: CCView[] = []

The list of subviews inside this view.

Optionalsuperview

superview?: CCView

The view that contains this view, if it exists.

userInteractionEnabled

userInteractionEnabled: boolean = true

Whether user interaction is enabled for this view.

Optionalwindow

window?: CCWindow

The window this view is located inside.

Accessors

backgroundColor

  • get backgroundColor(): undefined | number

  • The background color of the view.

    Returns undefined | number

  • set backgroundColor(value: undefined | number): void

  • Parameters

    • value: undefined | number

    Returns void

buttonActiveColor

buttonColor

buttonCount

  • get buttonCount(): number

  • The number of buttons in the segmented button.

    Returns number

buttonSelectedColor

  • get buttonSelectedColor(): number

  • The color of the button when in default state.

    Returns number

  • set buttonSelectedColor(value: number): void

  • Parameters

    • value: number

    Returns void

frame

isEnabled

selectedButton

textColor

textDisabledColor

textSelectedColor

Methods

addButton

  • addButton(text: string, index?: number): void

  • Adds a new button to the list of buttons.

    Parameters

    • text: string

      The text for the button

    • index: number = ...

      The index to place the number after (defaults to the end)

    Returns void

addConstraint

addConstraints

  • addConstraints(constraints: CCLayoutConstraint[]): void

  • Adds a list of constraints to the view. The first item of the constraints MUST be this view.

    Parameters

    Returns void

    See

    CCLayoutConstraint.active A safer way to enable a constraint

addSubview

becomeFirstResponder

  • becomeFirstResponder(): boolean

  • Notifies the object that it's about to become the first responder.

    Returns boolean

    Whether to accept the first responder status

bringSubviewToFront

convertToWindowSpace

cursorPos

  • cursorPos(): undefined | [CCPoint, number]

  • This is used to place a blinking cursor on screen while not drawing. It's only called on the first responder of a window.

    Returns undefined | [CCPoint, number]

    The position and color of the cursor in window coordinates, or undefined to not place a cursor

didAddSubview

didMoveToSuperview

didRemoveSubview

display

  • display(rect: CCRect): void

  • Displays a view in the specified rectangle. This should not be called by other code.

    Parameters

    • rect: CCRect

      The rectangle to draw inside

    Returns void

draw

  • draw(rect: CCRect): void

  • Draws the view inside the specified rectangle. Override this function to provide custom view types.

    Parameters

    • rect: CCRect

      The rectangle to draw inside

    Returns void

getButton

  • getButton(index: number): undefined | string

  • Returns the text for a button by index.

    Parameters

    • index: number

      The index to get

    Returns undefined | string

    The text for the button, or undefined if out of range

hitTest

  • hitTest(point: CCPoint): undefined | CCView

  • Returns the furthest descendant that contains the specified point.

    Parameters

    • point: CCPoint

      The point to look for

    Returns undefined | CCView

    The deepest view that hit the point, or undefined if none was found

horizontalScrollWheel

interpretKeyEvents

  • interpretKeyEvents(events: CCEvent[]): void

  • Sends a list of key input events to the input manager, which will send back text input events through insertText(text: string).

    Parameters

    • events: CCEvent[]

      The input events to send

    Returns void

keyDown

keyUp

layoutSubtree

  • layoutSubtree(): void

  • Lays out the view hierarchy following constraints. This should only be called on a superview, which is done automatically.

    Returns void

mouseDown

mouseDragged

mouseEntered

mouseExited

mouseMoved

mouseUp

noResponder

  • noResponder(method: string): void

  • Handles when a method action fails to find a responder.

    Parameters

    • method: string

      The method that was attempted

    Returns void

otherMouseDown

otherMouseDragged

otherMouseUp

removeButton

  • removeButton(text: string): void

  • Removes a button from the list.

    Parameters

    • text: string

      The text for the button to remove

    Returns void

    Throws

    If this would remove the last remaining button

  • removeButton(index: number): void

  • Removes a button from the list.

    Parameters

    • index: number

      The index of the button to remove

    Returns void

    Throws

    If the index is out of range, or this would remove the last remaining button

removeConstraint

removeFromSuperview

resignFirstResponder

  • resignFirstResponder(): boolean

  • Notifies the object that it's about to no longer be the first responder.

    Returns boolean

    Whether to resign first responder status

rightMouseDown

rightMouseDragged

rightMouseUp

scrollWheel

sendSubviewToBack

setNeedsDisplay

setNeedsLayout

  • setNeedsLayout(sender: CCView, previous: CCView): void

  • Tells the receiver that the frame or constraints of the sender changed. This triggers the receiver to update its constraints if any are related to the sender, and cascades the message up and down throughout the hierarchy. It will also trigger a cascade on itself if it needs to update constraints.

    Parameters

    • sender: CCView

      The view whose frame and/or constraints changed

    • previous: CCView

      The view that called this method, to prevent backtracking

    Returns void

textInput

tryToCall

  • tryToCall(method: string, ...args: any[]): boolean

  • Attempts to call the specified method on the object, passing the call on to the next responder if this object doesn't implement it.

    Parameters

    • method: string

      The name of the method to call

    • ...args: any[]

      Any parameters to pass to the method

    Returns boolean

    Whether a responder was able to respond to the method

validateProposedFirstResponder

StaticaddConstraintsByCode

  • addConstraintsByCode(code: string, views: { [name: string]: CCView }): void

  • Adds a number of constraints to views using code. This can simplify settings constraints by using familiar code syntax instead of lengthy constraint constructions and activations.

    The syntax is fairly simple:

    <ViewName>.<Attribute> = [<Multiplier> *] <ViewName>.<Attribute> [+|- <Constant>]
<ViewName>.<Attribute> = <Constant>

    The code is processed using Lua as the parser, so it's not strictly required to be in exactly this format; but mind that operators other than add/sub/mul/div/unm aren't supported (and division is only valid if the divisor is a number), and no libraries are available in the environment.

    Parameters

    • code: string

      The constraint code to apply

    • views: { [name: string]: CCView }

      A key-value map of names of views in the code, to the views they represent

    Returns void

Settings

Member Visibility

On This Page

Constructors
Properties
Accessors
Methods