# VTextEdit

**Hereda de:** [Widget](https://doc.velneo.com/25/velneo-vdevelop/scripts/lenguajes/javascript/clases/widget).

Esta clase representa al control de edición de texto multilínea. Edita texto normal y enriquecido.

## [Propiedades](#documentación-de-propiedades)

| Tipo          | Propiedad                         |
| ------------- | --------------------------------- |
| const Boolean | [acceptRichText](#acceptrichtext) |
| const Boolean | [modified](#modified)             |
| const Boolean | [readOnly](#readonly)             |

## Funciones

**Generales**

| Retorno | Función                            |
| ------- | ---------------------------------- |
| void    | [append](#append)( String text )   |
| void    | [clear](#clear)()                  |
| void    | [selectAll](#selectall)()          |
| void    | [setText](#settext)( String text ) |
| String  | [text](#text)()                    |

**De portapapeles**

| Retorno | Función                 |
| ------- | ----------------------- |
| Boolean | [canPaste](#canpaste)() |
| void    | [copy](#copy)()         |
| void    | [cut](#cut)()           |
| void    | [paste](#paste)()       |
| void    | [redo](#redo)()         |
| void    | [undo](#undo)()         |

**De toolbars & menu de contexto**

| Retorno | Función                                                             |
| ------- | ------------------------------------------------------------------- |
| void    | [hideAlignToolBar](#hidealigntoolbar)()                             |
| void    | [hideAllToolBars](#hidealltoolbars)()                               |
| void    | [hideFormatToolBar](#hideformattoolbar)()                           |
| void    | [hideListToolBar](#hidelisttoolbar)()                               |
| void    | [hideStyleToolBar](#hidestyletoolbar)()                             |
| void    | [setContextMenuEnabled](#setcontextmenuenabled)( Boolean bEnabled ) |
| void    | [showAlignToolBar](#showaligntoolbar)()                             |
| void    | [showAllToolBars](#showalltoolbars)()                               |
| void    | [showFormatToolBar](#showformattoolbar)()                           |
| void    | [showListToolBar](#showlisttoolbar)()                               |
| void    | [showStyleToolBar](#showstyletoolbar)()                             |

## Señales

| Señal         |
| ------------- |
| Value changed |

## Documentación de propiedades

#### acceptRichText

Devuelve true si el control admite texto enriquecido.

#### modified

Devuelve true si el contenido del control ha sido modificado.

#### readOnly

Devuelve true si el control es de sólo lectura.

## Documentación de funciones

### Funciones generales

#### void append( String text ) <a href="#append" id="append"></a>

Añade un nuevo párrafo con el texto especificado al final del texto editado. El nuevo texto tendrá el mismo formato de carácter y bloque que tenga el párrafo en curso.

Parámetros:

* text: texto a añadir al control.

#### void clear() <a href="#clear" id="clear"></a>

Limpia el contenido del control.

#### void selectAll() <a href="#selectall" id="selectall"></a>

Selecciona todo el contenido del control.

#### void setText( String text ) <a href="#settext" id="settext"></a>

Asigna el texto especificado al control. Cualquier texto que contenga el control será sustituido por el nuevo texto especificado en el parámetro.

Parámetros:

* text: texto a asignar al control.

#### String text() <a href="#text" id="text"></a>

Devuelve el texto del control.

### Funciones de portapapeles

#### Boolean canPaste() <a href="#canpaste" id="canpaste"></a>

Devuelve true si el control permite pegar texto desde el portapapeles o false si pegar está desactivado.

#### void copy() <a href="#copy" id="copy"></a>

Copia el contenido seleccionado del control al portapapeles.

#### void cut() <a href="#cut" id="cut"></a>

Corta el contenido seleccionado del control y lo pasa al portapapeles.

#### void paste() <a href="#paste" id="paste"></a>

Pega el contenido del portapapeles en el control.

#### void redo() <a href="#redo" id="redo"></a>

Deshace el último cambio.

#### void undo() <a href="#undo" id="undo"></a>

Rehace el último cambio.

### Funciones de toolbars & menu de contexto

#### void hideAlignToolBar() <a href="#hidealigntoolbar" id="hidealigntoolbar"></a>

Oculta la toolbar de alineamiento.

#### void hideAllToolBars() <a href="#hidealltoolbars" id="hidealltoolbars"></a>

Oculta todas las toolbars.

#### void hideFormatToolBar() <a href="#hideformattoolbar" id="hideformattoolbar"></a>

Oculta la toolbar de formato.

#### void hideListToolBar() <a href="#hidelisttoolbar" id="hidelisttoolbar"></a>

Oculta la toolbar de listas.

#### void hideStyleToolBar() <a href="#hidestyletoolbar" id="hidestyletoolbar"></a>

Oculta la toolbar de estilos.

#### void setContextMenuEnabled( Boolean bEnabled ) <a href="#setcontextmenuenabled" id="setcontextmenuenabled"></a>

Permite activar o desactivar el menú de contexto.

Parámetros:

* bEnabled: valor booleano. True=El menú contextual está activado. False=El menú contextual está desactivado.

#### void showAlignToolBar() <a href="#showaligntoolbar" id="showaligntoolbar"></a>

Muestra la toolbar de alineamiento.

#### void showAllToolBars() <a href="#showalltoolbars" id="showalltoolbars"></a>

Muestra todas las toolbars.

#### void showFormatToolBar() <a href="#showformattoolbar" id="showformattoolbar"></a>

Muestra la toolbar de formato

#### void showListToolBar() <a href="#showlisttoolbar" id="showlisttoolbar"></a>

Muestra la toolbar de listas.

#### void showStyleToolBar() <a href="#showstyletoolbar" id="showstyletoolbar"></a>

Muestra la barra de estilos.

## Ejemplos

### Ejemplo de copiar el contenido de un control al portapapeles

```javascript
var control = theRoot.dataView().control("CONTROL_TEXTO");
control.selectAll() // Seleccionamos todo el contenido del control
control.copy() // Copiamos la selección al portapapeles
```