Word.Selection class

Paquet:: word

Représente une plage sélectionnée ou le point d’insertion dans un document Word.

Extends: OfficeExtension.ClientObject

Remarques

Remarque : Les objets Range partagent la plupart des mêmes méthodes et propriétés que les Selection objets. L’utilisation d’objets Range est préférable pour manipuler un document lorsqu’il n’y a pas de raison de modifier physiquement la sélection actuelle.

Propriétés

borders	Renvoie un `BorderUniversalCollection` objet qui représente toutes les bordures des objets de la sélection.
characters	Renvoie un `RangeScopedCollection` objet qui représente chaque caractère de la sélection.
comments	Renvoie un `CommentCollection` objet qui représente tous les commentaires de la sélection.
context	Contexte de requête associé à l’objet . Cela connecte le processus du complément au processus de l’application hôte Office.
end	Spécifie la position du caractère de fin de la sélection.
fields	Renvoie un `FieldCollection` objet qui représente tous les champs de la sélection.
fitTextWidth	Spécifie la largeur dans laquelle Word ajuste le texte dans la sélection actuelle.
font	Renvoie l’objet `Font` qui représente la mise en forme des caractères de la sélection.
formattedText	Spécifie un `Range` objet qui inclut le texte mis en forme dans la plage ou la sélection.
hasNoProofing	Renvoie une valeur indiquant si le vérificateur d’orthographe et de grammaire ignore le texte sélectionné. Si le texte sélectionné contient un mélange de contenu avec et sans vérification, cette API retourne `null`.
isActive	Retourne si la sélection dans la fenêtre ou le volet spécifié est active.
isColumnSelectModeActive	Spécifie si le mode de sélection de colonne est actif.
isEndOfRowMark	Retourne si la sélection se trouve à la marque de fin de ligne dans un tableau.
isExtendModeActive	Spécifie si le mode d’extension est actif.
isInsertionPointAtEndOfLine	Retourne si le point d’insertion se trouve à la fin d’une ligne.
isStartActive	Spécifie si le début de la sélection est actif.
languageDetected	Spécifie si Word a détecté la langue du texte sélectionné.
languageId	Retourne la langue de la sélection.
languageIdFarEast	Renvoie la langue d’Asie de l’Est pour la sélection.
languageIdOther	Renvoie la langue de la sélection qui n’est pas classée comme langue d’Asie de l’Est.
orientation	Spécifie l’orientation du texte dans la sélection.
paragraphs	Renvoie un `ParagraphCollection` objet qui représente tous les paragraphes de la sélection.
range	Renvoie l’objet `Range` pour la partie du document contenue dans la sélection.
sections	Retourne l’objet `SectionCollection` dans la sélection.
sentences	Retourne l’objet `RangeScopedCollection` pour chaque phrase de la sélection.
shading	Retourne l’objet `ShadingUniversal` pour la mise en forme d’ombrage de la sélection.
start	Spécifie la position du caractère de départ de la sélection.
storyLength	Renvoie le nombre de caractères dans l’article qui contient la sélection.
storyType	Retourne le type d’article de la sélection.
tables	Retourne l’objet `TableCollection` dans la sélection.
text	Spécifie le texte de la sélection.
topLevelTables	Retourne les tables au niveau d’imbrication le plus externe dans la sélection actuelle.
type	Renvoie le type de sélection.
words	Renvoie l’objet `RangeScopedCollection` qui représente chaque mot de la sélection.

Méthodes

calculate()	Calcule la première expression mathématique dans la sélection.
cancelMode()	Annule un mode tel que l’extension ou la sélection de colonne. Cela équivaut à appuyer sur la touche Échap.
clearCharacterStyleFormatting()	Supprime la mise en forme des caractères appliquée par le biais de styles de caractères.
clearFormatting()	Supprime la mise en forme des caractères et des paragraphes de la sélection.
clearManualCharacterFormatting()	Supprime la mise en forme de caractères appliquée manuellement du texte sélectionné.
clearManualParagraphFormatting()	Supprime la mise en forme de paragraphe appliquée manuellement du texte sélectionné.
clearParagraphFormatting()	Supprime toute la mise en forme de paragraphe du texte sélectionné.
clearParagraphStyle()	Supprime la mise en forme de paragraphe appliquée par le biais de styles de paragraphe.
collapse(direction)	Réduit la sélection à la position de début ou de fin.
collapse(direction)	Réduit la sélection à la position de début ou de fin.
convertToTable(options)	Convertit le texte d'une plage à un tableau.
copyAsPictureToClipboard()	Copie la sélection dans le Presse-papiers sous forme d’image.
copyFormat()	Copie la mise en forme du premier caractère du texte sélectionné.
copyToClipboard()	Copie la sélection dans le Presse-papiers.
createTextBox()	Ajoute une zone de texte de taille par défaut autour de la sélection.
cut()	Supprime le contenu sélectionné du document et le déplace dans le Presse-papiers.
delete(options)	Supprime le nombre de caractères ou de mots spécifié.
detectLanguage()	Analyse le texte sélectionné pour déterminer la langue dans laquelle il est écrit.
expand(unit)	Développe la sélection.
expand(unit)	Développe la sélection.
expandToWholeStory()	Développe la sélection pour inclure l’intégralité de l’article.
extend(character)	Active le mode Extension et, si celui-ci est déjà activé, étend la sélection jusqu'à l'unité de texte supérieure suivante.
extend(character)	Active le mode Extension et, si celui-ci est déjà activé, étend la sélection jusqu'à l'unité de texte supérieure suivante.
getNextRange(options)	Renvoie un `Range` objet qui représente l’unité suivante relative à la sélection.
getPreviousRange(options)	Renvoie un `Range` objet qui représente l’unité précédente relative à la sélection.
goTo(options)	Renvoie un `Range` objet qui représente la zone spécifiée par et `options` déplace le point d’insertion vers la position de caractère précédant immédiatement l’élément spécifié.
goToNext(what)	Renvoie 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` et déplace la sélection vers l’élément spécifié.
goToNext(what)	Renvoie 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` et déplace la sélection vers l’élément spécifié.
goToPrevious(what)	Renvoie un `Range` objet qui fait référence à la position de début de l’élément ou de l’emplacement précédent spécifié par l’argument `what` et déplace la sélection vers l’élément spécifié.
goToPrevious(what)	Renvoie un `Range` objet qui fait référence à la position de début de l’élément ou de l’emplacement précédent spécifié par l’argument `what` et déplace la sélection vers l’élément spécifié.
insertAfter(text)	Insère le texte spécifié à la fin de la plage ou de la sélection.
insertBefore(text)	Insère le texte spécifié avant la sélection.
insertCells(shiftCells)	Ajoute des cellules à un tableau existant.
insertCells(shiftCells)	Ajoute des cellules à un tableau existant.
insertColumnsLeft()	Insère des colonnes à gauche de la colonne qui contient la sélection.
insertColumnsRight()	Insère des colonnes à droite de la sélection active.
insertDateTime(options)	Insère la date ou l’heure actuelle, ou les deux, sous forme de texte ou de champ HEURE.
insertFormula(options)	Insère un champ Formule au niveau de la sélection.
insertNewPage()	Insère une nouvelle page à la position du point d’insertion.
insertParagraphAfter()	Insère une marque de paragraphe après la sélection.
insertParagraphBefore()	Insère un nouveau paragraphe avant la sélection ou la plage.
insertParagraphStyleSeparator()	Insère une marque de paragraphe masquée spéciale qui permet aux Word de joindre des paragraphes mis en forme à l’aide de différents styles de paragraphe.
insertRowsAbove(numRows)	Insère des lignes au-dessus de la sélection active.
insertRowsBelow(numRows)	Insère des lignes sous la sélection active.
insertSymbol(characterNumber, options)	Insère un symbole à la place de la sélection spécifiée.
insertText(Text)	Insère le texte spécifié.
insertXml(xml, transform)	Insère les données XML spécifiées dans le document à l'endroit du curseur, remplaçant ainsi tout texte sélectionné.
isEqual(range)	Retourne si la sélection est égale à la plage spécifiée.
isInRange(range)	Retourne `true` si la sélection est contenue dans la plage spécifiée.
isInStory(range)	Retourne si la sélection se trouve dans le même article que la plage spécifiée.
load(options)	Files d’attente de la commande pour charger les propriétés de l’objet spécifié. Vous devez contacter `context.sync()` avant de lire les propriétés.
load(propertyNames)	Files d’attente de la commande pour charger les propriétés de l’objet spécifié. Vous devez contacter `context.sync()` avant de lire les propriétés.
load(propertyNamesAndPaths)	Files d’attente de la commande pour charger les propriétés de l’objet spécifié. Vous devez contacter `context.sync()` avant de lire les propriétés.
move(options)	Réduit la sélection à sa position de début ou de fin, puis déplace l’objet réduit selon le nombre d’unités spécifié.
moveDown(options)	Déplace la sélection vers le bas.
moveEnd(options)	Déplace la position du caractère de fin de la plage ou de la sélection.
moveEndUntil(characters, count)	Déplace la position de fin de la sélection jusqu’à ce que l’un des caractères spécifiés soit trouvé dans le document.
moveEndWhile(characters, count)	Déplace la position du caractère de fin de la sélection pendant que l’un des caractères spécifiés est trouvé dans le document.
moveLeft(options)	Déplace la sélection vers la gauche.
moveRight(options)	Déplace la sélection vers la droite.
moveStart(options)	Déplace la position de début de la sélection.
moveStartUntil(characters, count)	Déplace la position de début de la sélection jusqu’à ce que l’un des caractères spécifiés soit trouvé dans le document.
moveStartWhile(characters, count)	Déplace la position de début de la sélection lorsque l’un des caractères spécifiés est trouvé dans le document.
moveUntil(characters, count)	Déplace la sélection jusqu’à ce que l’un des caractères spécifiés soit trouvé dans le document.
moveUp(options)	Déplace la sélection vers le haut.
moveWhile(characters, count)	Déplace la sélection lorsque l’un des caractères spécifiés est trouvé dans le document.
nextField()	Sélectionne le champ suivant.
nextSubdocument()	Déplace la sélection au sous-document suivant.
pasteAndFormat(type)	Colle le contenu du Presse-papiers et le met en forme comme spécifié.
pasteAndFormat(type)	Colle le contenu du Presse-papiers et le met en forme comme spécifié.
pasteExcelTable(linkedToExcel, wordFormatting, rtf)	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.
pasteTableCellsAppendTable()	Fusionne des cellules collées dans un tableau existant en insérant les lignes collées entre les lignes sélectionnées.
pasteTableCellsAsNestedTable()	Colle une cellule ou un groupe de cellules sous forme de tableau imbriqué dans la sélection.
previousField()	Sélectionne et renvoie le champ précédent.
previousSubdocument()	Déplace la sélection au sous-document précédent.
replaceParagraph()	Remplace la sélection par un nouveau paragraphe.
select()	Sélectionne le texte actuel.
selectCell()	Sélectionne la cellule entière contenant la sélection actuelle lorsque la sélection se trouve dans un tableau.
selectColumn()	Sélectionne la colonne qui contient le point d’insertion ou toutes les colonnes qui contiennent la sélection lorsque la sélection se trouve dans une table.
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 lorsque la sélection se trouve dans un tableau.
setRange(start, end)	Définit l'emplacement du caractère de début et celui du caractère de fin pour la sélection. Les valeurs de position des caractères commencent au début de l’article, la première valeur étant 0. Tous les caractères sont comptés, y compris les caractères non imprimables. Les caractères masqués sont comptés même s'ils ne sont pas affichés.
shrink()	Réduit la sélection à l'unité de texte inférieure la plus proche. L'ordre des unités pour cette méthode est le suivant : document entier, section, paragraphe, phrase, mot, puis point d'insertion.
shrinkDiscontiguousSelection()	Annule la sélection de tout le texte sélectionné, sauf le texte le plus récent, lorsque la sélection actuelle contient plusieurs sélections non connectées.
splitTable()	Insère un paragraphe vide au-dessus de la première ligne de la sélection. Si la sélection ne se trouve pas dans la première ligne du tableau, celui-ci est scindé en deux tableaux. Si la sélection ne se trouve pas dans un tableau, une erreur se produit.
toggleCharacterCode()	Bascule la sélection entre un caractère Unicode et sa valeur hexadécimale correspondante.
toJSON()	Remplace la méthode JavaScript `toJSON()` afin de fournir une sortie plus utile lorsqu’un objet API est passé à `JSON.stringify()`. (`JSON.stringify`, à son tour, appelle la `toJSON` méthode de l’objet qui lui est passé.) Alors que l’objet d’origine `Word.Selection` est un objet API, la `toJSON` méthode renvoie un objet JavaScript brut (typé en tant `Word.Interfaces.SelectionData`que ) qui contient des copies superficielles de toutes les propriétés enfants chargées de l’objet d’origine.
track()	Effectuer le suivi de l’objet pour l’ajustement automatique en fonction environnant des modifications dans le document. Cet appel est un raccourci pour context.trackedObjects.add(thisObject). Si vous utilisez cet objet sur des `.sync` appels et en dehors de l’exécution séquentielle d’un lot « .run », et que vous obtenez une erreur « InvalidObjectPath » lors de la définition d’une propriété ou de l’appel d’une méthode sur l’objet, vous devez ajouter l’objet à la collection d’objets suivie lors de la première création de l’objet. Si cet objet fait partie d’une collection, vous devez également suivre la collection parente.
typeBackspace()	Supprime le caractère qui précède la sélection (s’il est réduit) ou le point d’insertion.
untrack()	Publication mémoire associée à cet objet si elle a été précédemment suivie. Cet appel est abrégé pour context.trackedObjects.remove(thisObject). Vous rencontrez de nombreux objets suivies ralentit l’application hôte, donc n’oubliez pas de libérer les objets que l'on ajoute, une fois que vous avez terminé à les utiliser. Vous devez appeler `context.sync()` avant que la mise en production de la mémoire ne prenne effet.

Détails de la propriété

borders

Renvoie un BorderUniversalCollection objet qui représente toutes les bordures des objets de la sélection.

readonly borders: Word.BorderUniversalCollection;

Valeur de propriété

Word.BorderUniversalCollection

Remarques

[ Ensemble d’API : WordApiDesktop 1.4 ]

characters

Renvoie un RangeScopedCollection objet qui représente chaque caractère de la sélection.

readonly characters: Word.RangeScopedCollection;

Valeur de propriété

Word.RangeScopedCollection

Remarques

[ Ensemble d’API : WordApiDesktop 1.4 ]

comments

Renvoie un CommentCollection objet qui représente tous les commentaires de la sélection.

readonly comments: Word.CommentCollection;

Valeur de propriété

Word.CommentCollection

Remarques

[ Ensemble d’API : WordApiDesktop 1.4 ]

context

Contexte de requête associé à l’objet . Cela connecte le processus du complément au processus de l’application hôte Office.

context: RequestContext;

Valeur de propriété

Word.RequestContext

end

Spécifie la position du caractère de fin de la sélection.

end: number;

Valeur de propriété

number

Remarques

[ Ensemble d’API : WordApiDesktop 1.4 ]

fields

Renvoie un FieldCollection objet qui représente tous les champs de la sélection.

readonly fields: Word.FieldCollection;

Valeur de propriété

Word.FieldCollection

Remarques

[ Ensemble d’API : WordApiDesktop 1.4 ]

fitTextWidth

Spécifie la largeur dans laquelle Word ajuste le texte dans la sélection actuelle.

fitTextWidth: number;

Valeur de propriété

number

Remarques

[ Ensemble d’API : WordApiDesktop 1.4 ]

font

Renvoie l’objet Font qui représente la mise en forme des caractères de la sélection.

readonly font: Word.Font;

Valeur de propriété

Word.Font

Remarques

[ Ensemble d’API : WordApiDesktop 1.4 ]

formattedText

Spécifie un Range objet qui inclut le texte mis en forme dans la plage ou la sélection.

formattedText: Word.Range;

Valeur de propriété

Word.Range

Remarques

[ Ensemble d’API : WordApiDesktop 1.4 ]

hasNoProofing

Renvoie une valeur indiquant si le vérificateur d’orthographe et de grammaire ignore le texte sélectionné. Si le texte sélectionné contient un mélange de contenu avec et sans vérification, cette API retourne null.

readonly hasNoProofing: boolean;

Valeur de propriété

boolean

Remarques

[ Ensemble d’API : WordApiDesktop 1.4 ]

isActive

Retourne si la sélection dans la fenêtre ou le volet spécifié est active.

readonly isActive: boolean;

Valeur de propriété

boolean

Remarques

[ Ensemble d’API : WordApiDesktop 1.4 ]

isColumnSelectModeActive

Spécifie si le mode de sélection de colonne est actif.

isColumnSelectModeActive: boolean;

Valeur de propriété

boolean

Remarques

[ Ensemble d’API : WordApiDesktop 1.4 ]

isEndOfRowMark

Retourne si la sélection se trouve à la marque de fin de ligne dans un tableau.

readonly isEndOfRowMark: boolean;

Valeur de propriété

boolean

Remarques

[ Ensemble d’API : WordApiDesktop 1.4 ]

isExtendModeActive

Spécifie si le mode d’extension est actif.

isExtendModeActive: boolean;

Valeur de propriété

boolean

Remarques

[ Ensemble d’API : WordApiDesktop 1.4 ]

isInsertionPointAtEndOfLine

Retourne si le point d’insertion se trouve à la fin d’une ligne.

readonly isInsertionPointAtEndOfLine: boolean;

Valeur de propriété

boolean

Remarques

[ Ensemble d’API : WordApiDesktop 1.4 ]

isStartActive

Spécifie si le début de la sélection est actif.

isStartActive: boolean;

Valeur de propriété

boolean

Remarques

[ Ensemble d’API : WordApiDesktop 1.4 ]

languageDetected

Spécifie si Word a détecté la langue du texte sélectionné.

languageDetected: boolean;

Valeur de propriété

boolean

Remarques

[ Ensemble d’API : WordApiDesktop 1.4 ]

languageId

Retourne la langue de la sélection.

readonly languageId: Word.LanguageId | "Afrikaans" | "Albanian" | "Amharic" | "Arabic" | "ArabicAlgeria" | "ArabicBahrain" | "ArabicEgypt" | "ArabicIraq" | "ArabicJordan" | "ArabicKuwait" | "ArabicLebanon" | "ArabicLibya" | "ArabicMorocco" | "ArabicOman" | "ArabicQatar" | "ArabicSyria" | "ArabicTunisia" | "ArabicUAE" | "ArabicYemen" | "Armenian" | "Assamese" | "AzeriCyrillic" | "AzeriLatin" | "Basque" | "BelgianDutch" | "BelgianFrench" | "Bengali" | "Bulgarian" | "Burmese" | "Belarusian" | "Catalan" | "Cherokee" | "ChineseHongKongSAR" | "ChineseMacaoSAR" | "ChineseSingapore" | "Croatian" | "Czech" | "Danish" | "Divehi" | "Dutch" | "Edo" | "EnglishAUS" | "EnglishBelize" | "EnglishCanadian" | "EnglishCaribbean" | "EnglishIndonesia" | "EnglishIreland" | "EnglishJamaica" | "EnglishNewZealand" | "EnglishPhilippines" | "EnglishSouthAfrica" | "EnglishTrinidadTobago" | "EnglishUK" | "EnglishUS" | "EnglishZimbabwe" | "Estonian" | "Faeroese" | "Filipino" | "Finnish" | "French" | "FrenchCameroon" | "FrenchCanadian" | "FrenchCongoDRC" | "FrenchCotedIvoire" | "FrenchHaiti" | "FrenchLuxembourg" | "FrenchMali" | "FrenchMonaco" | "FrenchMorocco" | "FrenchReunion" | "FrenchSenegal" | "FrenchWestIndies" | "FrisianNetherlands" | "Fulfulde" | "GaelicIreland" | "GaelicScotland" | "Galician" | "Georgian" | "German" | "GermanAustria" | "GermanLiechtenstein" | "GermanLuxembourg" | "Greek" | "Guarani" | "Gujarati" | "Hausa" | "Hawaiian" | "Hebrew" | "Hindi" | "Hungarian" | "Ibibio" | "Icelandic" | "Igbo" | "Indonesian" | "Inuktitut" | "Italian" | "Japanese" | "Kannada" | "Kanuri" | "Kashmiri" | "Kazakh" | "Khmer" | "Kirghiz" | "Konkani" | "Korean" | "Kyrgyz" | "LanguageNone" | "Lao" | "Latin" | "Latvian" | "Lithuanian" | "MacedonianFYROM" | "Malayalam" | "MalayBruneiDarussalam" | "Malaysian" | "Maltese" | "Manipuri" | "Marathi" | "MexicanSpanish" | "Mongolian" | "Nepali" | "NoProofing" | "NorwegianBokmol" | "NorwegianNynorsk" | "Oriya" | "Oromo" | "Pashto" | "Persian" | "Polish" | "Portuguese" | "PortugueseBrazil" | "Punjabi" | "RhaetoRomanic" | "Romanian" | "RomanianMoldova" | "Russian" | "RussianMoldova" | "SamiLappish" | "Sanskrit" | "SerbianCyrillic" | "SerbianLatin" | "Sesotho" | "SimplifiedChinese" | "Sindhi" | "SindhiPakistan" | "Sinhalese" | "Slovak" | "Slovenian" | "Somali" | "Sorbian" | "Spanish" | "SpanishArgentina" | "SpanishBolivia" | "SpanishChile" | "SpanishColombia" | "SpanishCostaRica" | "SpanishDominicanRepublic" | "SpanishEcuador" | "SpanishElSalvador" | "SpanishGuatemala" | "SpanishHonduras" | "SpanishModernSort" | "SpanishNicaragua" | "SpanishPanama" | "SpanishParaguay" | "SpanishPeru" | "SpanishPuertoRico" | "SpanishUruguay" | "SpanishVenezuela" | "Sutu" | "Swahili" | "Swedish" | "SwedishFinland" | "SwissFrench" | "SwissGerman" | "SwissItalian" | "Syriac" | "Tajik" | "Tamazight" | "TamazightLatin" | "Tamil" | "Tatar" | "Telugu" | "Thai" | "Tibetan" | "TigrignaEritrea" | "TigrignaEthiopic" | "TraditionalChinese" | "Tsonga" | "Tswana" | "Turkish" | "Turkmen" | "Ukrainian" | "Urdu" | "UzbekCyrillic" | "UzbekLatin" | "Venda" | "Vietnamese" | "Welsh" | "Xhosa" | "Yi" | "Yiddish" | "Yoruba" | "Zulu";

Valeur de propriété

Remarques

[ Ensemble d’API : WordApiDesktop 1.4 ]

languageIdFarEast

Renvoie la langue d’Asie de l’Est pour la sélection.

readonly languageIdFarEast: Word.LanguageId | "Afrikaans" | "Albanian" | "Amharic" | "Arabic" | "ArabicAlgeria" | "ArabicBahrain" | "ArabicEgypt" | "ArabicIraq" | "ArabicJordan" | "ArabicKuwait" | "ArabicLebanon" | "ArabicLibya" | "ArabicMorocco" | "ArabicOman" | "ArabicQatar" | "ArabicSyria" | "ArabicTunisia" | "ArabicUAE" | "ArabicYemen" | "Armenian" | "Assamese" | "AzeriCyrillic" | "AzeriLatin" | "Basque" | "BelgianDutch" | "BelgianFrench" | "Bengali" | "Bulgarian" | "Burmese" | "Belarusian" | "Catalan" | "Cherokee" | "ChineseHongKongSAR" | "ChineseMacaoSAR" | "ChineseSingapore" | "Croatian" | "Czech" | "Danish" | "Divehi" | "Dutch" | "Edo" | "EnglishAUS" | "EnglishBelize" | "EnglishCanadian" | "EnglishCaribbean" | "EnglishIndonesia" | "EnglishIreland" | "EnglishJamaica" | "EnglishNewZealand" | "EnglishPhilippines" | "EnglishSouthAfrica" | "EnglishTrinidadTobago" | "EnglishUK" | "EnglishUS" | "EnglishZimbabwe" | "Estonian" | "Faeroese" | "Filipino" | "Finnish" | "French" | "FrenchCameroon" | "FrenchCanadian" | "FrenchCongoDRC" | "FrenchCotedIvoire" | "FrenchHaiti" | "FrenchLuxembourg" | "FrenchMali" | "FrenchMonaco" | "FrenchMorocco" | "FrenchReunion" | "FrenchSenegal" | "FrenchWestIndies" | "FrisianNetherlands" | "Fulfulde" | "GaelicIreland" | "GaelicScotland" | "Galician" | "Georgian" | "German" | "GermanAustria" | "GermanLiechtenstein" | "GermanLuxembourg" | "Greek" | "Guarani" | "Gujarati" | "Hausa" | "Hawaiian" | "Hebrew" | "Hindi" | "Hungarian" | "Ibibio" | "Icelandic" | "Igbo" | "Indonesian" | "Inuktitut" | "Italian" | "Japanese" | "Kannada" | "Kanuri" | "Kashmiri" | "Kazakh" | "Khmer" | "Kirghiz" | "Konkani" | "Korean" | "Kyrgyz" | "LanguageNone" | "Lao" | "Latin" | "Latvian" | "Lithuanian" | "MacedonianFYROM" | "Malayalam" | "MalayBruneiDarussalam" | "Malaysian" | "Maltese" | "Manipuri" | "Marathi" | "MexicanSpanish" | "Mongolian" | "Nepali" | "NoProofing" | "NorwegianBokmol" | "NorwegianNynorsk" | "Oriya" | "Oromo" | "Pashto" | "Persian" | "Polish" | "Portuguese" | "PortugueseBrazil" | "Punjabi" | "RhaetoRomanic" | "Romanian" | "RomanianMoldova" | "Russian" | "RussianMoldova" | "SamiLappish" | "Sanskrit" | "SerbianCyrillic" | "SerbianLatin" | "Sesotho" | "SimplifiedChinese" | "Sindhi" | "SindhiPakistan" | "Sinhalese" | "Slovak" | "Slovenian" | "Somali" | "Sorbian" | "Spanish" | "SpanishArgentina" | "SpanishBolivia" | "SpanishChile" | "SpanishColombia" | "SpanishCostaRica" | "SpanishDominicanRepublic" | "SpanishEcuador" | "SpanishElSalvador" | "SpanishGuatemala" | "SpanishHonduras" | "SpanishModernSort" | "SpanishNicaragua" | "SpanishPanama" | "SpanishParaguay" | "SpanishPeru" | "SpanishPuertoRico" | "SpanishUruguay" | "SpanishVenezuela" | "Sutu" | "Swahili" | "Swedish" | "SwedishFinland" | "SwissFrench" | "SwissGerman" | "SwissItalian" | "Syriac" | "Tajik" | "Tamazight" | "TamazightLatin" | "Tamil" | "Tatar" | "Telugu" | "Thai" | "Tibetan" | "TigrignaEritrea" | "TigrignaEthiopic" | "TraditionalChinese" | "Tsonga" | "Tswana" | "Turkish" | "Turkmen" | "Ukrainian" | "Urdu" | "UzbekCyrillic" | "UzbekLatin" | "Venda" | "Vietnamese" | "Welsh" | "Xhosa" | "Yi" | "Yiddish" | "Yoruba" | "Zulu";

Valeur de propriété

Remarques

[ Ensemble d’API : WordApiDesktop 1.4 ]

languageIdOther

Renvoie la langue de la sélection qui n’est pas classée comme langue d’Asie de l’Est.

readonly languageIdOther: Word.LanguageId | "Afrikaans" | "Albanian" | "Amharic" | "Arabic" | "ArabicAlgeria" | "ArabicBahrain" | "ArabicEgypt" | "ArabicIraq" | "ArabicJordan" | "ArabicKuwait" | "ArabicLebanon" | "ArabicLibya" | "ArabicMorocco" | "ArabicOman" | "ArabicQatar" | "ArabicSyria" | "ArabicTunisia" | "ArabicUAE" | "ArabicYemen" | "Armenian" | "Assamese" | "AzeriCyrillic" | "AzeriLatin" | "Basque" | "BelgianDutch" | "BelgianFrench" | "Bengali" | "Bulgarian" | "Burmese" | "Belarusian" | "Catalan" | "Cherokee" | "ChineseHongKongSAR" | "ChineseMacaoSAR" | "ChineseSingapore" | "Croatian" | "Czech" | "Danish" | "Divehi" | "Dutch" | "Edo" | "EnglishAUS" | "EnglishBelize" | "EnglishCanadian" | "EnglishCaribbean" | "EnglishIndonesia" | "EnglishIreland" | "EnglishJamaica" | "EnglishNewZealand" | "EnglishPhilippines" | "EnglishSouthAfrica" | "EnglishTrinidadTobago" | "EnglishUK" | "EnglishUS" | "EnglishZimbabwe" | "Estonian" | "Faeroese" | "Filipino" | "Finnish" | "French" | "FrenchCameroon" | "FrenchCanadian" | "FrenchCongoDRC" | "FrenchCotedIvoire" | "FrenchHaiti" | "FrenchLuxembourg" | "FrenchMali" | "FrenchMonaco" | "FrenchMorocco" | "FrenchReunion" | "FrenchSenegal" | "FrenchWestIndies" | "FrisianNetherlands" | "Fulfulde" | "GaelicIreland" | "GaelicScotland" | "Galician" | "Georgian" | "German" | "GermanAustria" | "GermanLiechtenstein" | "GermanLuxembourg" | "Greek" | "Guarani" | "Gujarati" | "Hausa" | "Hawaiian" | "Hebrew" | "Hindi" | "Hungarian" | "Ibibio" | "Icelandic" | "Igbo" | "Indonesian" | "Inuktitut" | "Italian" | "Japanese" | "Kannada" | "Kanuri" | "Kashmiri" | "Kazakh" | "Khmer" | "Kirghiz" | "Konkani" | "Korean" | "Kyrgyz" | "LanguageNone" | "Lao" | "Latin" | "Latvian" | "Lithuanian" | "MacedonianFYROM" | "Malayalam" | "MalayBruneiDarussalam" | "Malaysian" | "Maltese" | "Manipuri" | "Marathi" | "MexicanSpanish" | "Mongolian" | "Nepali" | "NoProofing" | "NorwegianBokmol" | "NorwegianNynorsk" | "Oriya" | "Oromo" | "Pashto" | "Persian" | "Polish" | "Portuguese" | "PortugueseBrazil" | "Punjabi" | "RhaetoRomanic" | "Romanian" | "RomanianMoldova" | "Russian" | "RussianMoldova" | "SamiLappish" | "Sanskrit" | "SerbianCyrillic" | "SerbianLatin" | "Sesotho" | "SimplifiedChinese" | "Sindhi" | "SindhiPakistan" | "Sinhalese" | "Slovak" | "Slovenian" | "Somali" | "Sorbian" | "Spanish" | "SpanishArgentina" | "SpanishBolivia" | "SpanishChile" | "SpanishColombia" | "SpanishCostaRica" | "SpanishDominicanRepublic" | "SpanishEcuador" | "SpanishElSalvador" | "SpanishGuatemala" | "SpanishHonduras" | "SpanishModernSort" | "SpanishNicaragua" | "SpanishPanama" | "SpanishParaguay" | "SpanishPeru" | "SpanishPuertoRico" | "SpanishUruguay" | "SpanishVenezuela" | "Sutu" | "Swahili" | "Swedish" | "SwedishFinland" | "SwissFrench" | "SwissGerman" | "SwissItalian" | "Syriac" | "Tajik" | "Tamazight" | "TamazightLatin" | "Tamil" | "Tatar" | "Telugu" | "Thai" | "Tibetan" | "TigrignaEritrea" | "TigrignaEthiopic" | "TraditionalChinese" | "Tsonga" | "Tswana" | "Turkish" | "Turkmen" | "Ukrainian" | "Urdu" | "UzbekCyrillic" | "UzbekLatin" | "Venda" | "Vietnamese" | "Welsh" | "Xhosa" | "Yi" | "Yiddish" | "Yoruba" | "Zulu";

Valeur de propriété

Remarques

[ Ensemble d’API : WordApiDesktop 1.4 ]

orientation

Spécifie l’orientation du texte dans la sélection.

orientation: Word.TextOrientation | "Horizontal" | "Upward" | "Downward" | "VerticalFarEast" | "HorizontalRotatedFarEast" | "Vertical";

Valeur de propriété

Remarques

[ Ensemble d’API : WordApiDesktop 1.4 ]

paragraphs

Renvoie un ParagraphCollection objet qui représente tous les paragraphes de la sélection.

readonly paragraphs: Word.ParagraphCollection;

Valeur de propriété

Word.ParagraphCollection

Remarques

[ Ensemble d’API : WordApiDesktop 1.4 ]

range

Renvoie l’objet Range pour la partie du document contenue dans la sélection.

readonly range: Word.Range;

Valeur de propriété

Word.Range

Remarques

[ Ensemble d’API : WordApiDesktop 1.4 ]

sections

Retourne l’objet SectionCollection dans la sélection.

readonly sections: Word.SectionCollection;

Valeur de propriété

Word.SectionCollection

Remarques

[ Ensemble d’API : WordApiDesktop 1.4 ]

sentences

Retourne l’objet RangeScopedCollection pour chaque phrase de la sélection.

readonly sentences: Word.RangeScopedCollection;

Valeur de propriété

Word.RangeScopedCollection

Remarques

[ Ensemble d’API : WordApiDesktop 1.4 ]

shading

Retourne l’objet ShadingUniversal pour la mise en forme d’ombrage de la sélection.

readonly shading: Word.ShadingUniversal;

Valeur de propriété

Word.ShadingUniversal

Remarques

[ Ensemble d’API : WordApiDesktop 1.4 ]

start

Spécifie la position du caractère de départ de la sélection.

start: number;

Valeur de propriété

number

Remarques

[ Ensemble d’API : WordApiDesktop 1.4 ]

storyLength

Renvoie le nombre de caractères dans l’article qui contient la sélection.

readonly storyLength: number;

Valeur de propriété

number

Remarques

[ Ensemble d’API : WordApiDesktop 1.4 ]

storyType

Retourne le type d’article de la sélection.

readonly storyType: Word.StoryType | "MainText" | "Footnotes" | "Endnotes" | "Comments" | "TextFrame" | "EvenPagesHeader" | "PrimaryHeader" | "EvenPagesFooter" | "PrimaryFooter" | "FirstPageHeader" | "FirstPageFooter" | "FootnoteSeparator" | "FootnoteContinuationSeparator" | "FootnoteContinuationNotice" | "EndnoteSeparator" | "EndnoteContinuationSeparator" | "EndnoteContinuationNotice";

Valeur de propriété

Remarques

[ Ensemble d’API : WordApiDesktop 1.4 ]

tables

Retourne l’objet TableCollection dans la sélection.

readonly tables: Word.TableCollection;

Valeur de propriété

Word.TableCollection

Remarques

[ Ensemble d’API : WordApiDesktop 1.4 ]

text

Spécifie le texte de la sélection.

text: string;

Valeur de propriété

string

Remarques

[ Ensemble d’API : WordApiDesktop 1.4 ]

topLevelTables

Retourne les tables au niveau d’imbrication le plus externe dans la sélection actuelle.

readonly topLevelTables: Word.TableCollection;

Valeur de propriété

Word.TableCollection

Remarques

[ Ensemble d’API : WordApiDesktop 1.4 ]

type

Renvoie le type de sélection.

readonly type: Word.SelectionType | "NoSelection" | "InsertionPoint" | "Normal" | "Frame" | "Column" | "Row" | "Block" | "InlineShape" | "SelectionShape";

Valeur de propriété

Remarques

[ Ensemble d’API : WordApiDesktop 1.4 ]

words

Renvoie l’objet RangeScopedCollection qui représente chaque mot de la sélection.

readonly words: Word.RangeScopedCollection;

Valeur de propriété

Word.RangeScopedCollection

Remarques

[ Ensemble d’API : WordApiDesktop 1.4 ]

Détails de la méthode

calculate()

Calcule la première expression mathématique dans la sélection.

calculate(): OfficeExtension.ClientResult<number>;

Retours

OfficeExtension.ClientResult<number>

Résultat du calcul.

Remarques

[ Ensemble d’API : WordApiDesktop 1.4 ]

cancelMode()

Annule un mode tel que l’extension ou la sélection de colonne. Cela équivaut à appuyer sur la touche Échap.

cancelMode(): void;

Retours

void

Remarques

[ Ensemble d’API : WordApiDesktop 1.4 ]

clearCharacterStyleFormatting()

Supprime la mise en forme des caractères appliquée par le biais de styles de caractères.

clearCharacterStyleFormatting(): void;

Retours

void

Remarques

[ Ensemble d’API : WordApiDesktop 1.4 ]

clearFormatting()

Supprime la mise en forme des caractères et des paragraphes de la sélection.

clearFormatting(): void;

Retours

void

Remarques

[ Ensemble d’API : WordApiDesktop 1.4 ]

clearManualCharacterFormatting()

Supprime la mise en forme de caractères appliquée manuellement du texte sélectionné.

clearManualCharacterFormatting(): void;

Retours

void

Remarques

[ Ensemble d’API : WordApiDesktop 1.4 ]

clearManualParagraphFormatting()

Supprime la mise en forme de paragraphe appliquée manuellement du texte sélectionné.

clearManualParagraphFormatting(): void;

Retours

void

Remarques

[ Ensemble d’API : WordApiDesktop 1.4 ]

clearParagraphFormatting()

Supprime toute la mise en forme de paragraphe du texte sélectionné.

clearParagraphFormatting(): void;

Retours

void

Remarques

[ Ensemble d’API : WordApiDesktop 1.4 ]

clearParagraphStyle()

Supprime la mise en forme de paragraphe appliquée par le biais de styles de paragraphe.

clearParagraphStyle(): void;

Retours

void

Remarques

[ Ensemble d’API : WordApiDesktop 1.4 ]

collapse(direction)

Réduit la sélection à la position de début ou de fin.

collapse(direction?: Word.CollapseDirection): void;

Paramètres

direction: Word.CollapseDirection

Facultatif. Direction à réduire.

Retours

void

Remarques

[ Ensemble d’API : WordApiDesktop 1.4 ]

collapse(direction)

Réduit la sélection à la position de début ou de fin.

collapse(direction?: "Start" | "End"): void;

Paramètres

direction: "Start" | "End"

Facultatif. Direction à réduire.

Retours

void

Remarques

[ Ensemble d’API : WordApiDesktop 1.4 ]

convertToTable(options)

Notes

Cet API est fourni en tant qu’aperçu pour les développeurs et peut être modifié en fonction des commentaires que nous avons reçus. N’utilisez pas cet API dans un environnement de production.

Convertit le texte d'une plage à un tableau.

convertToTable(options?: Word.SelectionConvertToTableOptions): Word.Table;

Paramètres

options: Word.SelectionConvertToTableOptions

Facultatif. Options de conversion de texte en tableau.

Retours

Word.Table

Objet Table qui représente la table nouvellement créée.

Remarques

[ Ensemble d’API : WordApi BETA (PRÉVERSION UNIQUEMENT) ]

copyAsPictureToClipboard()

Copie la sélection dans le Presse-papiers sous forme d’image.

copyAsPictureToClipboard(): void;

Retours

void

Remarques

[ Ensemble d’API : WordApiDesktop 1.4 ]

copyFormat()

Copie la mise en forme du premier caractère du texte sélectionné.

copyFormat(): void;

Retours

void

Remarques

[ Ensemble d’API : WordApiDesktop 1.4 ]

copyToClipboard()

Copie la sélection dans le Presse-papiers.

copyToClipboard(): void;

Retours

void

Remarques

[ Ensemble d’API : WordApiDesktop 1.4 ]

createTextBox()

Ajoute une zone de texte de taille par défaut autour de la sélection.

createTextBox(): void;

Retours

void

Remarques

[ Ensemble d’API : WordApiDesktop 1.4 ]

cut()

Supprime le contenu sélectionné du document et le déplace dans le Presse-papiers.

cut(): void;

Retours

void

Remarques

[ Ensemble d’API : WordApiDesktop 1.4 ]

delete(options)

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

delete(options?: Word.SelectionDeleteOptions): OfficeExtension.ClientResult<number>;

Paramètres

options: Word.SelectionDeleteOptions

Facultatif. Options de suppression de texte.

Retours

OfficeExtension.ClientResult<number>

Nombre de caractères supprimés.

Remarques

[ Ensemble d’API : WordApiDesktop 1.4 ]

detectLanguage()

Analyse le texte sélectionné pour déterminer la langue dans laquelle il est écrit.

detectLanguage(): void;

Retours

void

Remarques

[ Ensemble d’API : WordApiDesktop 1.4 ]

expand(unit)

Développe la sélection.

expand(unit?: Word.OperationUnit): OfficeExtension.ClientResult<number>;

Paramètres

unit: Word.OperationUnit

Facultatif. Unité à développer.

Retours

OfficeExtension.ClientResult<number>

Nombre de caractères ajoutés à la plage ou à la sélection.

Remarques

[ Ensemble d’API : WordApiDesktop 1.4 ]

expand(unit)

Développe la sélection.

expand(unit?: "Character" | "Word" | "Sentence" | "Paragraph" | "Line" | "Story" | "Screen" | "Section" | "Column" | "Row" | "Window" | "Cell" | "CharacterFormat" | "ParagraphFormat" | "Table" | "Item"): OfficeExtension.ClientResult<number>;

Paramètres

unit: "Character" | "Word" | "Sentence" | "Paragraph" | "Line" | "Story" | "Screen" | "Section" | "Column" | "Row" | "Window" | "Cell" | "CharacterFormat" | "ParagraphFormat" | "Table" | "Item"

Facultatif. Unité à développer.

Retours

OfficeExtension.ClientResult<number>

Nombre de caractères ajoutés à la plage ou à la sélection.

Remarques

[ Ensemble d’API : WordApiDesktop 1.4 ]

expandToWholeStory()

Développe la sélection pour inclure l’intégralité de l’article.

expandToWholeStory(): void;

Retours

void

Remarques

[ Ensemble d’API : WordApiDesktop 1.4 ]

extend(character)

Active le mode Extension et, si celui-ci est déjà activé, étend la sélection jusqu'à l'unité de texte supérieure suivante.

extend(character?: Word.OperationUnit): void;

Paramètres

character: Word.OperationUnit

Facultatif. Caractère jusqu'auquel la sélection est étendue. Cet argument respecte la casse et doit prendre la valeur d’une chaîne, sinon une erreur se produit. De plus, si la valeur de cet argument se compose de plusieurs caractères, Microsoft Word ignore la commande.

Retours

void

Remarques

[ Ensemble d’API : WordApiDesktop 1.4 ]

extend(character)

Active le mode Extension et, si celui-ci est déjà activé, étend la sélection jusqu'à l'unité de texte supérieure suivante.

extend(character?: "Character" | "Word" | "Sentence" | "Paragraph" | "Line" | "Story" | "Screen" | "Section" | "Column" | "Row" | "Window" | "Cell" | "CharacterFormat" | "ParagraphFormat" | "Table" | "Item"): void;

Paramètres

character: "Character" | "Word" | "Sentence" | "Paragraph" | "Line" | "Story" | "Screen" | "Section" | "Column" | "Row" | "Window" | "Cell" | "CharacterFormat" | "ParagraphFormat" | "Table" | "Item"

Retours

void

Remarques

[ Ensemble d’API : WordApiDesktop 1.4 ]

getNextRange(options)

Renvoie un Range objet qui représente l’unité suivante relative à la sélection.

getNextRange(options?: Word.SelectionNextOptions): Word.Range;

Paramètres

options: Word.SelectionNextOptions

Facultatif. Options de l’opération next .

Retours

Word.Range

Objet Range qui représente l’unité suivante relative à la sélection.

Remarques

[ Ensemble d’API : WordApiDesktop 1.4 ]

getPreviousRange(options)

Renvoie un Range objet qui représente l’unité précédente relative à la sélection.

getPreviousRange(options?: Word.SelectionPreviousOptions): Word.Range;

Paramètres

options: Word.SelectionPreviousOptions

Facultatif. Options de l’opération previous .

Retours

Word.Range

Objet Range qui représente l’unité précédente relative à la sélection.

Remarques

[ Ensemble d’API : WordApiDesktop 1.4 ]

goTo(options)

Notes

Cet API est fourni en tant qu’aperçu pour les développeurs et peut être modifié en fonction des commentaires que nous avons reçus. N’utilisez pas cet API dans un environnement de production.

Renvoie un Range objet qui représente la zone spécifiée par et options déplace le point d’insertion vers la position de caractère précédant immédiatement l’élément spécifié.

goTo(options?: Word.GoToOptions): Word.Range;

Paramètres

options: Word.GoToOptions

Facultatif. Options de l’opération goTo .

Retours

Word.Range

Objet Range qui est maintenant sélectionné.

Remarques

[ Ensemble d’API : WordApi BETA (PRÉVERSION UNIQUEMENT) ]

goToNext(what)

Renvoie 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 et déplace la sélection vers l’élément spécifié.

goToNext(what: Word.GoToItem): Word.Range;

Paramètres

what: Word.GoToItem

Type d’élément auquel accéder.

Retours

Word.Range

Objet Range 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 .

Remarques

[ Ensemble d’API : WordApiDesktop 1.4 ]

goToNext(what)

goToNext(what: "Bookmark" | "Comment" | "Endnote" | "Field" | "Footnote" | "Graphic" | "Heading" | "Line" | "Page" | "Section" | "Table" | "EmbeddedObject" | "Equation" | "Percent" | "SpellingError" | "GrammaticalError" | "ProofreadingError"): Word.Range;

Paramètres

what: "Bookmark" | "Comment" | "Endnote" | "Field" | "Footnote" | "Graphic" | "Heading" | "Line" | "Page" | "Section" | "Table" | "EmbeddedObject" | "Equation" | "Percent" | "SpellingError" | "GrammaticalError" | "ProofreadingError"

Type d’élément auquel accéder.

Retours

Word.Range

Objet Range 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 .

Remarques

[ Ensemble d’API : WordApiDesktop 1.4 ]

goToPrevious(what)

Renvoie un Range objet qui fait référence à la position de début de l’élément ou de l’emplacement précédent spécifié par l’argument what et déplace la sélection vers l’élément spécifié.

goToPrevious(what: Word.GoToItem): Word.Range;

Paramètres

what: Word.GoToItem

Type d’élément auquel accéder.

Retours

Word.Range

Objet Range qui fait référence à la position de début de l’élément ou de l’emplacement précédent spécifié par l’argument what .

Remarques

[ Ensemble d’API : WordApiDesktop 1.4 ]

goToPrevious(what)

goToPrevious(what: "Bookmark" | "Comment" | "Endnote" | "Field" | "Footnote" | "Graphic" | "Heading" | "Line" | "Page" | "Section" | "Table" | "EmbeddedObject" | "Equation" | "Percent" | "SpellingError" | "GrammaticalError" | "ProofreadingError"): Word.Range;

Paramètres

what: "Bookmark" | "Comment" | "Endnote" | "Field" | "Footnote" | "Graphic" | "Heading" | "Line" | "Page" | "Section" | "Table" | "EmbeddedObject" | "Equation" | "Percent" | "SpellingError" | "GrammaticalError" | "ProofreadingError"

Type d’élément auquel accéder.

Retours

Word.Range

Objet Range qui fait référence à la position de début de l’élément ou de l’emplacement précédent spécifié par l’argument what .

Remarques

[ Ensemble d’API : WordApiDesktop 1.4 ]

insertAfter(text)

Insère le texte spécifié à la fin de la plage ou de la sélection.

insertAfter(text: string): void;

Paramètres

text: string

Texte à insérer.

Retours

void

Remarques

[ Ensemble d’API : WordApiDesktop 1.4 ]

insertBefore(text)

Insère le texte spécifié avant la sélection.

insertBefore(text: string): void;

Paramètres

text: string

Texte à insérer.

Retours

void

Remarques

[ Ensemble d’API : WordApiDesktop 1.4 ]

insertCells(shiftCells)

Ajoute des cellules à un tableau existant.

insertCells(shiftCells?: Word.TableCellInsertionLocation): void;

Paramètres

shiftCells: Word.TableCellInsertionLocation

Facultatif. Spécifie comment insérer les cellules dans les colonnes et les lignes existantes du tableau. La valeur par défaut est shiftDown.

Retours

void

Remarques

[ Ensemble d’API : WordApiDesktop 1.4 ]

insertCells(shiftCells)

Ajoute des cellules à un tableau existant.

insertCells(shiftCells?: "ShiftRight" | "ShiftDown" | "ShiftRowDown" | "ShiftColumnRight"): void;

Paramètres

shiftCells: "ShiftRight" | "ShiftDown" | "ShiftRowDown" | "ShiftColumnRight"

insertDateTime(options?: Word.SelectionInsertDateTimeOptions): void;

Paramètres

options: Word.SelectionInsertDateTimeOptions

Facultatif. Options d’insertion de la date ou de l’heure.

Retours

void

Remarques

[ Ensemble d’API : WordApiDesktop 1.4 ]

insertFormula(options)

Insère un champ Formule au niveau de la sélection.

insertFormula(options?: Word.SelectionInsertFormulaOptions): void;

Paramètres

options: Word.SelectionInsertFormulaOptions

insertRowsAbove(numRows: number): void;

Paramètres

numRows: number

Facultatif. Nombre de lignes à insérer.

Retours

void

Remarques

[ Ensemble d’API : WordApiDesktop 1.4 ]

insertRowsBelow(numRows)

Insère des lignes sous la sélection active.

insertRowsBelow(numRows: number): void;

Paramètres

numRows: number

Facultatif. Nombre de lignes à insérer.

Retours

void

Remarques

[ Ensemble d’API : WordApiDesktop 1.4 ]

insertSymbol(characterNumber, options)

Insère un symbole à la place de la sélection spécifiée.

insertSymbol(characterNumber: number, options?: Word.SelectionInsertSymbolOptions): void;

Paramètres

characterNumber: number

Numéro de caractère du symbole.

options: Word.SelectionInsertSymbolOptions

Facultatif. Options d’insertion du symbole.

Retours

void

Remarques

[ Ensemble d’API : WordApiDesktop 1.4 ]

insertText(Text)

Insère le texte spécifié.

insertText(Text: string): void;

Paramètres

Text: string

Texte à insérer.

Retours

void

Remarques

[ Ensemble d’API : WordApiDesktop 1.4 ]

insertXml(xml, transform)

Insère les données XML spécifiées dans le document à l'endroit du curseur, remplaçant ainsi tout texte sélectionné.

insertXml(xml: string, transform?: string): void;

Paramètres

xml: string

Chaîne XML à insérer.

transform: string

Facultatif. Transformation XSL à appliquer.

Retours

void

Remarques

[ Ensemble d’API : WordApiDesktop 1.4 ]

isEqual(range)

Retourne si la sélection est égale à la plage spécifiée.

isEqual(range: Word.Range): OfficeExtension.ClientResult<boolean>;

Paramètres

range: Word.Range

Plage à comparer.

Retours

OfficeExtension.ClientResult<boolean>

true si la sélection est égale à la plage spécifiée.

Remarques

[ Ensemble d’API : WordApiDesktop 1.4 ]

isInRange(range)

Retourne true si la sélection est contenue dans la plage spécifiée.

isInRange(range: Word.Range): OfficeExtension.ClientResult<boolean>;

Paramètres

range: Word.Range

Plage à comparer.

Retours

OfficeExtension.ClientResult<boolean>

true si la sélection est contenue dans la plage spécifiée.

Remarques

[ Ensemble d’API : WordApiDesktop 1.4 ]

isInStory(range)

Retourne si la sélection se trouve dans le même article que la plage spécifiée.

isInStory(range: Word.Range): OfficeExtension.ClientResult<boolean>;

Paramètres

range: Word.Range

Plage à comparer.

Retours

OfficeExtension.ClientResult<boolean>

true si la sélection se trouve dans le même article que la plage spécifiée.

Remarques

[ Ensemble d’API : WordApiDesktop 1.4 ]

load(options)

Files d’attente de la commande pour charger les propriétés de l’objet spécifié. Vous devez contacter context.sync() avant de lire les propriétés.

load(options?: Word.Interfaces.SelectionLoadOptions): Word.Selection;

Paramètres

options: Word.Interfaces.SelectionLoadOptions

Fournit des options pour les propriétés de l’objet à charger.

Retours

Word.Selection

load(propertyNames)

Files d’attente de la commande pour charger les propriétés de l’objet spécifié. Vous devez contacter context.sync() avant de lire les propriétés.

load(propertyNames?: string | string[]): Word.Selection;

Paramètres

propertyNames: string | string[]

Chaîne délimitée par des virgules ou tableau de chaînes qui spécifient les propriétés à charger.

Retours

Word.Selection

load(propertyNamesAndPaths)

Files d’attente de la commande pour charger les propriétés de l’objet spécifié. Vous devez contacter context.sync() avant de lire les propriétés.

load(propertyNamesAndPaths?: {
            select?: string;
            expand?: string;
        }): Word.Selection;

Paramètres

propertyNamesAndPaths: { select?: string; expand?: string; }

propertyNamesAndPaths.select est une chaîne délimitée par des virgules qui spécifie les propriétés à charger, et propertyNamesAndPaths.expand est une chaîne délimitée par des virgules qui spécifie les propriétés de navigation à charger.

Retours

Word.Selection

move(options)

Réduit la sélection à sa position de début ou de fin, puis déplace l’objet réduit selon le nombre d’unités spécifié.

move(options?: Word.SelectionMoveOptions): OfficeExtension.ClientResult<number>;

Paramètres

options: Word.SelectionMoveOptions

Facultatif. Options de déplacement de la sélection.

Retours

OfficeExtension.ClientResult<number>

Nombre de caractères par lesquels la sélection a été déplacée.

Remarques

[ Ensemble d’API : WordApiDesktop 1.4 ]

moveDown(options)

Déplace la sélection vers le bas.

moveDown(options?: Word.SelectionMoveUpDownOptions): OfficeExtension.ClientResult<number>;

Paramètres

options: Word.SelectionMoveUpDownOptions

Facultatif. Options de déplacement vers le bas.

Retours

OfficeExtension.ClientResult<number>

Nombre de caractères par lesquels la sélection a été déplacée.

Remarques

[ Ensemble d’API : WordApiDesktop 1.4 ]

moveEnd(options)

Déplace la position du caractère de fin de la plage ou de la sélection.

moveEnd(options?: Word.SelectionMoveStartEndOptions): OfficeExtension.ClientResult<number>;

Paramètres

options: Word.SelectionMoveStartEndOptions

Facultatif. Options de déplacement de fin.

Retours

OfficeExtension.ClientResult<number>

Nombre de caractères par lesquels la sélection a été déplacée.

Remarques

[ Ensemble d’API : WordApiDesktop 1.4 ]

moveEndUntil(characters, count)

Déplace la position de fin de la sélection jusqu’à ce que l’un des caractères spécifiés soit trouvé dans le document.

moveEndUntil(characters: string, count?: number): OfficeExtension.ClientResult<number>;

Paramètres

characters: string

Caractères à rechercher. Par exemple : Si vous spécifiez « a », la sélection déplace la position de fin à avant le premier caractère « a ».

count: number

Facultatif. Nombre maximal de caractères à rechercher.

Retours

OfficeExtension.ClientResult<number>

Nombre de caractères par lesquels la sélection a été déplacée.

Remarques

[ Ensemble d’API : WordApiDesktop 1.4 ]

moveEndWhile(characters, count)

Déplace la position du caractère de fin de la sélection pendant que l’un des caractères spécifiés est trouvé dans le document.

moveEndWhile(characters: string, count?: number): OfficeExtension.ClientResult<number>;

Paramètres

characters: string

Caractères à rechercher. Par exemple : Si vous spécifiez « abcd », la sélection déplace la position de fin quand une lettre de « abcd » est trouvée.

count: number

Facultatif. Nombre maximal de caractères à rechercher.

Retours

OfficeExtension.ClientResult<number>

Nombre de caractères par lesquels la sélection a été déplacée.

Remarques

[ Ensemble d’API : WordApiDesktop 1.4 ]

moveLeft(options)

Déplace la sélection vers la gauche.

moveLeft(options?: Word.SelectionMoveLeftRightOptions): OfficeExtension.ClientResult<number>;

Paramètres

options: Word.SelectionMoveLeftRightOptions

Facultatif. Options de déplacement vers la gauche.

Retours

OfficeExtension.ClientResult<number>

Nombre de caractères par lesquels la sélection a été déplacée.

Remarques

[ Ensemble d’API : WordApiDesktop 1.4 ]

moveRight(options)

Déplace la sélection vers la droite.

moveRight(options?: Word.SelectionMoveLeftRightOptions): OfficeExtension.ClientResult<number>;

Paramètres

options: Word.SelectionMoveLeftRightOptions

Facultatif. Options de déplacement vers la droite.

Retours

OfficeExtension.ClientResult<number>

Nombre de caractères par lesquels la sélection a été déplacée.

Remarques

[ Ensemble d’API : WordApiDesktop 1.4 ]

moveStart(options)

Déplace la position de début de la sélection.

moveStart(options?: Word.SelectionMoveStartEndOptions): OfficeExtension.ClientResult<number>;

Paramètres

options: Word.SelectionMoveStartEndOptions

Facultatif. Options de l’opération moveStart .

Retours

OfficeExtension.ClientResult<number>

Nombre de caractères par lesquels la sélection a été déplacée.

Remarques

[ Ensemble d’API : WordApiDesktop 1.4 ]

moveStartUntil(characters, count)

Déplace la position de début de la sélection jusqu’à ce que l’un des caractères spécifiés soit trouvé dans le document.

moveStartUntil(characters: string, count?: number): OfficeExtension.ClientResult<number>;

Paramètres

characters: string

Caractères à rechercher. Si vous spécifiez « a », la sélection déplace la position de début avant le premier caractère « a ».

count: number

Facultatif. Nombre maximal de caractères à rechercher.

Retours

OfficeExtension.ClientResult<number>

Nombre de caractères par lesquels la sélection a été déplacée.

Remarques

[ Ensemble d’API : WordApiDesktop 1.4 ]

moveStartWhile(characters, count)

Déplace la position de début de la sélection lorsque l’un des caractères spécifiés est trouvé dans le document.

moveStartWhile(characters: string, count?: number): OfficeExtension.ClientResult<number>;

Paramètres

characters: string

Caractères à rechercher. Par exemple : Si vous spécifiez « abcd », la sélection déplace la position de début quand une lettre de « abcd » est trouvée.

count: number

Facultatif. Nombre maximal de caractères à rechercher.

Retours

OfficeExtension.ClientResult<number>

Nombre de caractères par lesquels la sélection a été déplacée.

Remarques

[ Ensemble d’API : WordApiDesktop 1.4 ]

moveUntil(characters, count)

Déplace la sélection jusqu’à ce que l’un des caractères spécifiés soit trouvé dans le document.

moveUntil(characters: string, count?: number): OfficeExtension.ClientResult<number>;

Paramètres

characters: string

Caractères à rechercher. Par exemple : Si vous spécifiez « a », la sélection se déplace à la position avant le premier caractère « a ».

count: number

Facultatif. Nombre maximal de caractères à rechercher.

Retours

OfficeExtension.ClientResult<number>

Nombre de caractères par lesquels la sélection a été déplacée.

Remarques

[ Ensemble d’API : WordApiDesktop 1.4 ]

moveUp(options)

Déplace la sélection vers le haut.

moveUp(options?: Word.SelectionMoveUpDownOptions): OfficeExtension.ClientResult<number>;

Paramètres

options: Word.SelectionMoveUpDownOptions

Facultatif. Options de déplacement vers le haut.

Retours

OfficeExtension.ClientResult<number>

Nombre de caractères par lesquels la sélection a été déplacée.

Remarques

[ Ensemble d’API : WordApiDesktop 1.4 ]

moveWhile(characters, count)

Déplace la sélection lorsque l’un des caractères spécifiés est trouvé dans le document.

moveWhile(characters: string, count?: number): OfficeExtension.ClientResult<number>;

Paramètres

characters: string

Caractères à rechercher. Par exemple : Si vous spécifiez « abcd », la sélection se déplace à la position quand une lettre de « abcd » est trouvée.

count: number

Facultatif. Nombre maximal de caractères à rechercher.

Retours

OfficeExtension.ClientResult<number>

Nombre de caractères par lesquels la sélection a été déplacée.

Remarques

[ Ensemble d’API : WordApiDesktop 1.4 ]

nextField()

Sélectionne le champ suivant.

nextField(): Word.Field;

Retours

Word.Field

Champ suivant.

Remarques

[ Ensemble d’API : WordApiDesktop 1.4 ]

nextSubdocument()

Déplace la sélection au sous-document suivant.

nextSubdocument(): void;

Retours

void

Remarques

[ Ensemble d’API : WordApiDesktop 1.4 ]

pasteAndFormat(type)

Colle le contenu du Presse-papiers et le met en forme comme spécifié.

pasteAndFormat(type: Word.PasteFormatType): void;

Paramètres

type: Word.PasteFormatType

Type de collage de format pour les cellules du tableau.

Retours

void

Remarques

[ Ensemble d’API : WordApiDesktop 1.4 ]

pasteAndFormat(type)

Colle le contenu du Presse-papiers et le met en forme comme spécifié.

pasteAndFormat(type: "PasteDefault" | "SingleCellText" | "SingleCellTable" | "ListContinueNumbering" | "ListRestartNumbering" | "TableAppendTable" | "TableInsertAsRows" | "TableOriginalFormatting" | "ChartPicture" | "Chart" | "ChartLinked" | "FormatOriginalFormatting" | "FormatSurroundingFormattingWithEmphasis" | "FormatPlainText" | "TableOverwriteCells" | "ListCombineWithExistingList" | "ListDontMerge" | "UseDestinationStylesRecovery"): void;

Paramètres

type: "PasteDefault" | "SingleCellText" | "SingleCellTable" | "ListContinueNumbering" | "ListRestartNumbering" | "TableAppendTable" | "TableInsertAsRows" | "TableOriginalFormatting" | "ChartPicture" | "Chart" | "ChartLinked" | "FormatOriginalFormatting" | "FormatSurroundingFormattingWithEmphasis" | "FormatPlainText" | "TableOverwriteCells" | "ListCombineWithExistingList" | "ListDontMerge" | "UseDestinationStylesRecovery"

Type de collage de format pour les cellules du tableau.

Retours

void

Remarques

[ Ensemble d’API : WordApiDesktop 1.4 ]

pasteExcelTable(linkedToExcel, wordFormatting, rtf)

Colle et met en forme un tableau Microsoft Excel.

pasteExcelTable(linkedToExcel: boolean, wordFormatting: boolean, rtf: boolean): void;

Paramètres

linkedToExcel: boolean

Indique si le tableau est lié à Excel.

wordFormatting: boolean

Indique s’il faut appliquer Word mise en forme.

rtf: boolean

previousField(): Word.Field;

Retours

Word.Field

Champ précédent.

Remarques

[ Ensemble d’API : WordApiDesktop 1.4 ]

previousSubdocument()

Déplace la sélection au sous-document précédent.

previousSubdocument(): void;

Retours

void

Remarques

[ Ensemble d’API : WordApiDesktop 1.4 ]

replaceParagraph()

Remplace la sélection par un nouveau paragraphe.

replaceParagraph(): void;

Retours

void

Remarques

[ Ensemble d’API : WordApiDesktop 1.4 ]

select()

Sélectionne le texte actuel.

select(): void;

Retours

void

Remarques

[ Ensemble d’API : WordApiDesktop 1.4 ]

selectCell()

Sélectionne la cellule entière contenant la sélection actuelle lorsque la sélection se trouve dans un tableau.

selectCell(): void;

Retours

void

Remarques

[ Ensemble d’API : WordApiDesktop 1.4 ]

selectColumn()

Sélectionne la colonne qui contient le point d’insertion ou toutes les colonnes qui contiennent la sélection lorsque la sélection se trouve dans une table.

selectColumn(): void;

Retours

void

Remarques

[ Ensemble d’API : WordApiDesktop 1.4 ]

selectCurrentAlignment()

Cette méthode étend la sélection jusqu'au premier paragraphe ayant un alignement différent.

selectCurrentAlignment(): void;

Retours

void

Remarques

[ Ensemble d’API : WordApiDesktop 1.4 ]

selectCurrentColor()

Cette méthode étend la sélection au premier caractère du texte ayant une couleur différente.

selectCurrentColor(): void;

Retours

void

Remarques

[ Ensemble d’API : WordApiDesktop 1.4 ]

selectCurrentFont()

Cette méthode étend la sélection au premier caractère ayant une police ou une taille différente.

selectCurrentFont(): void;

Retours

void

Remarques

[ Ensemble d’API : WordApiDesktop 1.4 ]

selectCurrentIndent()

Cette méthode étend la sélection au premier paragraphe ayant un retrait à gauche ou à droite différent.

selectCurrentIndent(): void;

Retours

void

Remarques

[ Ensemble d’API : WordApiDesktop 1.4 ]

selectCurrentSpacing()

Cette méthode étend la sélection au premier paragraphe ayant un interligne différent.

selectCurrentSpacing(): void;

Retours

void

Remarques

[ Ensemble d’API : WordApiDesktop 1.4 ]

selectCurrentTabs()

Cette méthode étend la sélection au premier paragraphe ayant des taquets de tabulation différents.

selectCurrentTabs(): void;

Retours

void

Remarques

[ Ensemble d’API : WordApiDesktop 1.4 ]

selectRow()

Sélectionne la ligne qui contient le point d’insertion ou toutes les lignes qui contiennent la sélection lorsque la sélection se trouve dans un tableau.

selectRow(): void;

Retours

void

Remarques

[ Ensemble d’API : WordApiDesktop 1.4 ]

setRange(start, end)

Définit l'emplacement du caractère de début et celui du caractère de fin pour la sélection. Les valeurs de position des caractères commencent au début de l’article, la première valeur étant 0. Tous les caractères sont comptés, y compris les caractères non imprimables. Les caractères masqués sont comptés même s'ils ne sont pas affichés.

setRange(start: number, end: number): void;

Paramètres

start: number

Position du caractère de départ de l’histoire actuelle.

end: number

toJSON(): Word.Interfaces.SelectionData;

Retours

Word.Interfaces.SelectionData

track()

Effectuer le suivi de l’objet pour l’ajustement automatique en fonction environnant des modifications dans le document. Cet appel est un raccourci pour context.trackedObjects.add(thisObject). Si vous utilisez cet objet sur des .sync appels et en dehors de l’exécution séquentielle d’un lot « .run », et que vous obtenez une erreur « InvalidObjectPath » lors de la définition d’une propriété ou de l’appel d’une méthode sur l’objet, vous devez ajouter l’objet à la collection d’objets suivie lors de la première création de l’objet. Si cet objet fait partie d’une collection, vous devez également suivre la collection parente.

track(): Word.Selection;

Retours

Word.Selection

typeBackspace()

Supprime le caractère qui précède la sélection (s’il est réduit) ou le point d’insertion.

typeBackspace(): void;

Retours

void

Remarques

[ Ensemble d’API : WordApiDesktop 1.4 ]

untrack()

Publication mémoire associée à cet objet si elle a été précédemment suivie. Cet appel est abrégé pour context.trackedObjects.remove(thisObject). Vous rencontrez de nombreux objets suivies ralentit l’application hôte, donc n’oubliez pas de libérer les objets que l'on ajoute, une fois que vous avez terminé à les utiliser. Vous devez appeler context.sync() avant que la mise en production de la mémoire ne prenne effet.

untrack(): Word.Selection;

Retours

Word.Selection

Commentaires

Cette page a-t-elle été utile ?

Partager via

Word.Selection class

Remarques

Propriétés

Méthodes

Détails de la propriété

borders

Valeur de propriété

Remarques

characters

Valeur de propriété

Remarques

comments

Valeur de propriété

Remarques

context

Valeur de propriété

end

Valeur de propriété

Remarques

fields

Valeur de propriété

Remarques

fitTextWidth

Valeur de propriété

Remarques

font

Valeur de propriété

Remarques

formattedText

Valeur de propriété

Remarques

hasNoProofing

Valeur de propriété

Remarques

isActive

Valeur de propriété

Remarques

isColumnSelectModeActive

Valeur de propriété

Remarques

isEndOfRowMark

Valeur de propriété

Remarques

isExtendModeActive

Valeur de propriété

Remarques

isInsertionPointAtEndOfLine

Valeur de propriété

Remarques

isStartActive

Valeur de propriété

Remarques

languageDetected

Valeur de propriété

Remarques

languageId

Valeur de propriété

Remarques

languageIdFarEast

Valeur de propriété

Remarques

languageIdOther

Valeur de propriété

Remarques

orientation

Valeur de propriété

Remarques

paragraphs

Valeur de propriété

Remarques

range

Valeur de propriété

Remarques

sections

Valeur de propriété

Remarques

sentences

Valeur de propriété

Remarques