Selection Interface
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Représente la sélection en cours dans une fenêtre ou un volet.
public interface class Selection
[System.Runtime.InteropServices.Guid("00020975-0000-0000-C000-000000000046")]
public interface Selection
type Selection = interface
Public Interface Selection
- Attributs
Remarques
Une sélection représente une zone sélectionnée (ou mise en surbrillance) du document ou le point d'insertion si aucun élément n'est sélectionné. Il ne peut y avoir qu’un seul Selection objet par volet de fenêtre de document, et un seul Selection objet dans l’application entière peut être actif.
Utilisez la Selection propriété pour renvoyer l' Selection objet. Si aucun qualificateur d’objet n’est utilisé avec la Selection propriété, Microsoft Word renvoie la sélection à partir du volet actif de la fenêtre du document actif.
Le document n’a pas besoin d’être actif pour accéder à sa sélection actuelle.
Utilisez la Text propriété pour définir ou renvoyer le texte de la sélection en cours.
L' Selection objet possède différentes méthodes et propriétés qui vous permettent de :
Utilisez des propriétés telles que Flags , Information[WdInformation] et Type pour renvoyer des informations sur la sélection en cours.
Même lorsqu’une sélection est réduite à un point d’insertion, elle n’est pas nécessairement vide. Par exemple, la Text propriété renverra toujours le caractère à droite du point d’insertion ; ce caractère apparaît également dans la Characters collection de l' Selection objet. Toutefois, les méthodes d’appel telles que Cut() ou Copy() à partir d’une sélection réduite génèrent une erreur.
L’utilisateur peut sélectionner une région dans un document qui ne représente pas du texte contigu (par exemple, lors de l’utilisation de la touche ALT avec la souris). Étant donné que le comportement d’une telle sélection peut être imprévisible, vous pouvez inclure une étape dans votre code qui vérifie la Type propriété d’une sélection avant d’y effectuer des opérations. De même, les sélections qui incluent des cellules de tableau peuvent également entraîner un comportement imprévisible. La Information[WdInformation] propriété vous indique si une sélection se trouve à l’intérieur d’un tableau.
Étant donné que les Range objets partagent de nombreuses méthodes et propriétés de la même manière que les objets Selection , l’utilisation Range d’objets est préférable pour la manipulation d’un document lorsqu’il n’existe pas de raison de modifier physiquement la sélection actuelle.
Propriétés
| Active |
Détermine si la sélection dans la fenêtre ou le volet spécifié est active. |
| Application |
Renvoie un _Application Object qui représente l’application Microsoft Word. |
| BookmarkID |
Renvoie le numéro du signet qui encadre le début de la sélection spécifiée ou 0 (zéro) s’il n’y a aucun signet correspondant. |
| Bookmarks |
Renvoie une Bookmarks collection qui représente tous les signets contenus dans une sélection. |
| Borders |
Renvoie une Borders collection qui représente toutes les bordures de l’objet spécifié. |
| Cells |
Renvoie une Cells collection qui représente les cellules de tableau d’une sélection. |
| Characters |
Renvoie une Characters collection qui représente les caractères d’une sélection. |
| ChildShapeRange |
Renvoie un ShapeRange objet représentant les formes enfant d’une sélection. |
| Columns |
Renvoie une Columns collection qui représente toutes les colonnes de tableau contenues dans la sélection. |
| ColumnSelectMode |
Détermine si le mode de sélection de colonne est actif. |
| Comments |
Renvoie une Comments collection qui représente tous les commentaires de la sélection spécifiée. |
| ContentControls |
Renvoie une ContentControls collection qui représente les contrôles de contenu contenus dans une plage. En lecture seule. |
| Creator |
Renvoie un entier 32 bits qui indique l'application dans laquelle l'objet spécifié a été créé. |
| Document |
Renvoie un Document objet associé à la sélection spécifiée. |
| Editors |
Renvoie un Editors Object qui représente tous les utilisateurs autorisés à modifier une sélection dans un document. |
| End |
Cette propriété renvoie ou définit la position du caractère de fin d'une sélection. |
| EndnoteOptions |
Renvoie un EndnoteOptions Object qui représente les notes de fin d’une sélection. |
| Endnotes |
Renvoie une Endnotes collection qui représente toutes les notes de fin d’une sélection. |
| EnhMetaFileBits |
Renvoie un Object qui représente une image de la façon dont une sélection de texte s’affiche. |
| ExtendMode |
Détermine si le mode extension est actif. |
| Fields |
Renvoie une collection en lecture seule Fields qui représente tous les champs contenus dans la sélection. |
| Find |
Renvoie un Find objet qui contient les critères spécifiés pour une opération de 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 sélection actuelle. |
| Flags |
Cette propriété renvoie ou définit les propriétés de la sélection. |
| Font |
Cette propriété renvoie ou définit un Font objet qui représente la mise en forme de caractères de l’objet spécifié. |
| FootnoteOptions |
Renvoie un FootnoteOptions Object qui représente les propriétés de la note de bas de page dans une sélection. |
| Footnotes |
Renvoie une Footnotes collection qui représente toutes les notes de bas de page d’une sélection. |
| FormattedText |
Cette propriété renvoie ou définit un Range objet qui inclut le texte mis en forme dans la sélection spécifiée. |
| FormFields |
Renvoie une FormFields collection qui représente tous les champs de formulaire contenus dans la sélection. |
| Frames |
Renvoie une Frames collection qui représente tous les cadres contenus dans une sélection. |
| HasChildShapeRange |
Détermine si la sélection contient des formes enfants. |
| HeaderFooter |
Renvoie un HeaderFooter objet pour la sélection spécifiée. |
| HTMLDivisions |
Renvoie un HTMLDivisions Object qui représente une division HTML dans un document Web. |
| Hyperlinks |
Renvoie une Hyperlinks collection qui représente tous les liens hypertexte de la sélection spécifiée. |
| Information[WdInformation] |
Renvoie des informations sur la sélection ou la plage spécifiée. |
| InlineShapes |
Renvoie une InlineShapes collection qui représente tous les InlineShape objets d’une sélection. |
| IPAtEndOfLine |
Détermine si le point d’insertion se trouve à la fin d’une ligne qui s’ajuste à la ligne suivante. |
| IsEndOfRowMark |
Détermine si la sélection spécifiée est réduite et se trouve à la marque de fin de ligne dans un tableau. |
| 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 |
Renvoie ou définit la langue de l'objet spécifié. |
| LanguageIDFarEast |
Renvoie ou définit une langue d'Asie orientale pour l'objet spécifié. |
| LanguageIDOther |
Renvoie ou définit la langue de l'objet spécifié. |
| NoProofing |
Détermine si le vérificateur d’orthographe et de grammaire ignore le texte spécifié. |
| OMaths |
Renvoie une OMaths collection qui représente les OMath objets au sein de la sélection active. En lecture seule. |
| Orientation |
Cette propriété renvoie ou définit l'orientation du texte dans une sélection lorsque la fonctionnalité Orientation du texte est activée. |
| PageSetup |
Renvoie un PageSetup objet associé à la sélection spécifiée. |
| ParagraphFormat |
Cette propriété renvoie ou définit un ParagraphFormat objet qui représente les paramètres de paragraphe de la sélection spécifiée. |
| Paragraphs |
Renvoie une Paragraphs collection qui représente tous les paragraphes de la sélection spécifiée. |
| Parent |
Cette propriété renvoie un objet qui représente l'objet parent de l'objet spécifié. |
| ParentContentControl |
Renvoie un ContentControl Object qui représente le contrôle de contenu parent pour la plage spécifiée. En lecture seule. |
| PreviousBookmarkID |
Renvoie le numéro du dernier signet qui commence avant ou au même endroit que la sélection spécifiée, ou renvoie 0 (zéro) s’il n’y a aucun signet correspondant. |
| Range |
Renvoie un Range Object qui représente la partie d’un document contenue dans l’objet spécifié. |
| Rows |
Renvoie une Rows collection qui représente toutes les lignes de tableau d’une sélection. |
| Sections |
Renvoie une Sections collection qui représente les sections de la sélection spécifiée. |
| Sentences |
Renvoie une Sentences collection qui représente toutes les phrases de la sélection. |
| Shading |
Renvoie un Shading Object qui fait référence à la mise en forme de la trame de fond pour l’objet spécifié. |
| ShapeRange |
Renvoie une ShapeRange collection qui représente tous les Shape objets de la plage spécifiée ou la sélection. |
| SmartTags |
Renvoie un SmartTags objet qui représente une balise active dans un document. |
| Start |
Renvoie ou définit l’emplacement du caractère de début d’une sélection. |
| StartIsActive |
Détermine si le début de la sélection est actif. |
| StoryLength |
Renvoie le nombre de caractères dans l'article qui contient la sélection spécifiée. |
| StoryType |
Renvoie le type d'article de la sélection spécifiée. |
| Style |
Cette propriété renvoie ou définit le style de l'objet spécifié. |
| Tables |
Renvoie une Tables collection qui représente toutes les tables de la sélection spécifiée. |
| Text |
Cette propriété renvoie ou définit le texte de la sélection spécifiée. |
| TopLevelTables |
Renvoie une Tables collection qui représente les tableaux dont le niveau d’imbrication est le plus à l’extérieur de la sélection actuelle. |
| Type |
Renvoie le type de sélection. |
| WordOpenXML |
Renvoie une valeur de type String qui représente les données XML contenues dans la sélection au format Open XML de Microsoft Office Word. En lecture seule. |
| Words |
Renvoie une Words collection qui représente tous les mots d’une sélection. |
| XML[Boolean] |
Renvoie une chaîne qui représente le texte XML dans l'objet spécifié. |
| XMLNodes |
Cet objet, ce membre ou cette énumération est déconseillé et n’est pas destiné à être utilisé dans votre code. |
| XMLParentNode |
Cet objet, ce membre ou cette énumération est déconseillé et n’est pas destiné à être utilisé dans votre code. |
Méthodes
| BoldRun() |
Applique ou retire la mise en forme gras à la portion de texte active. |
| Calculate() |
Calcule une expression mathématique dans une sélection. |
| ClearCharacterAllFormatting() |
Supprime toute la mise en forme des caractères (mise en forme appliquée avec des styles de caractère ou mise en forme manuelle) dans le texte sélectionné. |
| ClearCharacterDirectFormatting() |
Supprime la mise en forme de caractères (mise en forme manuelle à l’aide des boutons du ruban ou des boîtes de dialogue) à partir du texte sélectionné. |
| ClearCharacterStyle() |
Supprime la mise en forme de caractères qui a été appliquée avec des styles de caractères dans le texte sélectionné. |
| ClearFormatting() |
Supprime le texte et la mise en forme des paragraphes d'une sélection. |
| ClearParagraphAllFormatting() |
Supprime toute la mise en forme de paragraphes (mise en forme appliquée avec des styles de paragraphes ou mise en forme manuelle) dans le texte sélectionné. |
| ClearParagraphDirectFormatting() |
Supprime la mise en forme de paragraphes qui a été appliquée manuellement (à l’aide des boutons du ruban ou à l’aide des boîtes de dialogue) à partir du texte sélectionné. |
| ClearParagraphStyle() |
Supprime la mise en forme de paragraphes qui a été appliquée avec des styles de paragraphes dans le texte sélectionné. |
| Collapse(Object) |
Réduit une sélection vers la position de départ ou de fin. |
| ConvertToTable(Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object) |
Convertit le texte d’une sélection en tableau. |
| ConvertToTableOld(Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object) |
Réservé à une utilisation interne. |
| Copy() |
Copie l'objet spécifié dans le Presse-papiers. |
| CopyAsPicture() |
Copie l'objet spécifié dans le Presse-papiers. |
| CopyFormat() |
Copie la mise en forme du premier caractère du texte sélectionné. |
| CreateAutoTextEntry(String, String) |
Ajoute un nouvel AutoTextEntry objet à la AutoTextEntries collection, en fonction de la sélection en cours. |
| CreateTextbox() |
Ajoute une zone de texte dont la taille est définie par défaut autour de la sélection. |
| Cut() |
Supprime l'objet spécifié du document et le place dans le Presse-papiers. |
| Delete(Object, Object) |
Supprime le nombre de caractères ou de mots spécifié. |
| DetectLanguage() |
Analyse le texte spécifié pour en déterminer la langue. |
| EndKey(Object, Object) |
Cette méthode déplace ou étend la sélection vers la fin de l'unité précisée. |
| EndOf(Object, Object) |
Déplace ou étend la position du caractère de fin d’une sélection à la fin de l’unité de texte spécifiée la plus proche. |
| EscapeKey() |
Désactive un mode, tel que le mode Extension ou le mode Sélection de colonne (ce qui équivaut à appuyer sur ÉCHAP). |
| Expand(Object) |
Développe la sélection spécifiée. |
| ExportAsFixedFormat(String, WdExportFormat, Boolean, WdExportOptimizeFor, Boolean, WdExportItem, Boolean, Boolean, WdExportCreateBookmarks, Boolean, Boolean, Boolean, Object) |
Enregistre la sélection actuelle au format PDF ou XPS. . |
| Extend(Object) |
Active le mode extension, ou étend la sélection jusqu’à la plus grande unité de texte si le mode extension est déjà activé. |
| GoTo(Object, Object, Object, Object) |
Déplace le point d’insertion vers l’emplacement du caractère qui précède immédiatement l’élément spécifié. |
| GoToEditableRange(Object) |
Renvoie un Range objet qui représente une zone d’un document qui peut être modifiée par l’utilisateur ou le groupe d’utilisateurs spécifié. |
| GoToNext(WdGoToItem) |
Renvoie un Range Object qui fait référence à la position de début de l’élément suivant ou l’emplacement spécifié par l' |
| GoToPrevious(WdGoToItem) |
Renvoie un Range Object qui fait référence à la position de début de l’élément précédent ou à un emplacement spécifié. |
| HomeKey(Object, Object) |
Déplace ou étend la sélection vers le début de l’unité précisée. |
| InRange(Range) |
Détermine si la sélection à laquelle est appliquée la méthode se trouve dans une plage spécifiée. |
| InsertAfter(String) |
Insère le texte spécifié à la fin d’une sélection. |
| InsertBefore(String) |
Insère le texte spécifié avant la sélection spécifiée. |
| InsertBreak(Object) |
Insère un saut de page, de colonne ou de section. |
| InsertCaption(Object, Object, Object, Object, Object) |
Insère une légende immédiatement avant ou après la sélection spécifiée. |
| InsertCaptionXP(Object, Object, Object, Object) |
Réservé à une utilisation interne. |
| InsertCells(Object) |
Ajoute des cellules à un tableau existant. |
| InsertColumns() |
Insère des colonnes à gauche de la colonne qui contient la sélection. |
| InsertColumnsRight() |
Insère des colonnes à droite de la sélection active. |
| InsertCrossReference(Object, WdReferenceKind, Object, Object, Object, Object, Object) |
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). |
| InsertCrossReference_2002(Object, WdReferenceKind, Object, Object, Object) |
Réservé à une utilisation interne. |
| InsertDateTime(Object, Object, Object, Object, Object) |
Insère la date et/ou l'heure courante sous forme de texte ou de champ TIME. |
| InsertDateTimeOld(Object, Object, Object) |
Réservé à une utilisation interne. |
| InsertFile(String, Object, Object, Object, Object) |
Insère tout ou partie du fichier spécifié. |
| InsertFormula(Object, Object) |
Insère dans la sélection un champ = (Formula) qui contient une formule. |
| InsertNewPage() |
Insère une nouvelle page à la position du point d'insertion. |
| InsertParagraph() |
Remplace la sélection spécifiée par un nouveau paragraphe. |
| InsertParagraphAfter() |
Insère une marque de paragraphe après une sélection. |
| InsertParagraphBefore() |
Insère un nouveau paragraphe avant la sélection spécifiée. |
| InsertRows(Object) |
Insère le nombre de nouvelles lignes spécifié au-dessus de la ligne qui contient la sélection. |
| InsertRowsAbove(Object) |
Insère des lignes au-dessus de la sélection active. |
| InsertRowsBelow(Object) |
Insère des lignes sous la sélection active. |
| InsertStyleSeparator() |
Insère une marque de paragraphe spéciale masquée qui permet à Microsoft Word de joindre des paragraphes mis en forme à l’aide de différents styles de paragraphe. |
| InsertSymbol(Int32, Object, Object, Object) |
Insère un symbole à la place de la sélection spécifiée. |
| InsertXML(String, Object) |
Insère le texte XML spécifié dans la sélection spécifiée. |
| InStory(Range) |
Détermine si la sélection à laquelle cette méthode est appliquée se trouve dans le même article que la plage spécifiée. |
| IsEqual(Range) |
Détermine si la sélection à laquelle s’applique cette méthode est identique à la plage spécifiée par l' |
| ItalicRun() |
Applique ou retire la mise en forme italique à la portion de texte active. |
| LtrPara() |
Définit le sens de lecture et d'alignement des paragraphes de gauche à droite. |
| LtrRun() |
Définit le sens de lecture et l’alignement de la portion de texte spécifiée de gauche à droite. |
| Move(Object, Object) |
Réduit la sélection spécifiée à sa position de début ou de fin, puis déplace l'objet réduit du nombre d'unités indiqué. |
| MoveDown(Object, Object, Object) |
Déplace la sélection vers le bas et renvoie le nombre d’unités qu’elle a été déplacée. |
| MoveEnd(Object, Object) |
Déplace la position du caractère de fin d’une sélection. |
| MoveEndUntil(Object, Object) |
Déplace la position de fin de la sélection spécifiée jusqu'à ce qu'un des caractères indiqués soit trouvé dans le document. |
| MoveEndWhile(Object, Object) |
Déplace la position du caractère de fin d'une sélection tant que l'un des caractères spécifiés est trouvé dans le document. |
| MoveLeft(Object, Object, Object) |
Déplace la sélection vers la gauche et renvoie le nombre d’unités qu’elle a été déplacée. |
| MoveRight(Object, Object, Object) |
Déplace la sélection vers la droite et renvoie le nombre d’unités qu’elle a été déplacée. |
| MoveStart(Object, Object) |
Déplace la position de début de la sélection spécifiée. |
| MoveStartUntil(Object, Object) |
Déplace la position de début de la sélection spécifiée jusqu'à ce que l'un des caractères indiqués soit trouvé dans le document. |
| MoveStartWhile(Object, Object) |
Déplace la position de début de la sélection spécifiée tant que l'un des caractères spécifiés est trouvé dans le document. |
| MoveUntil(Object, Object) |
Déplace la sélection spécifiée jusqu'à ce que l'un des caractères indiqués soit trouvé dans le document. |
| MoveUp(Object, Object, Object) |
Déplace la sélection vers le haut et renvoie le nombre d’unités qu’elle a été déplacée. |
| MoveWhile(Object, Object) |
Déplace la sélection spécifiée tant que l'un des caractères indiqués est trouvé dans le document. |
| Next(Object, Object) |
Renvoie un Range Object qui représente l’unité spécifiée par rapport à la sélection spécifiée. |
| NextField() |
Sélectionne le champ suivant. |
| NextRevision(Object) |
Localise et renvoie la modification suivante sous la forme d’un Revision objet. |
| NextSubdocument() |
Déplace la sélection au sous-document suivant. |
| Paste() |
Insère le contenu du Presse-papiers dans la sélection spécifiée. |
| PasteAndFormat(WdRecoveryType) |
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(Boolean, Boolean, Boolean) |
Colle et met en forme un tableau Microsoft Excel. |
| PasteFormat() |
Applique la mise en forme copiée avec la CopyFormat() méthode à la sélection. |
| PasteSpecial(Object, Object, Object, Object, Object, Object, Object) |
Insère le contenu du Presse-papiers. |
| Previous(Object, Object) |
Renvoie un Range objet par rapport à la sélection spécifiée. |
| PreviousField() |
Sélectionne le champ précédent. |
| PreviousRevision(Object) |
Localise et renvoie la modification précédente sous la forme d’un Revision objet. |
| PreviousSubdocument() |
Déplace la sélection au sous-document précédent. |
| ReadingModeGrowFont() |
Augmente la taille du texte affiché d'un point lorsque le document est affiché en mode Lecture. |
| ReadingModeShrinkFont() |
Réduit la taille du texte affiché d'un point lorsque le document est affiché en mode Lecture. |
| RtlPara() |
Définit le sens de lecture et d'alignement des paragraphes de droite à gauche. |
| RtlRun() |
Définit le sens de lecture et l'alignement de la portion de texte spécifiée de droite à gauche. |
| Select() |
Sélectionne l'objet spécifié. |
| SelectCell() |
Sélectionne toute la cellule qui contient la sélection active. |
| SelectColumn() |
Sélectionne la colonne qui contient le point d'insertion ou toutes les colonnes qui contiennent la sélection. |
| SelectCurrentAlignment() |
Cette méthode étend la sélection jusqu'au premier paragraphe ayant un alignement différent. |
| SelectCurrentColor() |
Cette méthode étend la sélection au premier caractère du texte ayant une couleur différente. |
| SelectCurrentFont() |
Cette méthode étend la sélection au premier caractère ayant une police ou une taille différente. |
| SelectCurrentIndent() |
Cette méthode étend la sélection au premier paragraphe ayant un retrait à gauche ou à droite différent. |
| SelectCurrentSpacing() |
Cette méthode étend la sélection au premier paragraphe ayant un interligne différent. |
| SelectCurrentTabs() |
Cette méthode étend la sélection au premier paragraphe ayant des taquets de tabulation différents. |
| SelectRow() |
Sélectionne la ligne qui contient le point d'insertion ou toutes les lignes qui contiennent la sélection. |
| SetRange(Int32, Int32) |
Définit l'emplacement du caractère de début et celui du caractère de fin pour la sélection. |
| Shrink() |
Réduit la sélection à l'unité de texte inférieure la plus proche. |
| ShrinkDiscontiguousSelection() |
Désélectionne tout le texte, sauf le dernier, lorsqu’une sélection contient plusieurs sélections non connectées. |
| Sort(Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object) |
Trie les paragraphes de la sélection spécifiée. |
| Sort2000(Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object) |
Réservé à une utilisation interne. |
| SortAscending() |
Trie des paragraphes ou des lignes de tableau par ordre alphanumérique croissant. |
| SortByHeadings(Object, Object, Object, Object, Object, Object, Object, Object, Object) |
Trie les en-têtes de la sélection spécifiée. |
| SortDescending() |
Trie des paragraphes ou des lignes de tableau par ordre alphanumérique décroissant. |
| SortOld(Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object) |
Réservé à une utilisation interne. |
| SplitTable() |
Insère un paragraphe vide au-dessus de la première ligne de la sélection. |
| StartOf(Object, Object) |
Déplace ou étend la position de début de la sélection spécifiée au début de l’unité de texte spécifiée la plus proche. |
| ToggleCharacterCode() |
Convertit une sélection de type Unicode en valeur hexadécimale. |
| TypeBackspace() |
Cette méthode supprime le caractère qui précède une sélection réduite (un point d'insertion). |
| TypeParagraph() |
Cette méthode insère un nouveau paragraphe vide. |
| TypeText(String) |
Insère le texte spécifié. |
| WholeStory() |
Développe une sélection afin qu’elle contienne l’intégralité de l’article principal. |