create widget

Create a widget control of the specified kind.

# Metadata

Platforms: desktop, server, mobile OS: mac, windows, linux, ios, android Introduced: 8.0 Security:

# Syntax

create [invisible] widget [controlName] as widgetKind [in {group|card}]

# Params

- controlName : The name to call the newly created <widget>. If you don't specify a name, the <widget> is created with a default name. - widgetKind : The name of the module that defines the widget to be created. - group : A reference or an expression that evaluates to a reference to a group on the current card. If you specify a group, the new <widget> is a member of the <group>, and exists on each <card> that has the <group>. If you don't specify a <group>, the <widget> is created on the current <card> and appears only on that <card>. - card : A reference or an expression that evaluates to a reference to a card. If you specify a card, the new <widget> is a member of the <card>. If you specify neither a <group> nor a <card>, the <widget> is created on the current <card> and appears only on that <card>.

# Examples

create widget "My Navbar" as "com.livecode.widget.navbar"

create group "Swatches" repeat with x = 1 to 20 create invisible widget ("Color Swatch" \ && x) as "com.livecode.widget.colorswatch" in group "Swatches" end repeat

# Description

Use the create widget command to make a new widget control or grouped widget control of kind widgetKind.

If you use the invisible form, the widget is created with its visible property set to false, so it cannot be seen. Use this form to create a hidden widget, change its appearance or position, then make it visible.

When the new widget is created, the pointer tool is automatically chosen.

>*Note:* The LCB extension of the specified kind must have > been loaded using the load extension command. To see a list of the > currently loaded LiveCode Builder extension, use the > loadedExtensions function.

# Tags

objects, extensions,

# See

- **keyword:** it - **property:** kind, visible - **command:** load extension - **function:** loadedExtensions - **glossary:** LiveCode Builder extension - **object:** widget, card, group