Clase Workbooks (Excel VBA)

Colección de todos los objetos Workbook abiertos actualmente en la aplicación Microsoft Excel. Para usar una variable de clase Workbooks, primero debe ser instanciado, por ejemplo

Dim wrks as Workbooks
Set wrks = Workbooks

For Each

A continuación, se muestra un ejemplo de cómo procesar los elementos Workbooks en una colección.

Dim wb As Workbook
For Each wb In Workbooks
	
Next wb

Add

Crea un nuevo libro. El nuevo libro se convierte en el libro activo.

Si el argumento Template especifica un archivo, el nombre de archivo puede incluir una ruta de acceso.

Add (Template)

Template: Determina cómo se crea el nuevo libro. Si este argumento es una cadena que especifica el nombre de un archivo existente de Microsoft Excel, se crea el nuevo libro con el archivo especificado como plantilla. Si el argumento es una constante, el nuevo libro contiene una sola hoja del tipo especificado. Puede ser una de las siguientes constantes XlWBATemplate : xlWBATChart, xlWBATExcel4IntlMacroSheet, xlWBATExcel4MacroSheeto xlWBATWorksheet. Si omite este argumento, Microsoft Excel crea un nuevo libro con varias hojas en blanco (la cantidad de hojas la establece la propiedad SheetsInNewWorkbook).

Dim wb As Workbook
Set wb = Workbooks.Add()

CanCheckOut

True si Microsoft Excel puede desproteger un libro específico de un servidor. Boolean de lectura y escritura.

CanCheckOut (Filename)

Filename: Nombre del archivo que se va a desproteger.

Dim strFilename As String: strFilename = 
Dim booCanCheckOut As Boolean
booCanCheckOut = Workbooks.CanCheckOut(Filename:=strFilename)

CheckOut

Devuelve una String que representa un libro especificado de un servidor a un equipo local para su modificación.

CheckOut (Filename)

Filename: Nombre del archivo que se va a desproteger.

Dim strFilename As String: strFilename = 
Workbooks.CheckOut Filename:=strFilename

Close

Cierra el objeto.

Al cerrar un libro desde Visual Basic no se ejecuta ninguna de las macros Auto_cerrar del libro. Use el método RunAutoMacros para ejecutar las macros de cierre automático.

Workbooks.Close

Count

Devuelve un valor Long que representa el número de objetos de la colección.

Dim lngCount As Long
lngCount = Workbooks.Count

Item

Devuelve un solo objeto de una colección.

Item (Index)

Index: Nombre o número de índice del objeto.

Dim wbItem As Workbook
Set wbItem = Workbooks(Index:=1)

Open

Abre un libro.

De manera predeterminada, las macros están habilitadas al abrir los archivos mediante programación. Use la propiedad AutomationSecurity para establecer el modo de seguridad de macros que se utiliza al abrir archivos mediante programación. Puede especificar uno de los valores siguientes en el parámetro UpdateLinks para determinar si las referencias externas (vínculos) se actualizan al abrir el libro.

Open (Filename, UpdateLinks, ReadOnly, Format, Password, WriteResPassword, IgnoreReadOnlyRecommended, Origin, Delimiter, Editable, Notify, Converter, AddToMru, Local, CorruptLoad)

Dim strFilename As String: strFilename = 
Dim wb As Workbook
Set wb = Workbooks.Open(Filename:=strFilename)

Arguments

Un argumento con nombre

Filename (String) - El nombre de archivo del libro que se debe abrir.

Optional arguments

Los siguientes argumentos son opcionales

UpdateLinks - Especifica la forma en que se actualizan las referencias externas (vínculos) del archivo, como la referencia a un rango en el libro Budget. xls =SUM([Budget.xls]Annual!C10:C25)en la fórmula siguiente. Si no se especifica este argumento, se pide al usuario que especifique cómo se deben actualizar los vínculos. Para obtener más información acerca de los valores que se usan con este parámetro, vea la sección de comentarios. Si Microsoft Excel abre un archivo en formato WKS, WK1 o WK3 y el argumento UpdateLinks es 0, no se creará ningún gráfico; de lo contrario, Microsoft Excel genera gráficos a partir de los gráficos adjuntos al archivo

ReadOnly (Boolean) - True para abrir el libro en modo de solo lectura.

Format (String) - Si Microsoft Excel abre un archivo de texto, este argumento especifica el carácter delimitador. Si este argumento se omite, se usará el delimitador actual. Para obtener más información sobre los valores que usa este parámetro, consulte la sección Comentarios.

Password (String) - Cadena que contiene la contraseña necesaria para abrir un libro protegido. Si este argumento se omite y el libro requiere contraseña, se solicita al usuario que especifique la contraseña.

WriteResPassword - Cadena que contiene la contraseña necesaria para abrir un libro protegido contra escritura. Si este argumento se omite y el libro requiere contraseña, se solicita al usuario que especifique la contraseña

IgnoreReadOnlyRecommended (Boolean) - True para que Microsoft Excel no muestre el mensaje de solo lectura recomendada (si el libro se guardó mediante la opción Recomendado solo lectura).

Origin (XlPlatform) - Si el archivo es un archivo de texto, este argumento indica su origen, de modo que las páginas de código y retorno de carro, avance de línea (CR/LF) se puedan asignar correctamente. Puede ser una de las siguientes constantes XlPlatform : xlMacintosh, xlWindowso xlMSDOS. Si este argumento se omite, se usará el sistema operativo actual.

Posibles valores de retorno son xlMacintosh - Equipos, xlMSDOS - MS-DOS, xlWindows - Microsoft Windows.

Delimiter (String) - Si el archivo es un archivo de texto y el argumento de formato es 6, este argumento es una cadena que especifica el carácter que se va a utilizar como delimitador. Por ejemplo, use Chr(9) para tabulaciones, use "," para comas, use ";" para puntos y coma o use un carácter personalizado. Solo se usa el primer carácter de la cadena.

Editable (Boolean) - Si el archivo es un complemento de Microsoft Excel 4,0, este argumento es true para abrir el complemento para que sea una ventana visible. Si este argumento es false o se omite, el complemento se abre como oculto y no se puede mostrar. Esta opción no se aplica a complementos creados en Microsoft Excel 5,0 o posterior. Si el archivo es una plantilla de Excel, true para abrir la plantilla especificada para su edición. False para abrir un nuevo libro basado en la plantilla especificada. El valor predeterminado es False.

Notify (Boolean) - Si el archivo no se puede abrir en modo de lectura o escritura, este argumento es True para agregar el archivo a la lista de notificaciones de archivo. Microsoft Excel abrirá el archivo en modo de solo lectura, sondeará la lista de notificaciones de archivo y notificará al usuario cuando el archivo se haga disponible. Si este argumento es False o se omite, no se solicita ninguna notificación y se producirá un error al intentar archivos no disponibles.

Converter - Índice del primer convertidor de archivos que se debe probar al abrir el archivo. El convertidor de archivos especificado se intenta en primer lugar; si el convertidor no reconoce el archivo, se prueban todos los demás convertidores. El índice del convertidor consta de los números de fila de los convertidores devueltos por la propiedad FileConverters

AddToMru (Boolean) - True para agregar este libro a la lista de archivos usados recientemente. El valor predeterminado es False.

Local - True guarda los archivos contra el idioma de Microsoft Excel (incluida la configuración del panel de control). False (valor predeterminado) guarda los archivos contra el idioma de Visual Basic para aplicaciones (VBA) (que suele ser inglés (Estados Unidos) a menos que el proyecto de VBA en el que se ejecuta Workbooks.Open es de un proyecto de VBA para XL5/95 antiguo internacionalizado)

CorruptLoad (XlCorruptLoad) - Puede ser una de las constantes siguientes: xlNormalLoad, xlRepairFile y xlExtractData. El comportamiento predeterminado si no se especifica ningún valor es xlNormalLoady no intenta recuperarse cuando se inicia a través del OM.

Posibles valores de retorno son xlExtractData - El libro se abre en el modo de extracción de datos, xlNormalLoad - El libro se abre normalmente, xlRepairFile - El libro se abre en el modo de reparación.

OpenDatabase

Devuelve un objeto Workbook que representa una base de datos.

OpenDatabase (Filename, CommandText, CommandType, BackgroundQuery, ImportDataAs)

Dim strFilename As String: strFilename = 
Dim wbOpenDatabase As Workbook
Set wbOpenDatabase = Workbooks.OpenDatabase(Filename:=strFilename)

Arguments

Un argumento con nombre

Filename (String) - La cadena de conexión que contiene la ubicación y el nombre de archivo de la base de datos.

Optional arguments

Los siguientes argumentos son opcionales

CommandText (String) - Texto del comando de la consulta.

CommandType (XlCmdType) - Tipo del comando de la consulta. Especifique una de las constantes de la enumeración XlCmdType : xlCmdCube, xlCmdList, xlCmdSql, xlCmdTabley xlCmdDefault.

Valores posibles son

BackgroundQuery (Boolean) - Este parámetro es un tipo de datos Variant, pero solo puede pasar un valor booleano . Si se pasa el valor True, la consulta se realiza en segundo plano (asincrónicamente). El valor predeterminado es False.

ImportDataAs (XlImportDataAs) - Este parámetro usa uno de los valores de la enumeración XlImportDataAs . Los dos valores de dicha enumeración son xlPivotTableReport y xlQueryTable. Pase uno de estos valores para devolver los datos como una tabla dinámica o como una tabla de consulta. El valor predeterminado es xlQueryTable.

Posibles valores de retorno son xlPivotTableReport - Devuelve los datos como una tabla dinámica, xlQueryTable - Devuelve los datos como una tabla de consulta, xlTable.

OpenText

Carga y redistribuye un archivo de texto como un libro nuevo con una sola hoja que contiene los datos de archivo de texto redistribuidos.

FieldInfo (parámetro) Puede usar xlEMDFormat solo si ha instalado y seleccionado compatibilidad para el taiwanés. La constante xlEMDFormat especifica que se usan fechas de era de Taiwán. Los especificadores de columna pueden tener cualquier orden. Si no hay ningún especificador de columna para una columna concreta en los datos de entrada, la columna se redistribuye con la configuración general. En este ejemplo, se hace que la tercera columna se redistribuya como MDA (por ejemplo, 01/10/1970), que la primera columna se analice como texto y que las columnas restantes se redistribuyan con la configuración General.

OpenText (Filename, Origin, StartRow, DataType, TextQualifier, ConsecutiveDelimiter, Tab, Semicolon, Comma, Space, Other, OtherChar, FieldInfo, TextVisualLayout, DecimalSeparator, ThousandsSeparator, TrailingMinusNumbers, Local)

Dim strFilename As String: strFilename = 
Workbooks.OpenText Filename:=strFilename

Arguments

Un argumento con nombre

Filename (String) - Especifica el nombre de archivo del archivo de texto que se debe abrir y redistribuir.

Optional arguments

Los siguientes argumentos son opcionales

Origin (XlPlatform) - Especifica el origen del archivo de texto. Puede ser una de las siguientes constantes XlPlatform : xlMacintosh, xlWindowso xlMSDOS. Además, puede ser un entero que representa la página de código de la página de código deseada. Por ejemplo, "1256" especificaría que la codificación del archivo de texto de origen es Árabe (Windows). Si se omite este argumento, el método utiliza la configuración actual de la opción origen del archivo en el Asistente para importar texto.

Posibles valores de retorno son xlMacintosh - Equipos, xlMSDOS - MS-DOS, xlWindows - Microsoft Windows.

StartRow (Long) - Número de fila en la que se debe iniciar el análisis del texto. El valor predeterminado es 1.

DataType (XlTextParsingType) - Especifica el formato de columna de los datos del archivo. Puede ser una de las siguientes constantes XlTextParsingType : xlDelimited o xlFixedWidth. Si este argumento no se especifica, Microsoft Excel intenta determinar el formato de columna al abrir el archivo.

Posibles valores de retorno son xlDelimited - Valor predeterminado, xlFixedWidth.

TextQualifier (XlTextQualifier) - Especifica el calificador de texto.

Posibles valores de retorno son xlTextQualifierDoubleQuote - Comillas dobles ("), xlTextQualifierNone - Sin carácter delimitador, xlTextQualifierSingleQuote - Comillas simples (').

ConsecutiveDelimiter (Boolean) - True para que los delimitadores consecutivos se consideren como un delimitador. El valor predeterminado es False.

Tab (Tab) - True para que el carácter de tabulador sea el delimitador (el tipo de datos debe ser xlDelimited). El valor predeterminado es False.

Semicolon (XlTextParsingType) - True para que el carácter de punto y coma sea el delimitador (el tipo de datos debe ser xlDelimited). El valor predeterminado es False.

Posibles valores de retorno son xlDelimited - Valor predeterminado, xlFixedWidth.

Comma (XlTextParsingType) - True para que el carácter de coma sea el delimitador (el tipo de datos debe ser xlDelimited). El valor predeterminado es False.

Posibles valores de retorno son xlDelimited - Valor predeterminado, xlFixedWidth.

Space (XlTextParsingType) - True para que el carácter de espacio sea el delimitador (el tipo de datos debe ser xlDelimited). El valor predeterminado es False.

Posibles valores de retorno son xlDelimited - Valor predeterminado, xlFixedWidth.

Other (XlTextParsingType) - True para que el carácter especificado por el argumento OtherChar sea el delimitador (DataType debe ser xlDelimited). El valor predeterminado es False.

Posibles valores de retorno son xlDelimited - Valor predeterminado, xlFixedWidth.

OtherChar (String) - Obligatorio si other es true. Especifica el carácter delimitador cuando other es true. Si se especifica más de un carácter, solo se usará el primero de la cadena de caracteres y no se tendrá en cuenta el resto.

FieldInfo (XlColumnDataType) - Matriz que contiene información de análisis para columnas individuales de datos. La interpretación depende del valor de DataType. Si los datos están delimitados, el argumento será una matriz de matrices de dos elementos, cada una de las cuales especificará las opciones de conversión de una columna en particular. El primer elemento es el número de columna (de base 1) y el segundo elemento es una de las constantes xlColumnDataType que especifican cómo se analiza la columna.

Aquí puede ver valores posibles para XlColumnDataType

TextVisualLayout - Diseño visual del texto

DecimalSeparator (String) - Separador decimal utilizado por Microsoft Excel para identificar las cifras. El valor predeterminado es el de la configuración del sistema.

ThousandsSeparator (String) - Separador de miles utilizado por Excel para identificar las cifras. El valor predeterminado es el de la configuración del sistema.

TrailingMinusNumbers (Boolean) - Especifique True si los números con un carácter de menos al final deben considerarse como números negativos. Si False o se omite, los números con un carácter de menos al final se tratan como texto.

Local (Boolean) - Especifique true si se debe usar la configuración regional del equipo para separadores, números y formato de datos.

OpenXML

Abre un archivo de datos XML. Devuelve un objeto Workbook .

OpenXML (Filename, Stylesheets, LoadOption)

Dim strFilename As String: strFilename = 
Dim wbOpenXML As Workbook
Set wbOpenXML = Workbooks.OpenXML(Filename:=strFilename)

Arguments

Un argumento con nombre

Filename (String) - Nombre del archivo que se desea abrir.

Optional arguments

Los siguientes argumentos son opcionales

Stylesheets (String) - Puede ser un valor único o una matriz de valores que especifiquen qué instrucciones de procesamiento de hoja de estilo XSLT deben aplicarse.

LoadOption (XlXmlLoadOption) - Especifica cómo abre Excel el archivo de datos XML. Puede ser una de las constantes XlXmlLoadOption .

Valores posibles son