---
title: "Vision - LED Display"
description: "The LED display is a stylized numeric or alphanumeric label."
---

# Vision - LED Display

> The LED display is a stylized numeric or alphanumeric label.

![](LED2.png)

**Component Palette Icon**:

![](LED1.png)

The LED display is a stylized numeric or alphanumeric label. It has three different visual styles: 7-segment, 14-segment, and 5x7 matrix. By default this component is in numeric mode. To display text, switch the component to alphanumeric mode.

## Properties
| Property 	| Description 	| Property Type 	| Scripting 	| Category 	|
|---	|---	|---	|---	|---	|
| Background Color 	| The color of the background. Can be chosen from color wheel, chosen from color palette, or entered as  RGB  or  HSL  value. See [Color Selector](appendix/reference-pages/color-selector-reference/color-selector-reference.mdx). 	| Color 	| .background 	| Appearance 	|
| Border 	| The border surrounding this component. Options are No border, Etched (Lowered), Etched (Raised), Bevel (Lowered), Bevel (Raised), Bevel (Double), and Field Border.**Note**: The border is unaffected by rotation. 	| Border 	| .border 	| Common 	|
| Cursor 	| The mouse cursor to use when hovering over this component. Options are: Default, Crosshair, Text, Wait, Hand, Move, SW Resize, or SE Resize. 	| int 	| .cursorCode 	| Common 	|
| Horizontal Alignment 	| Determines the alignment of the display's contents along the X axis. 	| int 	| .horizontalAlignment 	| Layout 	|
| LED Lit 	| The color of lit LED segments. See [Color Selector](appendix/reference-pages/color-selector-reference/color-selector-reference.mdx). 	| Color 	| .glyphForeground 	| Appearance 	|
| LED Unlit 	| The color of unlit LED segments. See  Color Selector . 	| Color 	| .glyphBackground 	| Appearance 	|
| Letter Gap 	| The percentage of the height to be used as an inter-character spacing. 	| float 	| .gap 	| Layout 	|
| Margin 	| The margin for the interior of the display. 	| Insets 	| .margin 	| Layout 	|
| Mode 	| The mode of the display. 	| int 	| .mode 	| Behavior 	|
| Mouseover Text 	| The text that is displayed in the tooltip which pops up on mouseover of this component. 	| String 	| .toolTipText 	| Common 	|
| Name 	| The name of this component. 	| String 	| .name 	| Common 	|
| Number Format Pattern 	| The number formatting string used to format the value. 	| String 	| .numberFormat 	| Behavior 	|
| Quality 	| The data quality code for any Tag bindings on this component. 	| QualityCode 	| .quality 	| Data 	|
| Style 	| The visual style of the display. 	| int 	| .style 	| Appearance 	|
| Styles 	| **Contains the component's styles.** 	| Dataset 	| .styles 	| Appearance 	|
| Text 	| The text value of the display, used when **Mode** is **Alphanumeric**. 	| String 	| .text 	| Data 	|
| Value 	| The numeric value of the display, used when **Mode** is **Numeric**. 	| double 	| .value 	| Data 	|
| Visible 	| If disabled, the component will be hidden. 	| boolean 	| .visible 	| Common 	|

### Deprecated Properties
| Property 	| Description 	| Property Type 	| Scripting 	| Category 	|
|---	|---	|---	|---	|---	|
| Data Quality 	| The data quality code for any Tag bindings on this component. 	| int 	| .dataQuality 	| Deprecated 	|

## Scripting

### Component Functions
This component does not have component functions associated with it.

### Extension Functions
This component does not have extension functions associated with it.

### Event Handlers
Event handlers allow you to run a script based off specific triggers. See the full list of available event handlers on the [Component Events](ignition-modules/vision/scripting-in-vision/component-events/component-events.md) page

## Customizers
+ [Vision Component Customizers](ignition-modules/vision/working-with-vision-components/vision-component-customizer/vision-component-customizer.md)
+ [Style Customizer](ignition-modules/vision/working-with-vision-components/vision-component-customizer/vision-component-customizer.md#style-customizer)

## Examples

#### Custom LED Component
![](led6.png)

|Property Name|Value|
|:---|:---|
|Mode|Alphanumeric|
|Text|ERR-28|
|Background Color|0,0,0|
|LED Lit|255,0,0|
|LED Unlit|0,0,0|

#### Custom LED Component
![](led3.png)

|Property Name|Value|
|:---|:---|
|Mode|Alphanumeric|
|Text|Hello World|
|Horizontal Alignment|Center|

#### Custom LED Component
![](led4.png)

|Property Name|Value|
|:---|:---|
|Border|Line Border|
|Mode|Alphanumeric|
|Text|852.23 lbs|
|Style|7 Segment|
|Background Color|255,255,255|
|LED Lit|0,0,0|
|LED Unlit|255,255,255|

#### Custom LED Component
![](led5.png)

|Property Name|Value|
|:---|:---|
|Style|5x7 Matrix|
|Background Color|255,255,255|
|Horizontal Alignment|Right|