Referencia de la clase ReadWorkbookAdapter

Adaptador dedicado a la lectura de libros de trabajo. Más...

Diagrama de herencia de ReadWorkbookAdapter

Métodos públicos
	__New (workbook, targetSheet?)
	Crea un adaptor para la lectura de una de las hojas de cálculo de un libro de trabajo específico.
	ReadTable (expectedHeaders :=[])
	Lee la tabla de la hoja de cálculo objetivo.
	ReadRow (row, expectedHeaders :=[])
	Lee la fila solicitada de la hoja de cálculo objetivo.
Métodos públicos heredados de WorkbookWrapper
	__New (workbook, targetSheet?)
	Crea un envoltorio para la administración de un libro de trabajo específico y una de sus hojas de cálculo.
	IsAvailable ()
	Comprueba si el libro de trabajo objetivo está abierto y accesible.
	IsWorkbookLocked ()
	Comprueba si el libro de cálculo objetivo está bloqueado.
	IsSheetLocked ()
	Comprueba si la hoja de cálculo objetivo está bloqueada.
	GetRowCount ()
	Obtiene el número de filas utilizadas en el rango objetivo.
	GetColumnCount ()
	Obtiene el número de columnas utilizadas en el rango objetivo.
	IsTargetSheetEmpty ()
	Comprueba si la hoja de cálculo objetivo está vacía.
	IsTargetWorkbook (workbook)
	Comprueba si un libro de trabajo coincide con el libro objetivo.
	HighlightRow (row)
	Señala con un color amarillo la fila indicada y restablece la anterior.
	ValidateHeaders (expectedHeaders, &missingHeaders :=unset)
	Normaliza las cabeceras de la tabla objetivo y las valida respecto a la colección facilitada.
	FindString (str, lookAt :=2, matchCase :=false)
	Busca una cadena en el rango objetivo y devuelve el número de fila relativa a la primera coincidencia en el rango utilizado.

Otros miembros heredados
Atributos públicos heredados de WorkbookWrapper
	Name => this._name
	{String} Nombre del libro de trabajo objetivo.
	TargetSheetName => this._targetSheetName
	{String} Nombre de la hoja de cálculo objetivo.
Métodos protegidos heredados de WorkbookWrapper
	_LockWorkbook (lock)
	Bloquea el libro de trabajo objetivo impidiendo la manipulación del número de hojas.
	_LockSheet (lock)
	Bloquea la hoja de cálculo objetivo impidiendo la modificación y la selección de sus celdas.
	_DeleteEmptyRows ()
	_GetTargetRange ()
	Obtiene el rango de la primera tabla si existiera, o el rango continuo utilizado.
	_WrapTargetRangeInTable (hasHeaders :=0)
	Envuelve el rango objetivo en una tabla si no existe ninguna.
	_GetRowSafeArray (row)
	Obtiene el contenido de una fila del rango objetivo como un SafeArray COM.
	_NormalizeTableHeaders ()
	Normaliza las cabeceras de la tabla objetivo conforme a __NormalizeHeader.
	_SpeedupIO (i)
Métodos protegidos estáticos heredados de WorkbookWrapper
static	_NormalizeObjProps (obj)
	Normaliza los nombres de las propiedades del objeto indicado conforme a __NormalizeHeader.
static	_CreateInteropArray (size1, size2)
	Crea un SafeArray bidimensional (VT_VARIANT) con índices de base 1 como los que devuelve Interop, que se supone utiliza una versión descontinuada del SafeArray.
Atributos protegidos heredados de WorkbookWrapper
_name	:= unset
_workbook	:= unset
_targetSheet	:= unset
_targetSheetName	:= unset

Descripción detallada

Adaptador dedicado a la lectura de libros de trabajo.

• Conceptualizada para no alterar los datos del libro (excepto las cabeceras que se normalizan).

Autor

bitasuperactive

Fecha

25/12/2025

Versión

0.9.1-Beta

Atención

Dependencias:

• WorkbookWrapper.ahk
• OrObject.ahk
• Utils.ahk

Ver también

https://github.com/bitasuperactive/ahk2-excel-library/blob/master/ExcelLibrary/ExcelBridge/ReadWorkbookAdapter.ahk

Documentación de funciones miembro

__New()

ReadWorkbookAdapter::__New ( workbook , targetSheet?  )

inline

Crea un adaptor para la lectura de una de las hojas de cálculo de un libro de trabajo específico.

• Envuelve los datos preexistentes en una tabla para facilitar su delimitación.

Parámetros

{Microsoft.Office.Interop.Excel.Workbook}	workbook Libro de trabajo objetivo.
{Microsoft.Office.Interop.Excel.Worksheet}	targetSheet (Opcional) Hoja de cálculo objetivo. Por defecto, será la hoja de cálculo activa en el libro objetivo.

Excepciones

{TargetError}	(0x80010108) Si el libro de trabajo objetivo se encuentra cerrado.
{Error}	(0x80010001) Si Microsoft Excel rechaza la conexión a su interfaz.
{ValueError}	Si existe más de tabla definida en la hoja de cálculo objetivo.

ReadRow()

ReadWorkbookAdapter::ReadRow ( row , expectedHeaders : = [] )

inline

Lee la fila solicitada de la hoja de cálculo objetivo.

Parámetros

{Integer}	row Índice de la fila objetivo.
{Array<String>}	expectedHeaders (Opcional) Colección de los nombres de las cabeceras esperadas.

Devuelve

{Object} Objeto literal representativo de la fila objetivo. Sus atributos corresponden con los encabezados de la tabla.

Excepciones

{ValueError}	Si la fila objetivo está fuera del rango utilizado.
{UnsetError}	Si la tabla no contiene alguna de las cabeceras esperadas.

ReadTable()

ReadWorkbookAdapter::ReadTable ( expectedHeaders : = [] )

inline

Lee la tabla de la hoja de cálculo objetivo.

Parámetros

{Array<String>}

expectedHeaders (Opcional) Colección de los nombres de las cabeceras esperadas.

Devuelve

{Array<Object>} Colección de objetos literales representativa de la tabla objetivo. Sus atributos corresponden con los encabezados de la tabla.

Excepciones

{UnsetError}

Si la tabla no contiene alguna de las cabeceras esperadas.

Nota

Rendimiento: Lee +10.000 datos en <1s.