---
title: roCharDisplay
slug: develop/rochardisplay
docTags: 
createdAt: 2025-03-11T07:07:18.732Z
---

The *roCharDisplay* object lets you write to a character display as well as set and get its properties.

Object Creation:

```text
CreateObject("roCharDisplay")
```

## if CharDisplay

### Show(row As Integer, col As Integer, txt As String) As Void

Displays text at the prescribed position. This has the following parameters:

- `row` <font color="#6B21A8">int</font>: The row in which to put the text
- `col` <font color="#6B21A8">int</font>: The column in which to put the text
- `txt` <font color="#6B21A8">string</font>: The text as a string

### Clear() as void

Clears the display

### SetPosition (row As Integer, col As Integer) As Void

Positions the cursor. This has the following parameters:

- `row` <font color="#6B21A8">int</font>: The row in which to put the cursor
- `col` <font color="#6B21A8">int</font>: The column in which to put the cursor

### SetCursor(cursor As Integer) As Void

Sets the cursor style. This has the following parameter:

- `cursor` <font color="#6B21A8">int</font>: The preferred cursor style; 0 is off; 1 is blink; 2 is underline; 3 is both

### SetContrast(contrast As Integer) As Void

Set the display contrast. This has the following parameter:

- `contrast` <font color="#6B21A8">int</font>: A value from 0 to 100

### GetContrast() As Integer

Gets the display contrast

### SetBrightness(brightness) As Integer

Set the display brightness. This has the following parameter:

- `brightness` <font color="#6B21A8">int</font>: A value from 0 to 100

### GetBrightness() As Integer

Gets the display brightness

### GetColumns() As Integer

Returns the number of columns. This is useful for writing code that loops over the available rows and columns. 

### GetRows() As Integer

Returns the number of rows. This is useful for writing code that loops over the available rows and columns.