AYUDA EN LÍNEA
 WINDEVWEBDEV Y WINDEV MOBILE

Ayuda / WLanguage / Funciones WLanguage / Funciones estándar / Funciones de archivos XLS
  • Propiedades específicas de las variables de tipo xlsDocument
  • Acceder a una columna de un documento Excel
  • Acceder a una celda de un documento Excel
  • Acceder a una celda de una columna de un documento Excel
  • Acceder a una celda de una fila de un documento Excel
  • Funciones WLanguage que utilizan variables de tipo xlsDocument
WINDEV
WindowsLinuxJavaReportes y ConsultasCódigo de Usuario (UMC)
WEBDEV
WindowsLinuxPHPWEBDEV - Código Navegador
WINDEV Mobile
AndroidWidget Android iPhone/iPadIOS WidgetApple WatchMac Catalyst
Otros
Procedimientos almacenados
Una variable de tipo xlsDocument permite describir y modificar un documento Excel.
Nota: Para obtener más información sobre la declaración de este tipo de variable y el uso de propiedades WLanguage, consulte Declarar una variable.
Novedad versión 2025
Android Este tipo de variable ahora está disponible para aplicaciones Android.
Widget Android Este tipo de variable ahora está disponible para el modo widget de Android.
iPhone/iPad Este tipo de variable ahora está disponible para aplicaciones de iPhone/iPad.
MyWorksheet is xlsDocument
NameXLSFile is string
NameXLSFile = fSelect(fExeDir(), "", "Select a file...", ...
	"All files (*.*)" + TAB + "*.*", "*", fselOpen + fselExist)
IF NameXLSFile = "" THEN RETURN
MyWorksheet = xlsOpen(NameXLSFile, xlsWrite)

// Write OK in the A25 cell
MyWorksheet[25,"A"] = "OK"
// Save
xlsSave(MyWorksheet)
XLSFileID is xlsDocument 
NameXLSFile is string = fExeDir + "\Business info1.xls"

XLSFileID = xlsOpen(NameXLSFile, xlsWrite)
IF ErrorOccurred = False THEN
	Azz is int = xlsCurrentWorksheet(XLSFileID)
	Info("Current worksheet in the Excel file: " + Azz)
	// Change worksheet
	IF xlsCurrentWorksheet(XLSFileID, 2) = True THEN
		Info("The current worksheet was modified.")
		// Read a cell for test
		Info(xlsData(XLSFileID, 11, 2))
	ELSE
		Error("The selected file does not include a second worksheet!")
	END 
ELSE
	Error("Caution, the file is already opened on a computer!")
END
// Create an XLS document
xlsDoc is xlsDocument(xlsVersionXls)
Sintaxis

Declarar un documento XLS sin especificar el formato Ocultar los detalles

MyVariable is xlsDocument
En este caso, la variable creada no corresponde a un formato Excel específico. El formato se definirá al guardar el archivo (según la extensión especificada).

Declarar un documento XLS especificando el formato Ocultar los detalles

MyVariable is xlsDocument(<Format>)
<Format>: Constante de tipo Integer
Formato del documento utilizado. Este parámetro puede corresponder a las siguientes constantes:
xlsVersionUndefinedVersión no definida (valor predeterminado). El formato se definirá al guardar el archivo.
xlsVersionXlsDocumento XLS.
xlsVersionXlsxDocumento XLSX.
Propiedades

Propiedades específicas de las variables de tipo xlsDocument

Las siguientes propiedades permiten definir las características de variables de tipo xlsDocument:
NombreTipo utilizadoEfecto
CellArray de xlsCellCeldas del documento XLS.
ColumnArray de xlsColumnColumna del documento XLS.
CommentArray de xlsCommentComentarios de las celdas de un documento XLS.
FileCharacter stringNombre y ruta completa del archivo XLS asociado al documento. Esta propiedad es de solo lectura. Se asigna al utilizar la función xlsOpen.
Nota: Al asignar una variable de tipo xlsDocument a otra, esta propiedad no se copia (excepto cuando se llama a la función xlsOpen).
ModifiedBoolean
  • True si se modificó el documento
  • False en caso contrario.
Esta propiedad se establece en False después de utilizar la función xlsSave.
NumberColumnIntegerNúmero de columnas en el documento (igual que la función xlsNbColumn, pero ignora las columnas vacías).
Esta propiedad es de solo lectura.
NumberRowIntegerNúmero de filas en el documento (igual que la función xlsNbRow, pero ignora las filas vacías).
Esta propiedad es de solo lectura.
NumberWorksheetIntegerNúmero de hojas de cálculo en el documento (igual que la función xlsNbWorksheet).
Esta propiedad es de solo lectura.
RecalculateWhenLoadingBoolean
  • True si las fórmulas del documento deben volver a calcularse al abrir el documento en Excel u OpenOffice.
  • False si no se debe realizar ningún cálculo al abrir el documento en Excel u OpenOffice.
Nota: Solo se pueden recalcular las fórmulas presentes inicialmente en el documento.
RightToLeftBoolean
  • True si la hoja actual está en modo de lectura "Derecha a izquierda".
  • False si la hoja actual está en modo de lectura "Izquierda a derecha".
RowArray de xlsRowFila del documento XLS.
VersionIntegerVersión del documento XLS (igual que la función xlsVersion). Esta propiedad es de solo lectura.
WorksheetIntegerNúmero de la hoja de cálculo actual (igual que la función xlsCurrentWorksheet).
WorksheetNameCharacter stringNombre de la hoja de cálculo actual. Esta propiedad puede corresponder a una cadena que contenga de 1 a 31 caracteres. No distingue entre mayúsculas y minúsculas.
Observaciones

Acceder a una columna de un documento Excel

Las siguientes sintaxis permiten acceder a una columna de un documento Excel:
  • MyXLSDocument.Column[1]: Accede a la columna 1 del archivo Excel.
  • MyXLSDocument.Column["A"]: Accede a la columna A del archivo Excel.

Acceder a una celda de un documento Excel

Las siguientes sintaxis permiten acceder a una celda de un documento Excel:
  • MyXLSDocument[1,2]: Accede a la celda de la fila 1, columna 2 del archivo Excel.
  • MyXLSDocument[5, "A"]: Accede a la celda de la fila 5, columna A del archivo Excel.

Acceder a una celda de una columna de un documento Excel

Las siguientes sintaxis permiten acceder a una celda de una columna en un documento Excel:
  • MyXLSDocument.Column[1].Cell: Devuelve el valor de la celda de la columna 1 de la fila actual.
  • MyXLSDocument.Column["A"].Cell: Devuelve el valor de la celda de la columna A de la fila actual.

Acceder a una celda de una fila de un documento Excel

La siguiente sintaxis permite acceder a una celda de una fila de un documento Excel:
  • MyXLSDocument.Row[1].Cell[2]: Accede a la celda de la fila 1, columna 2 del archivo Excel.
  • MyXLSDocument.Row[5].Cell["A"]: Accede a la celda de la fila 5, columna A del archivo Excel.

Funciones WLanguage que utilizan variables de tipo xlsDocument

  • Sintaxis estándar:
    xlsAddWorksheetAñade o inserta una nueva hoja de cálculo en un documento Excel.
    xlsCloseCierra un archivo XLS.
    xlsColumnTitleRecupera el título de una columna encontrada en un archivo XLS.
    xlsColumnTypeDevuelve el tipo de datos introducidos en una columna de un archivo XLS.
    xlsCurrentWorksheetSe utiliza para averiguar y modificar la hoja de cálculo actual en un archivo XLS.
    xlsDataRecupera el contenido de una celda de un archivo XLS.
    xlsDeleteWorksheetElimina una hoja de cálculo del documento Excel.
    xlsGetMergeDetermina si una celda está combinada con otras y obtiene el rango de celdas combinadas.
    xlsMergeCellCombina las celdas especificadas en un documento Excel.
    xlsMsgErrorDevuelve el título del último error causado por una función XLS.
    xlsNbColumnDevuelve el número de columnas encontradas en una hoja de cálculo de un archivo XLS.
    xlsNbColumnsxlsNbColumns se mantiene sólo para la compatibilidad con versiones anteriores.
    xlsNbRowDevuelve el número de filas encontradas en un archivo XLS.
    xlsNbRowsxlsNbRows se mantiene sólo para compatibilidad con versiones anteriores.
    xlsNbWorksheetDevuelve el número de hojas de cálculo encontradas en un archivo XLS.
    xlsOpenAbre un archivo Excel (archivos xls o xlsx).
    xlsRecalculateAllRecalcula todas las fórmulas de un documento Excel (XLSX).
    xlsSaveGuarda un documento XLS.
    xlsUnmergeCellAnula la combinación de un rango de celdas.
    xlsVersionDevuelve la versión de Excel que se utilizó para guardar el archivo.
Versión mínima requerida
  • Versión 14
Esta página también está disponible para…
Comentarios
Haga clic en [Agregar] para publicar un comentario

Última modificación: 13/05/2025

Señalar un error o enviar una sugerencia | Ayuda local