# VFilePathEditBrowser

**Hereda de:** [VLineEditBrowser](https://doc.velneo.com/27/velneo-vdevelop/scripts/lenguajes/javascript/clases/vlineeditbrowser).

Esta clase representa al control de edición para sendas de ficheros o directorios. Tiene un botón que al ser pulsado presenta un cuadro de diálogo para seleccionar el fichero o directorio.

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

| Tipo    | Función                       |
| ------- | ----------------------------- |
| Boolean | [showDirsOnly](#showdirsonly) |

## Funciones

**Generales**

| Retorno | Función                                                                 |
| ------- | ----------------------------------------------------------------------- |
| Boolean | [isShowDirsOnly](#isshowdirsonly)()                                     |
| void    | [setDialogCaption](#setdialogcaption)( String caption )                 |
| void    | [setDialogDir](#setdialogdir)( String dir )                             |
| void    | [setDialogFilter](#setdialogfilter)( String filter )                    |
| void    | [setDialogSelectedFilter](#setdialogselectedfilter)( String selFilter ) |

## Señales

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

## Documentación de propiedades

#### showDirsOnly

Muestra únicamente los directorios, no muestra ficheros, etc.

## Documentación de funciones

### Funciones generales

#### Boolean isShowDirsOnly() <a href="#isshowdirsonly" id="isshowdirsonly"></a>

Devuelve true si el control está configurado para mostrar solo directorios.

#### void setDialogCaption( String caption ) <a href="#setdialogcaption" id="setdialogcaption"></a>

Permite configurar el texto del título de la ventana.

Parámetros:

* caption: textos a mostrar en el título de la ventana.

Ejemplo:

var pathEdit = theRoot.dataView().control("FILE");

pathEdit.setDialogCaption( "Seleccione fichero xbel 1.0" );

pathEdit.setDialogFilter( "XBEL files (\*.xbel);;XML files (\*.xml)" );

pathEdit.setDialogSelectedFilter( "XBEL files (\*.xbel)" );

#### void setDialogDir( String dir ) <a href="#setdialogdir" id="setdialogdir"></a>

Permite configurar el directorio que por defecto saldrá seleccionado y cuyos ficheros estarán visibles.

Parámetros:

* dir: senda del directorio por defecto.

Ejemplo:

```javascript
var pathEdit = theRoot.dataView().control("FILE");
pathEdit.setDialogDir( "C:\rss" );
```

#### void setDialogFilter( String filter ) <a href="#setdialogfilter" id="setdialogfilter"></a>

Permite configurar el filtro con los tipos de ficheros que estarán incluidos en el combobox de selección.

Parámetros:

* filter: filtros de ficheros a incluir en el combobox de selección de tipo de fichero.

Ejemplo:

```javascript
var pathEdit = theRoot.dataView().control("FILE");
pathEdit.setDialogCaption( "Seleccione fichero xbel 1.0" );
pathEdit.setDialogFilter( "XBEL files (*.xbel);;XML files (*.xml)" );
pathEdit.setDialogSelectedFilter( "XBEL files (*.xbel)" );
```

#### void setDialogSelectedFilter( String selFilter ) <a href="#setdialogselectedfilter" id="setdialogselectedfilter"></a>

Permite configurar cuál de los filtros incluidos en el combobox de selección saldrá selección por defecto.

Parámetros:

* selFilter: filtro que saldrá seleccionado por defecto en el combobox de selección.

Ejemplo:

```javascript
var pathEdit = theRoot.dataView().control("FILE");
pathEdit.setDialogCaption( "Seleccione fichero xbel 1.0" );
pathEdit.setDialogFilter( "XBEL files (*.xbel);;XML files (*.xml)" );
pathEdit.setDialogSelectedFilter( "XBEL files (*.xbel)" );
```