UE3:UIToggleButton (UT3)

Object >> UIRoot >> UIScreenObject >> UIObject >> UIButton >> UILabelButton >> UIToggleButton

Package: 

Engine

Implemented interfaces: 

UIDataStorePublisher

This class in other games:

UDK

This button is identical to UIButton, with the exception that pressing this button toggles its pressed state, rather than only remaining in the pressed state while the mouse/key is depressed.

Copyright 1998-2008 Epic Games, Inc. All Rights Reserved.

Properties

Property group 'Data'

CheckedStringRenderComponent

Type: UIComp_DrawString

Modifiers: editinline, const, noclear

Renders the caption for this button when it is checked

Default value: UIComp_DrawString'CheckedLabelStringRenderer'

ValueDataSource

Type: UIRoot.UIDataStoreBinding

Modifiers: private

the data store that this togglebutton retrieves its checked/unchecked value from

Property group 'Image'

CheckedBackgroundImageComponent

Type: UIComp_DrawImage

Modifiers: editinline, const, noclear

Component for rendering the button background image when checked

Default value: UIComp_DrawImage'CheckedBackgroundImageTemplate'

Property group 'Value'

bIsChecked

Type: bool

Modifiers: private

Controls whether this button is considered checked. When bIsChecked is TRUE, CheckedImage will be rendered over the button background image, using the current style.

Default values

Property	Value
OnClicked	ButtonClicked

Subobjects

BackgroundImageTemplate

Class: Engine.UIComp_DrawImage

Inherits from: UILabelButton.BackgroundImageTemplate

No new values.

CheckedBackgroundImageTemplate

Class: Engine.UIComp_DrawImage

Property	Value
ImageStyle	Member Value DefaultStyleTag 'DefaultToggleButtonBackgroundStyle'
StyleResolverTag	'Background Image Style (Checked)'

CheckedLabelStringRenderer

Class: Engine.UIComp_DrawString

Property	Value
StringStyle	Member Value DefaultStyleTag 'DefaultToggleButtonStyle'
StyleResolverTag	'Caption Style (Checked)'

LabelStringRenderer

Class: Engine.UIComp_DrawString

Inherits from: UILabelButton.LabelStringRenderer

No new values.

WidgetEventComponent

Class: Engine.UIComp_Event

Inherits from: UILabelButton.WidgetEventComponent

No new values.

Functions

Native functions

SetCaption

native function SetCaption (string NewText)

Overrides: UILabelButton.SetCaption

Sets the caption for this button.

Parameters:

• NewText - the new caption for the button

SetValue

native final function SetValue (bool bShouldBeChecked, optional int PlayerIndex)

Changed the checked state of this checkbox and activates a checked event.

Parameters:

• bShouldBeChecked - TRUE to turn the checkbox on, FALSE to turn it off
• PlayerIndex - the index of the player that generated the call to SetValue; used as the PlayerIndex when activating UIEvents; if not specified, the value of GetBestPlayerIndex() is used instead.

Other instance functions

ButtonClicked

function bool ButtonClicked (UIScreenObject Sender, int PlayerIndex)

Default handler for the toggle button's OnClick

IsChecked

final function bool IsChecked ()

Returns TRUE if this button is in the checked state, FALSE if in the

OnSetBoolValue

final function OnSetBoolValue (UIAction_SetBoolValue Action)