DCheckBoxLabel

Description

The DCheckBoxLabel is a DCheckBox with a DLabel next to it. It allows you to get a boolean value from the user (true/false - yes/no)

Parent

Derives methods, etc not listed on this page from DPanel.

Implements

Implements or overrides the following hooks/methods. If you want to override these, you probably want to call the original function too.

Events

DCheckBoxLabel:OnChange( boolean bVal )

Called when the "checked" state is changed.

Methods

boolean DCheckBoxLabel:GetChecked()

Gets the checked state of the checkbox. This calls the checkbox's DCheckBox:GetChecked function.

number DCheckBoxLabel:GetIndent()

Gets the indentation of the element on the X axis.

DCheckBoxLabel:SetBright( boolean bright )

We advise against using this. It may be changed or removed in a future update. You really should be using DCheckBoxLabel:SetTextColor instead Sets the color of the DCheckBoxLabel's text to the bright text color defined in the skin.

DCheckBoxLabel:SetChecked( boolean checked )

Sets the checked state of the checkbox. Does not call DCheckBoxLabel:OnChange or Panel:ConVarChanged, unlike DCheckBoxLabel:SetValue.

DCheckBoxLabel:SetConVar( string convar )

Sets the console variable to be set when the checked state of the DCheckBoxLabel changes.

DCheckBoxLabel:SetDark( boolean darkify )

We advise against using this. It may be changed or removed in a future update. You really should be using DCheckBoxLabel:SetTextColor instread Sets the text of the DCheckBoxLabel to be dark colored.

DCheckBoxLabel:SetFont( string font )

Sets the font of the text part of the DCheckBoxLabel.

DCheckBoxLabel:SetIndent( number ident )

Sets the indentation of the element on the X axis.

DCheckBoxLabel:SetTextColor( table color )

Sets the text color for the DCheckBoxLabel.

DCheckBoxLabel:SetValue( boolean checked )

Sets the checked state of the checkbox, and calls DCheckBoxLabel:OnChange and the checkbox's Panel:ConVarChanged methods.

DCheckBoxLabel:Toggle()

Toggles the checked state of the DCheckBoxLabel.

Example

Creates a DCheckBoxLabel, ties it to a convar, and sets its initial value.

concommand.Add( "example_checkboxlabel", function( ply, cmd, args ) local window = vgui.Create( "DFrame" ) window:SetSize( 300, 200 ) window:Center() window:MakePopup() local DermaCheckbox = window:Add( "DCheckBoxLabel" ) -- Create the checkbox DermaCheckbox:SetPos( 25, 50 ) -- Set the position DermaCheckbox:SetText("God Mode") -- Set the text next to the box DermaCheckbox:SetConVar("sbox_godmode") -- Change a ConVar when the box it ticked/unticked DermaCheckbox:SetValue( true ) -- Initial value DermaCheckbox:SizeToContents() -- Make its size the same as the contents end )

Output: