Selection Interface

Définition

Espace de noms:

Microsoft.Office.Interop.Word

Assembly:

Microsoft.Office.Interop.Word.dll

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

GuidAttribute

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 Selection seul objet par volet de fenêtre de document, et un Selection seul objet dans l’ensemble de l’application peut être actif.

Utilisez la Selection propriété pour renvoyer l’objet Selection . 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 de document active.

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 actuelle.

L’objet Selection a différentes méthodes et propriétés avec lesquelles vous pouvez :

Utilisez des propriétés telles que Flags, Information[WdInformation]et Type pour retourner des informations sur la sélection actuelle.

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é renvoie toujours le caractère à droite du point d’insertion ; ce caractère apparaît également dans la Characters collection de l’objet Selection . Toutefois, l’appel de méthodes comme Cut() ou Copy() à partir d’une sélection réduite entraîne une erreur.

Il est possible pour l’utilisateur de sélectionner une région dans un document qui ne représente pas de 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’effectuer des opérations sur celle-ci. 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’une table.

Étant donné que Range les objets partagent la plupart des mêmes méthodes et propriétés que Selection les objets, il est préférable d’utiliser Range des objets pour manipuler un document lorsqu’il n’y a 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 objet qui représente l’application Microsoft Word.
BookmarkID	Retourne le numéro du signet qui entoure le début de la sélection spécifiée ou 0 (zéro) s’il n’existe aucun signet correspondant.
Bookmarks	Retourne une Bookmarks collection qui représente tous les signets d’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 du 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 enfants d’une sélection.
Columns	Retourne une Columns collection qui représente toutes les colonnes de table dans la sélection.
ColumnSelectMode	Détermine si le mode de sélection de colonne est actif.
Comments	Retourne une Comments collection qui représente tous les commentaires dans la sélection spécifiée.
ContentControls	Retourne 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	Retourne un Document objet associé à la sélection spécifiée.
Editors	Renvoie un Editors objet 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 objet qui représente les notes de fin d’une sélection.
Endnotes	Retourne une Endnotes collection qui représente toutes les notes de fin d’une sélection.
EnhMetaFileBits	Renvoie un Objet qui représente une représentation image de la façon dont une sélection de texte apparaît.
ExtendMode	Détermine si le mode d’extension est actif.
Fields	Renvoie une collection en lecture seule Fields qui représente tous les champs de la sélection.
Find	Retourne un Find objet qui contient les critères d’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	Renvoie ou définit un Font objet qui représente la mise en forme des caractères de l’objet spécifié.
FootnoteOptions	Renvoie un FootnoteOptions objet qui représente les propriétés de 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	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 dans la sélection.
Frames	Retourne une Frames collection qui représente tous les cadres d’une sélection.
HasChildShapeRange	Détermine si la sélection contient des formes enfants.
HeaderFooter	Retourne un HeaderFooter objet pour la sélection spécifiée.
HTMLDivisions	Renvoie un HTMLDivisions objet qui représente une division HTML dans un document Web.
Hyperlinks	Retourne une Hyperlinks collection qui représente tous les liens hypertexte dans la sélection spécifiée.
Information[WdInformation]	Retourne des informations sur la sélection ou la plage spécifiée.
InlineShapes	Retourne une InlineShapes collection qui représente tous les objets d’une InlineShape sélection.
IPAtEndOfLine	Détermine si le point d’insertion se trouve à la fin d’une ligne qui s’encapsule à 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 une table.
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	Retourne une OMaths collection qui représente les OMath objets de la sélection actuelle. 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	Retourne un PageSetup objet associé à la sélection spécifiée.
ParagraphFormat	Renvoie ou définit un ParagraphFormat objet qui représente les paramètres de paragraphe pour 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 objet 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 retourne 0 (zéro) s’il n’existe aucun signet correspondant.
Range	Renvoie un Range objet qui représente la partie d’un document contenue dans l’objet spécifié.
Rows	Retourne 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	Retourne une Sentences collection qui représente toutes les phrases de la sélection.
Shading	Retourne un Shading objet qui fait référence à la mise en forme d’ombrage pour l’objet spécifié.
ShapeRange	Renvoie une ShapeRange collection qui représente tous les Shape objets de la plage ou de la sélection spécifiée.
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	Retourne 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	Retourne une Tables collection qui représente les tables au niveau d’imbrication le plus externe dans la sélection actuelle.
Type	Renvoie le type de sélection.
WordOpenXML	Renvoie une valeur de type String qui représente le code XML contenu dans la sélection au format Microsoft Office Word Open XML. 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 des caractères (mise en forme qui a été appliquée manuellement à l’aide des boutons du ruban ou via les boîtes de dialogue) 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 paragraphe qui a été appliquée manuellement (à l’aide des boutons du ruban ou des boîtes de dialogue) 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 actuelle.
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 Étendre ou étend la sélection à l’unité de texte supérieure suivante si le mode Étendre est déjà activé.
GoTo(Object, Object, Object, Object)	Déplace le point d’insertion vers la position 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)	Retourne un Range objet qui fait référence à la position de début de l’élément ou de l’emplacement suivant spécifié par l’argument What .
GoToPrevious(WdGoToItem)	Renvoie un Range objet 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 la méthode est appliquée est contenue 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 masquée spéciale 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 cette méthode est appliquée est égale à la plage spécifiée par l’argument Range .
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 retourne 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 retourne 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 retourne 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 retourne 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 objet 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 retourne la modification suivie suivante en tant qu’objet Revision .
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)	Retourne un Range objet relatif à la sélection spécifiée.
PreviousField()	Sélectionne le champ précédent.
PreviousRevision(Object)	Localise et retourne la modification suivie précédente en tant qu’objet Revision .
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 sélectionné, sauf le plus récent, 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 dans la sélection spécifiée.
SortDescending()	Trie les paragraphes ou les lignes du tableau dans l’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.