Classe Range - zone contiguë dans un document (Word VBA)

La classe Range représente une zone contiguë dans un document.

Les classes suivantes donnent accès à la classe RangeField, Footnote, FormField, Frame, HeaderFooter, HTMLDivision, Hyperlink, Index, InlineShape, Line, List, MailMergeField, OMath, OMathBreak, OMathFunction, Paragraph, Rectangle, RepeatingSectionItem, Revision, Row, Section, Selection, Series, Shape, Subdocument, Table, TableOfAuthorities, TableOfContents, TableOfFigures, TextFrame, Window, XMLNode.

Dim rng as Range
Set rng = ActiveDocument.Range()

For Each

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


Dim rngCharacter As Range
Dim iFontSize As Integer: iFontSize = 8
For Each rngCharacter In ActiveDocument.Words(1).Characters
    rngCharacter.Font.Size = iFontSize
    iFontSize = iFontSize + 2
Next rngCharacter

Méthodes

AutoFormat - Met automatiquement en forme un document.

Calculate - Calcule une expression mathématique au sein d'une plage ou une sélection.

CheckGrammar - Cet exemple montre comment commencer une vérification de l'orthographe et de la grammaire dans l'ensemble des articles du document actif.

CheckSpelling - Lance la vérification de l'orthographe de la plage ou du document spécifié.

CheckSynonyms - Affiche la boîte de dialogue Dictionnaire des synonymes qui contient la liste des mots de substitution, c'est-à-dire des synonymes de ceux que contient la plage spécifiée.

Collapse - Réduit une plage ou une sélection vers la position de départ ou de fin.

ComputeStatistics - Renvoie un type long qui représente une statistique basée sur le contenu de la plage spécifiée.

ConvertHangulAndHanja - Convertit la plage spécifiée de hangûl en hanja, et inversement.

ConvertToTable - Convertit le texte d'une plage à un tableau.

Copy - Copie la plage spécifiée dans le Presse-papiers.

CopyAsPicture - La méthode CopyAsPicture fonctionne de la même façon que la méthode Copy.

Cut - Supprime l'objet spécifié du document et le place dans le Presse-papiers.

Delete - Supprime le nombre de caractères ou de mots spécifié.

DetectLanguage - Analyse le texte spécifié pour en déterminer la langue.

EndOf - Déplace ou étend l'emplacement du caractère de fin d'une plage vers la fin de l'unité de texte spécifiée la plus proche.

Expand - Développe la plage spécifiée ou la sélection.

ExportAsFixedFormat - Enregistre une partie d'un document au format PDF ou XPS.

ExportAsFixedFormat2 - Enregistre une partie d'un document au format PDF ou XPS.

ExportFragment - Exporte la plage sélectionnée dans un document pour l'utiliser en tant que fragment de ce document.

GetSpellingSuggestions - Renvoie une collection SpellingSuggestions qui représente les corrections suggérées en remplacement du premier mot de la plage spécifiée.

GoTo - Renvoie un objet Range qui représente la position de début de l'élément spécifié, par exemple une page, un signet ou un champ.

GoToEditableRange - Renvoie un objet Range qui représente la zone d'un document qui peut être modifiée par l'utilisateur ou le groupe d'utilisateurs spécifié.

GoToNext - Renvoie un objet Range qui fait référence à la position de début de l’élément suivant ou l’emplacement spécifié par l’argument What.

GoToPrevious - Renvoie un objet Range qui fait référence à la position de début de l’élément précédent ou l’emplacement spécifié par l’argument What.

ImportFragment - Importe un fragment de document dans le document sur la plage spécifiée.

InRange - Renvoie la valeur true si la plage à laquelle la méthode est appliquée se trouve dans la plage spécifiée par l’argument étendue.

InsertAfter - Insère le texte spécifié à la fin d'une plage.

InsertAlignmentTab - Insère une tabulation absolue toujours positionnée au même endroit par rapport aux marges ou aux retraits.

InsertAutoText - Essaie de faire correspondre le texte de la plage spécifiée ou celui autour de cette plage avec le nom d'une insertion automatique existante.

InsertBefore - Insère le texte spécifié avant la sélection définie.

InsertBreak - Insère un saut de page, de colonne ou de section.

InsertCaption - Insère une légende immédiatement avant ou après la plage spécifiée.

InsertCrossReference - Insère un renvoi correspondant à un titre, un signet, une note de bas de page, une note de fin, ou à un élément disposant d'une étiquette de légende (comme une équation, une figure ou un tableau).

InsertDatabase - Extrait des données à partir d'une source de données (par exemple, un autre document Microsoft Word, une feuille de calcul Microsoft Excel ou une base de données Microsoft Access) et insère les données sous forme de tableau à la place de la plage spécifiée.

InsertDateTime - Insère la date et/ou l'heure courante sous forme de texte ou de champ TIME.

InsertFile - Insère tout ou partie du fichier spécifié.

InsertParagraph - Remplace la plage spécifiée par un nouveau paragraphe.

InsertParagraphAfter - Insère une marque de paragraphe après une plage.

InsertParagraphBefore - Insère un nouveau paragraphe avant la plage spécifiée.

InsertSymbol - Insère un symbole à la place de la plage spécifiée.

InsertXML - Insère les données XML spécifiées dans le document sur la plage spécifiée, en remplaçant le texte de la plage.

InStory - True si la plage à laquelle cette méthode est appliquée se trouve dans le même article que la plage spécifiée par l'argument étendue.

IsEqual - True si la plage à laquelle s'applique cette méthode est identique à la plage spécifiée par l'argument étendue.

LookupNameProperties - Recherche un nom dans le carnet d'adresses global et affiche, dans la boîte de dialogue Propriétés, les informations relatives au nom spécifié.

ModifyEnclosure - Ajoute, modifie et supprime un symbole qui entoure des caractères spécifiés.

Move - Réduit la plage spécifiée à sa position de début ou de fin, puis déplace l'objet réduit du nombre d'unités indiqué.

MoveEnd - Déplace la position du caractère de fin d'une plage.

MoveEndUntil - Déplace la position de fin de la plage spécifiée jusqu'à ce qu'un des caractères indiqués soit trouvé dans le document.

MoveEndWhile - Déplace la position du caractère de fin d'une plage tant que l'un des caractères spécifiés est trouvé dans le document.

MoveStart - Déplace la position de début de la plage spécifiée.

MoveStartUntil - Déplace la position de début de la plage spécifiée jusqu'à ce que l'un des caractères indiqués soit trouvé dans le document.

MoveStartWhile - Déplace la position de début de la plage spécifiée tant que l'un des caractères spécifiés est trouvé dans le document.

MoveUntil - Déplace la plage spécifiée jusqu'à ce que l'un des caractères indiqués soit trouvé dans le document.

MoveWhile - Déplace la plage spécifiée tant que l'un des caractères indiqués est trouvé dans le document.

Next - Renvoie un objet Range qui représente l’unité spécifiée par rapport à la plage spécifiée.

NextSubdocument - Déplace la plage vers le sous-document suivant.

Paste - Insère le contenu du Presse-papiers dans la plage spécifiée.

PasteAndFormat - Colle des cellules de tableau sélectionnées et les met en forme conformément aux indications.

PasteAppendTable - Fusionne des cellules collées dans un tableau existant en insérant les lignes collées entre les lignes sélectionnées.

PasteAsNestedTable - Colle une cellule ou un groupe de cellules sous forme de tableau imbriqué dans la plage sélectionnée.

PasteExcelTable - Colle et met en forme un tableau Microsoft Excel.

PasteSpecial - Insère le contenu du Presse-papiers.

PhoneticGuide - Ajoute des guides phonétiques à la plage spécifiée.

Previous - Renvoie la plage précédente en fonction de la plage spécifiée.

PreviousSubdocument - Déplace la plage vers le sous-document précédent.

Relocate - En mode d'affichage Plan, déplace les paragraphes compris dans la plage spécifiée et les insère après le paragraphe visible suivant ou avant le paragraphe visible précédent.

Select - Sélectionne la plage spécifiée.

SetListLevel - Définit le niveau de liste pour un ou plusieurs éléments d'une liste numérotée.

SetRange - Définit les emplacements des caractères de début et fin d'une plage existante.

Sort - Trie les paragraphes de la plage spécifiée.

SortAscending - Trie des paragraphes ou des lignes de tableau par ordre alphanumérique croissant.

SortByHeadings - Trie les en-têtes de la plage spécifiée.

SortDescending - Trie des paragraphes par ordre alphanumérique décroissant.

StartOf - Déplace ou étend la position de début de la plage spécifiée ou la sélection au début de l'unité de texte spécifiée le plus proche.

TCSCConverter - Convertit la plage spécifiée du chinois traditionnel en chinois simplifié et inversement.

WholeStory - Développe une plage afin qu’elle contienne l’intégralité de l’article principal.

Propriétés

Text (Default member) - Cette propriété renvoie ou définit le texte de la plage spécifiée ou la sélection.

Bold True si la plage est en gras.

BoldBi True si la police ou la plage est en gras.

BookmarkID Renvoie le numéro du signet qui encadre le début de la plage spécifiée; renvoie 0 (zéro) s’il n’y a aucun signet correspondant.

Bookmarks Renvoie une collection Bookmarks qui représente tous les signets contenus dans un document, une plage ou une sélection.

Borders Renvoie une collection Borders qui représente la totalité des bordures de l’objet spécifié.

Case Cette propriété renvoie ou définit une constante WdCharacterCase qui représente la casse du texte dans la plage spécifiée.

Cells Renvoie une collection Cells qui représente les cellules de tableau d’une plage.

Characters Renvoie une collection Characters qui représente les caractères d’une plage.

CharacterStyle Renvoie une valeur de type Variant qui représente le style utilisé pour mettre en forme un ou plusieurs caractères.

CharacterWidth Cette propriété renvoie ou définit la largeur de caractère de la plage spécifiée.

Columns Renvoie une collection Columns qui représente toutes les colonnes de tableau contenues dans la plage.

CombineCharacters True si la plage spécifiée contient des caractères combinés.

Comments Renvoie une collection Comments qui représente tous les commentaires du document, de la sélection ou de la plage spécifiée.

Conflicts Renvoie un objet de collection Conflicts qui contient tous les objets Conflicts de la plage.

ContentControls Renvoie une collection ContentControls qui représente les contrôles de contenu contenus dans une plage.

DisableCharacterSpaceGrid La valeur true si Microsoft Word ignore le nombre de caractères par ligne de l'objet Range correspondant.

Document Renvoie un objet document associé à la plage spécifiée.

Duplicate Renvoie un objet Range en lecture seule qui représente toutes les propriétés de la plage spécifiée.

Editors Renvoie un objet Editors qui représente tous les utilisateurs autorisés à modifier une sélection ou une plage dans un document.

EmphasisMark Cette propriété renvoie ou définit la marque d'accentuation d'un caractère ou une chaîne de caractères spécifique.

End Renvoie ou définit l'emplacement du caractère de fin d'une plage .

EndnoteOptions Renvoie un objet EndnoteOptions qui représente les notes de fin d’une plage.

Endnotes Renvoie une collection Endnotes qui représente toutes les notes de fin contenues dans une plage.

EnhMetaFileBits Renvoie une valeur de type Variant qui représente une image de la façon dont une plage de texte s’affiche.

Fields Renvoie une collection Fields qui représente tous les champs de la plage.

Find Renvoie un objet Find qui contient les critères spécifiés pour une recherche.

FitTextWidth Cette propriété renvoie ou définit la largeur (dans les unités de mesure en cours) dans laquelle Microsoft Word ajuste le texte dans la plage ou la sélection actuelle.

Font Cette propriété renvoie ou définit un objet font qui représente la mise en forme de caractères de l’objet spécifié.

FootnoteOptions Renvoie un objet FootnoteOptions qui représente les notes de bas de page dans une sélection ou une plage.

Footnotes Renvoie une collection Footnotes qui représente toutes les notes de bas de page d’une plage.

FormattedText Cette propriété renvoie ou définit un objet Range qui inclut le texte mis en forme dans la plage spécifiée ou la sélection.

FormFields Renvoie une collection FormFields qui représente tous les champs de formulaire contenus dans la plage.

Frames Renvoie une collection frames qui représente tous les cadres contenus dans une plage.

GrammarChecked True si une vérification de la grammaire a été exécutée sur la plage spécifiée ou le document.

GrammaticalErrors Renvoie une collection ProofreadingErrors qui représente les phrases qui ont échoué à la vérification grammaticale de la plage ou du document spécifié.

HighlightColorIndex Renvoie ou définit la couleur utilisée pour mettre la plage spécifiée en surbrillance.

HorizontalInVertical Cette propriété renvoie ou définit la mise en forme de texte horizontal défini dans du texte vertical.

HTMLDivisions Renvoie un objet HTMLDivisions qui représente une division HTML dans un document Web.

Hyperlinks Renvoie une collection Hyperlinks qui représente tous les liens hypertexte de la plage spécifiée.

ID Cette propriété renvoie ou définit le nom d'identification pour la plage spécifiée.

Information Retourne des informations sur la plage spécifiée.

InlineShapes Renvoie une collection InlineShapes qui représente tous les objets InlineShape dans une plage.

IsEndOfRowMark True si la plage spécifiée est réduite et se trouve sur une marque de fin de ligne dans une table.

Italic True si la police ou la plage est en italique.

ItalicBi True si la police ou la plage est en italique.

Kana Renvoie ou définit une valeur précisant si la plage de texte en langue japonaise spécifiée est écrite en hiragana ou en katakana.

LanguageDetected Cette propriété renvoie ou définit une valeur qui indique si Microsoft Word a détecté la langue du texte spécifié.

LanguageID Cette propriété renvoie ou définit une constante WdLanguageID qui représente la langue de la plage spécifiée.

LanguageIDFarEast Renvoie ou définit une langue d'Asie orientale pour l'objet spécifié.

LanguageIDOther Cette propriété renvoie ou définit la langue pour la plage spécifiée.

ListFormat Renvoie un objet ListFormat qui représente toutes les caractéristiques de mise en forme de liste d’une plage.

ListParagraphs Renvoie une collection ListParagraphs qui représente tous les paragraphes numérotés contenus dans la plage.

ListStyle Renvoie une valeur de type Variant qui représente le style utilisé pour mettre en forme une liste à puces ou une liste numérotée.

Locks Renvoie un objet de collection CoAuthLocks qui représente tous les verrous de la plage.

NextStoryRange Renvoie un objet Range qui fait référence à l’article suivant.

NoProofing True si le vérificateur d'orthographe et de grammaire ignore le texte spécifié.

OMaths Renvoie une collection OMaths qui représente les objets OMath dans la plage spécifiée.

Orientation Cette propriété renvoie ou définit l'orientation du texte dans une plage lorsque la fonctionnalité Orientation du texte est activée.

PageSetup Renvoie un objet PageSetup associé à la plage spécifiée.

ParagraphFormat Cette propriété renvoie ou définit un objet ParagraphFormat qui représente les paramètres de paragraphe de la plage spécifiée.

Paragraphs Renvoie une collection paragraphs qui représente tous les paragraphes de la plage spécifiée.

ParagraphStyle Renvoie une valeur de type Variant qui représente le style utilisé pour mettre en forme un paragraphe.

Parent Renvoie un Object qui représente l'objet parent de l'objet Range spécifié.

ParentContentControl Renvoie un objet ContentControl qui représente le contrôle de contenu parent pour la plage spécifiée.

PreviousBookmarkID Renvoie le numéro du dernier signet qui commence avant ou au même endroit que la plage spécifiée.

ReadabilityStatistics Renvoie une collection ReadabilityStatistics qui représente les statistiques de lisibilité de la plage ou du document spécifié.

Revisions Renvoie une collection Revisions qui représente les marques de révision dans la plage.

Rows Renvoie une collection Rows qui représente toutes les lignes de tableau d’une plage.

Scripts Renvoie une collection scripts qui représente la collection des scripts HTML de l’objet spécifié.

Sections Renvoie une collection sections qui représente les sections de la plage spécifiée.

Sentences Renvoie une collection sentences qui représente toutes les phrases de la plage.

Shading Renvoie un objet Shading qui représente la mise en forme de la trame de fond pour l’objet spécifié.

ShapeRange Renvoie une collection ShapeRange qui représente tous les objets Shape de la plage spécifiée.

ShowAll True si tous les caractères non imprimables (tels que le texte masqué, marques de tabulation, d'espace et les marques de paragraphe) sont affichés.

SpellingChecked True si l'orthographe a été vérifiée dans la plage spécifiée ou le document.

SpellingErrors Renvoie une collection ProofreadingErrors qui représente les mots identifiés comme fautes d’orthographe dans la plage spécifiée.

Start Cette propriété renvoie ou définit la position du caractère de début d'une plage.

StoryLength Renvoie le nombre de caractères dans l'article qui contient la plage spécifiée.

StoryType Renvoie le type d'article pour la plage, la sélection ou le signet spécifié.

Style Cette propriété renvoie ou définit le style de l'objet spécifié.

Subdocuments Renvoie une collection Subdocuments qui représente tous les sous-documents de la plage ou du document spécifié.

SynonymInfo Renvoie un objet SynonymInfo qui contient des informations du dictionnaire des synonymes sur les synonymes, les antonymes ou les mots et les expressions apparentés au contenu d’une plage.

Tables Renvoie une collection tables qui représente toutes les tables de la plage spécifiée.

TableStyle Renvoie une valeur de type Variant qui représente le style utilisé pour mettre en forme un tableau.

TextRetrievalMode Renvoie un objet TextRetrievalMode qui contrôle la manière dont le texte est extrait de la plagespécifiée.

TextVisibleOnScreen Renvoie un type long qui indique si le texte de la plage spécifiée est visible à l’écran.

TopLevelTables Renvoie une collection tables qui représente les tableaux dont le niveau d’imbrication est le plus à l’extérieur de la plage actuelle.

TwoLinesInOne Cette propriété renvoie ou définit si Microsoft Word définit deux lignes de texte dans un et spécifie les caractères qui entourent le texte, le cas échéant.

Underline Cette propriété renvoie ou définit le type de soulignement appliqué à une plage.

Updates Renvoie un objet de collection CoAuthUpdates qui représente toutes les mises à jour qui ont été fusionnés dans la plage spécifiée au niveau du dernier enregistrement explicite.

WordOpenXML Renvoie une chaîne qui représente les données XML contenues dans la plage au format Open XML de Microsoft Word.

Words Renvoie une collection Words qui représente tous les mots d’une plage.

XML Renvoie une valeur de type String qui représente le texte XML dans l’objet spécifié.

Bookmarks - Collection d'objets Bookmark qui représentent les signets contenus dans la sélection, la plage ou le document spécifié.

Borders - Collection d’objets Border qui représentent les bordures d’un objet.

Cells - Une collection d’objets Cell d’une colonne ou d’une ligne de tableau, d’une sélection ou d’une plage.

Characters - Une collection de caractères d'une sélection, une plage ou un document.

CoAuthLocks - Collection d’objets CoAuthLock .

CoAuthUpdates - Une collection d’objets CoAuthUpdate représentant les mises à jour a été fusionnée dans le document lors du dernier enregistrement explicite.

Columns - Collection d’objets Column qui représentent les colonnes d’un tableau.

Comments - Collection d’objets Comment qui représentent les commentaires contenus dans une sélection, une plage ou un document.

Conflicts - Collection d'objets Conflict qui représente les conflits dans un document.

ContentControl - Contrôle de contenu spécifique.

ContentControls - Collection d’objets ContentControl .

Document - Représente un modèle de document.

Editors - Collection d’objets Editor qui représente une collection d’utilisateurs ou de groupes d’utilisateurs à qui des autorisations spécifiques ont été accordées pour modifier des parties d’un document.

EndnoteOptions - Représente les propriétés affectées à une plage ou à une sélection de notes de fin d'un document.

Endnotes - Collection d’objets EndNote qui représente toutes les notes de fin d’une sélection, d’une plage ou d’un document.

Fields - Collection d'objets Field qui représentent tous les champs contenus dans une sélection, une plage ou un document.

Find - Représente les critères d'une opération de recherche.

Font - Contient les attributs de police (nom, taille, couleur, etc.) d'un objet.

FootnoteOptions - Représente les propriétés affectées à une plage ou à une sélection de notes de bas de page d'un document.

Footnotes - Collection d’objets footnote qui représente toutes les notes de bas de page d’une sélection, d’une plage ou d’un document.

FormFields - Collection d’objets FormField qui représente tous les champs de formulaire contenus dans une sélection, une plage ou un document.

Frames - Référence du modèle objet Word

HTMLDivisions - Collection d’objets HTMLDivision qui représente les éléments div HTML qui existent dans un document Web.

Hyperlinks - Représente la collection d’objets Hyperlink dans un document, une plage ou une sélection.

InlineShapes - Collection d'objets InlineShape qui représente toutes les formes insérées d'un document, d'une plage ou d'une sélection.

ListFormat - Représente les attributs de mise en forme de liste qui peuvent être appliqués aux paragraphes d'une plage.

ListParagraphs - Collection d’objets paragraph qui représente les paragraphes de la liste, de la liste ou de la plage spécifiée à laquelle est appliquée la mise en forme de liste.

OMaths - Collection d'équations.

PageSetup - Représente la description de mise en page.

ParagraphFormat - Cet objet représente l'ensemble des mises en forme d'un paragraphe.

Paragraphs - Collection d'objets Paragraph d'une sélection, d'une plage ou d'un document.

ProofreadingErrors - Collection d'erreurs orthographiques et grammaticales pour la plage ou le document spécifié.

ReadabilityStatistics - Collection d’objets ReadabilityStatistic pour un document ou une plage.

Revisions - Collection d’objets Revision qui représentent les modifications signalées par des marques de révision dans une plage ou un document.

Rows - Collection d’objets Row qui représentent les lignes de tableau dans la sélection, la plage ou le tableau spécifié.

Sections - Une collection d’objetsSection d’une sélection, d’une plage ou d’un document.

Sentences - Collection d’objets Range qui représentent toutes les phrases d’une sélection, d’une plage ou d’un document.

Shading - Contient des attributs de trame de fond pour un objet.

ShapeRange - Représente une plage de formes, constituée d'un ensemble de formes sur un document.

SpellingSuggestions - Collection d’objets SpellingSuggestion qui représentent toutes les suggestions pour le mot spécifié ou pour le premier mot de la plage spécifiée.

Style - Représente un style donné prédéfini ou défini par l’utilisateur.

Subdocuments - Collection d’objets Subdocument qui représentent les sous-documents d’une plage ou d’un document.

SynonymInfo - Représente les informations concernant les synonymes, les antonymes ou encore les mots ou expressions apparentés pour la plage spécifiée ou d'une chaîne donnée.

Table - Représente un seul tableau.

Tables - Collection d’objets table qui représentent les tableaux d’une sélection, d’une plage ou d’un document.

TableStyle - Représente un style donné qui peut être appliqué à un tableau.

TextRetrievalMode - Représente les options qui contrôlent la façon dont le texte est extrait d’un objet Range .

Words - Une collection de mots dans une sélection, une plage ou un document.