Classe Workbooks (Excel VBA)

Collection de tous les objets Workbook actuellement ouverts dans l'application Microsoft Excel. Pour utiliser une variable de classe Workbooks, elle doit d'abord être instanciée, par exemple


Dim wrks as Workbooks
Set wrks = Workbooks

For Each

Voici un exemple de traitement des éléments Workbooks dans une collection


Dim wb As Workbook
For Each wb In Workbooks
	
Next wb

Add

Crée un classeur. Le nouveau classeur devient le classeur actif.

Si l’argument modèle spécifie un fichier, le nom de fichier peut inclure un chemin d’accès.

Add (Template)

Template: Détermine la façon dont le nouveau classeur est créé. Si cet argument est une chaîne spécifiant le nom d'un fichier Microsoft Excel existant, le nouveau classeur est créé d'après le modèle de ce fichier. Si cet argument est une constante, le nouveau classeur contient une seule feuille du type spécifié. Il peut s’agir de l’une des constantes XlWBATemplate suivantes: xlWBATChart, xlWBATExcel4IntlMacroSheet, xlWBATExcel4MacroSheetou xlWBATWorksheet. Si cet argument est omis, Microsoft Excel crée un classeur avec un certain nombre de feuilles vierges (le nombre de feuilles est défini par la propriété SheetsInNewWorkbook).


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

CanCheckOut

Cette méthode a la valeur True si Microsoft Excel peut extraire un classeur spécifié se trouvant sur un serveur. Boolean (en lecture/écriture).

CanCheckOut (Filename)

Filename: Représente le nom du fichier à extraire.


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

CheckOut

Cette méthode renvoie un objet String représentant un classeur spécifié transmis d'un serveur à un ordinateur local afin de le modifier.

CheckOut (Filename)

Filename: Représente le nom du fichier à extraire.


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

Close

Cette méthode ferme l'objet.

Fermer un classeur à partir de Visual Basic n'entraîne pas l'exécution d'une macro AutoClose dans le classeur. Utilisez la méthode RunAutoMacros pour exécuter les macros de fermeture automatique.


Workbooks.Close

Count

Cette propriété renvoie une valeur de type Long qui représente le nombre d’objets de la collection.


Dim lngCount As Long
lngCount = Workbooks.Count

Item

Cette méthode renvoie un seul objet d'une collection.

Item (Index)

Index: Nom ou numéro d'index de l'objet.


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

Open

Ouvre un classeur.

Par défaut, les macros sont activées lors de l'ouverture des fichiers par programmation. Utilisez la propriété AutomationSecurity pour définir le mode de sécurité des macros utilisé lors de l’ouverture de fichiers par programme. Vous pouvez spécifier l’une des valeurs suivantes dans le paramètre UpdateLinks pour déterminer si les références externes (liens) sont mises à jour à l’ouverture du classeur.

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 argument nommé

Filename (String) - Nom de fichier du classeur à ouvrir.

Optional arguments

Les arguments suivants sont facultatifs

UpdateLinks - Indique la façon dont les références externes (liens) dans le fichier, telles que la référence à une plage du classeur budget. xls dans la =SUM([Budget.xls]Annual!C10:C25)formule suivante, sont mises à jour. Si cet argument est omis, l’utilisateur est invité à indiquer comment les liens doivent être mis à jour. Pour plus d’informations sur les valeurs utilisées par ce paramètre, voir la section Remarques. Si Microsoft Excel ouvre un fichier au format WKS, WK1 ou WK3 et que l’argument UpdateLinks a la valeur 0, aucun graphique n’est créé; dans le cas contraire, Microsoft Excel génère des graphiques à partir des graphiques attachés au fichier

ReadOnly (Boolean) - True pour ouvrir le classeur en mode lecture seule.

Format (String) - Si Microsoft Excel ouvre un fichier texte, cet argument spécifie le caractère délimiteur. Si cet argument n'est pas défini, le délimiteur en cours est utilisé. Pour plus d'informations sur les valeurs utilisées par ce paramètre, consultez la section Remarques.

Password (String) - Chaîne contenant le mot de passe requis pour ouvrir un classeur protégé. Si cet argument n'est pas défini et que le classeur requiert un mot de passe, l'utilisateur est invité à entrer le mot de passe.

WriteResPassword - Chaîne contenant le mot de passe requis pour écrire dans un classeur protégé en écriture. Si cet argument n'est pas défini et que le classeur requiert un mot de passe, l'utilisateur est invité à entrer le mot de passe

IgnoreReadOnlyRecommended (Boolean) - True pour que Microsoft Excel n'affiche pas le message en lecture seule recommandée (si le classeur a été enregistré avec l'option Lecture seule recommandée).

Origin (XlPlatform) - S’il s’agit d’un fichier texte, cet argument indique sa provenance, de sorte que les pages de code et les retours chariot/sauts de ligne (CR/LF) puissent être mappés correctement. Il peut s’agir de l’une des constantes XlPlatform suivantes: xlMacintosh, xlWindowsou xlMSDOS. Si cet argument n'est pas défini, le système d'exploitation en cours est utilisé.

Les valeurs de retour possibles sont xlMacintosh - Macintosh, xlMSDOS - MSDOS, xlWindows - Microsoft Windows.

Delimiter (String) - Si le fichier est un fichier texte et que l’argument format a la valeur 6, cet argument est une chaîne qui spécifie le caractère à utiliser comme délimiteur. Par exemple, utilisez Chr(9) pour les tabulations, « , » pour les virgules, « ; » pour les point-virgules, ou utilisez un caractère personnalisé. Seul le premier caractère de la chaîne est utilisé.

Editable (Boolean) - Si le fichier est une macro complémentaire Microsoft Excel 4.0, cet argument a la valeur True pour ouvrir la macro complémentaire de sorte qu'elle soit une fenêtre visible. Si cet argument a la valeur False ou n'est pas défini, la macro complémentaire est ouverte masquée, et ne peut pas être affichée. Cette option ne s'applique pas aux compléments créés dans Microsoft Excel 5.0 ou version ultérieure. Si le fichier est un modèle Excel, la valeur True ouvre le modèle spécifié pour modification. La valeur False ouvre un nouveau classeur basé sur le modèle spécifié. La valeur par défaut est False.

Notify (Boolean) - Si le fichier ne peut pas être ouvert en mode lecture-écriture, cet argument a la valeur True pour ajouter le fichier à la liste de notification des fichiers. Microsoft Excel ouvre le fichier en lecture seule, interroge la liste de notification des fichiers, puis avertit l’utilisateur quand le fichier devient disponible. Si cet argument a la valeur False ou n'est pas défini, aucune notification n’est requise, et toute tentative d’ouverture d’un fichier indisponible échoue.

Converter - Index du premier convertisseur de fichier à essayer lors de l’ouverture du fichier. Le convertisseur de fichier spécifié est d’abord essayé; Si ce convertisseur ne reconnaît pas le fichier, tous les autres convertisseurs sont essayés. L’index du convertisseur se compose des numéros de ligne des convertisseurs renvoyés par la propriété FileConverters

AddToMru (Boolean) - True pour ajouter ce classeur à la liste des derniers fichiers utilisés. La valeur par défaut est False.

Local - True enregistre les fichiers par rapport à la langue de Microsoft Excel (y compris les paramètres du Panneau de configuration). Valeur false (valeur par défaut) enregistre les fichiers par rapport à la langue de Visual Basic pour applications (VBA) (il s’agit généralement de l’anglais (États-Unis), sauf si le projet VBA dans lequel l’exécution de Workbooks. Open est exécuté est un ancien projet VBA XL5/95

CorruptLoad (XlCorruptLoad) - Il peut s’agir de l’une des constantes suivantes: xlNormalLoad, xlRepairFile et xlExtractData. Le comportement par défaut si aucune valeur n’est spécifiée est xlNormalLoadet ne tente pas de récupérer lors de l’initialisation via le modèle objet.

Les valeurs de retour possibles sont xlExtractData - Le classeur est ouvert en mode extraction des données, xlNormalLoad - Le classeur est ouvert normalement, xlRepairFile - Le classeur est ouvert en mode réparation.

OpenDatabase

Renvoie un objet Workbook qui représente une base de données.

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


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

Arguments

Un argument nommé

Filename (String) - Chaîne de connexion qui contient l’emplacement et le nom de fichier de la base de données.

Optional arguments

Les arguments suivants sont facultatifs

CommandText (String) - Texte de commande de la requête.

CommandType (XlCmdType) - Type de commande de la requête. Spécifiez l’une des constantes de l’énumération XlCmdType : xlCmdCube, xlCmdList, xlCmdSql, xlCmdTableet xlCmdDefault.

Valeurs possibles sont

xlCmdCube	Contient un nom de cube pour une source de données OLAP.
xlCmdDAX	Contient une formule DAX (Data Analysis Expressions).
xlCmdDefault	Contient du texte de commande que peut interpréter le fournisseur OLE DB.
xlCmdExcel	Contient une formule Excel.
xlCmdList	Contient un pointeur vers des données de listes.
xlCmdSql	Contient une instruction SQL.
xlCmdTable	Contient le nom d'une table pour accéder aux sources de données OLE DB.
xlCmdTableCollection	Contient le nom d’une collection de tables.

BackgroundQuery (Boolean) - Ce paramètre est un type de données Variant, mais vous ne pouvez transmettre qu’une valeur de type Boolean . Si vous passez True, la requête est exécutée en arrière-plan (de façon asynchrone). La valeur par défaut est False.

ImportDataAs (XlImportDataAs) - Ce paramètre utilise l’une des valeurs de l’énumération XlImportDataAs . Les deux valeurs de cette énumération sont xlPivotTableReport et xlQueryTable. Transmettez l'une de ces valeurs pour renvoyer les données sous forme de tableau croisé dynamique ou de table de requêtes. La valeur par défaut est xlQueryTable.

Les valeurs de retour possibles sont xlPivotTableReport - Renvoie les données sous forme d'objet PivotTable, xlQueryTable - Renvoie les données sous forme de QueryTable, xlTable.

OpenText

Charge et analyse un fichier texte comme un nouveau classeur d'une seule feuille contenant des données d'un fichier texte analysé.

FieldInfo , paramètre Vous pouvez utiliser xlEMDFormat uniquement si vous avez installé et sélectionné le module linguistique taïwanais. La constante xlEMDFormat spécifie que les dates d'ères chinoises (Taiwan) sont utilisées. Les séparateurs de colonne peuvent être définis dans n'importe quel ordre. À défaut de spécificateur pour une colonne dans les données d'entrée, la colonne est analysée à l'aide du paramétrage général. Dans cet exemple, la troisième colonne est analysée comme MJA (par exemple, 01/15/1970), la première comme texte, et les autres colonnes des données sources à l'aide du paramétrage général.

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 argument nommé

Filename (String) - Spécifie le nom du fichier texte à ouvrir et analyser.

Optional arguments

Les arguments suivants sont facultatifs

Origin (XlPlatform) - Origine du fichier texte. Il peut s’agir de l’une des constantes XlPlatform suivantes: xlMacintosh, xlWindowsou xlMSDOS. Il peut également s'agir d'un nombre entier représentant le numéro de la page de code souhaitée. Par exemple, « 1256 » spécifie que le codage du fichier texte source est arabe (Windows). Si vous ne spécifiez pas cet argument, la méthode utilise le paramètre actuel de l’option origine du fichier dans l’Assistant importation de texte.

Les valeurs de retour possibles sont xlMacintosh - Macintosh, xlMSDOS - MSDOS, xlWindows - Microsoft Windows.

StartRow (Long) - Numéro de la ligne à partir de laquelle commencer l'analyse du texte. La valeur par défaut est 1.

DataType (XlTextParsingType) - Format de colonne des données dans le fichier. Il peut s’agir de l’une des constantes XlTextParsingType suivantes: xlDelimited ou xlFixedWidth. Si cet argument n'est pas spécifié, Microsoft Excel tente de déterminer le format de colonne lors de l'ouverture du fichier.