Objet ISEEditor
Un objet ISEEditor est une instance de la classe Microsoft.PowerShell.Host.ISE.ISEEditor. Le volet Console est un objet ISEEditor. Chaque objet ISEFile a un objet ISEEditor associé. Les sections suivantes répertorient les méthodes et les propriétés d’un objet ISEEditor.
Méthode
Clear()
Pris en charge dans Windows PowerShell ISE 2.0 et versions ultérieures.
Efface le texte dans l’éditeur.
# Clears the text in the Console pane.
$psISE.CurrentPowerShellTab.ConsolePane.Clear()
EnsureVisible(int lineNumber)
Pris en charge dans Windows PowerShell ISE 2.0 et versions ultérieures.
Fait défiler l’éditeur pour que la ligne correspondant à la valeur de paramètre lineNumber spécifiée soit visible. Elle lève une exception si le numéro de ligne spécifié est en dehors de la plage de 1,dernier numéro de ligne, qui définit les numéros de ligne valides.
lineNumber Le nombre de lignes à rendre visible.
# Scrolls the text in the Script pane so that the fifth line is in view.
$psISE.CurrentFile.Editor.EnsureVisible(5)
Focus()
Pris en charge dans Windows PowerShell ISE 2.0 et versions ultérieures.
Définit le focus sur l’éditeur.
# Sets focus to the Console pane.
$psISE.CurrentPowerShellTab.ConsolePane.Focus()
GetLineLength(int lineNumber )
Pris en charge dans Windows PowerShell ISE 2.0 et versions ultérieures.
Obtient la longueur de ligne sous forme d’entier pour la ligne spécifiée par le numéro de ligne.
lineNumber Nombre de lignes dont la longueur doit être obtenue.
Renvoie Longueur de ligne de la ligne au numéro de ligne spécifié.
# Gets the length of the first line in the text of the Command pane.
$psISE.CurrentPowerShellTab.ConsolePane.GetLineLength(1)
GoToMatch()
Pris en charge dans Windows PowerShell ISE 3.0 et versions ultérieures, et non présents dans les versions antérieures.
Déplace le pointeur vers le caractère correspondant si la propriété CanGoToMatch de l’objet éditeur est $true, qui se produit lorsque le caret est immédiatement avant une parenthèse ouvrante, crochet ou accolades - (,[,{ - ou immédiatement après une parenthèse fermante, crochet ou accolades - ),],}. Le pointeur est placé avant un caractère ouvrant ou après un caractère fermant. Si la propriété CanGoToMatch est $false, cette méthode ne fait rien.
# Goes to the matching character if CanGoToMatch() is $true
$psISE.CurrentPowerShellTab.ConsolePane.GoToMatch()
InsertText( text )
Pris en charge dans Windows PowerShell ISE 2.0 et versions ultérieures.
Remplace la sélection par du texte ou insère du texte à la position de point d’insertion actuelle.
texte - Chaîner le texte à insérer.
Consultez l’exemple de script plus loin dans cette rubrique.
Select( startLine, startColumn, endLine, endColumn )
Pris en charge dans Windows PowerShell ISE 2.0 et versions ultérieures.
Sélectionne le texte dans les paramètres startLine, startColumn, endLineet paramètres de endColumn.
startLine - Entier La ligne où commence la sélection.
startColumn - Entier La colonne dans la ligne de début où commence la sélection.
endLine - Entier La ligne où se termine la sélection.
endColumn - Entier La colonne dans la ligne de fin où se termine la sélection.
Consultez l’exemple de script plus loin dans cette rubrique.
SelectCaretLine()
Pris en charge dans Windows PowerShell ISE 2.0 et versions ultérieures.
Sélectionne la ligne de texte entière qui contient actuellement le trait d’insertion.
# First, set the caret position on line 5.
$psISE.CurrentFile.Editor.SetCaretPosition(5,1)
# Now select that entire line of text
$psISE.CurrentFile.Editor.SelectCaretLine()
SetCaretPosition( lineNumber, columnNumber )
Pris en charge dans Windows PowerShell ISE 2.0 et versions ultérieures.
Définit la position d’insertion au niveau du numéro de ligne et du numéro de colonne. Elle lève une exception si le numéro de ligne d’insertion ou le numéro de colonne d’insertion sont hors de leurs plages valides respectives.
lineNumber - Entier Le numéro de ligne d’insertion.
columnNumber - Entier Le numéro de colonne d’insertion.
# Set the CaretPosition.
$psISE.CurrentFile.Editor.SetCaretPosition(5,1)
ToggleOutliningExpansion()
Pris en charge dans Windows PowerShell ISE 3.0 et versions ultérieures, et non présents dans les versions antérieures.
Provoque l’expansion ou la réduction de toutes les sections hiérarchiques.
# Toggle the outlining expansion
$psISE.CurrentFile.Editor.ToggleOutliningExpansion()
Propriétés
CanGoToMatch
Pris en charge dans Windows PowerShell ISE 3.0 et versions ultérieures, et non présents dans les versions antérieures.
Propriété booléenne en lecture seule pour indiquer si le caret est en regard d’une parenthèse, d’un crochet ou d’une accolade - (), [], {}. Si le pointage est immédiatement avant le caractère ouvrant ou immédiatement après le caractère fermant d’une paire, cette valeur de propriété est $true. Sinon, il est $false.
# Test to see if the caret is next to a parenthesis, bracket, or brace
$psISE.CurrentFile.Editor.CanGoToMatch
CaretColumn
Pris en charge dans Windows PowerShell ISE 2.0 et versions ultérieures.
Propriété en lecture seule qui obtient le numéro de colonne qui correspond à la position du point d’insertion.
# Get the CaretColumn.
$psISE.CurrentFile.Editor.CaretColumn
CaretLine
Pris en charge dans Windows PowerShell ISE 2.0 et versions ultérieures.
Propriété en lecture seule qui obtient le numéro de la ligne qui contient la touche.
# Get the CaretLine.
$psISE.CurrentFile.Editor.CaretLine
CaretLineText
Pris en charge dans Windows PowerShell ISE 2.0 et versions ultérieures.
Propriété en lecture seule qui obtient la ligne de texte complète qui contient le trait d’insertion.
# Get all of the text on the line that contains the caret.
$psISE.CurrentFile.Editor.CaretLineText
LineCount
Pris en charge dans Windows PowerShell ISE 2.0 et versions ultérieures.
Propriété en lecture seule qui obtient le nombre de lignes de l’éditeur.
# Get the LineCount.
$psISE.CurrentFile.Editor.LineCount
SelectedText
Pris en charge dans Windows PowerShell ISE 2.0 et versions ultérieures.
Propriété en lecture seule qui obtient le texte sélectionné de l’éditeur.
Consultez l’exemple de script plus loin dans cette rubrique.
SMS
Pris en charge dans Windows PowerShell ISE 2.0 et versions ultérieures.
Propriété en lecture/écriture qui obtient ou définit le texte dans l’éditeur.
Consultez l’exemple de script plus loin dans cette rubrique.
Exemple de script
# This illustrates how you can use the length of a line to
# select the entire line and shows how you can make it lowercase.
# You must run this in the Console pane. It will not run in the Script pane.
# Begin by getting a variable that points to the editor.
$myEditor = $psISE.CurrentFile.Editor
# Clear the text in the current file editor.
$myEditor.Clear()
# Make sure the file has five lines of text.
$myEditor.InsertText("LINE1 `n")
$myEditor.InsertText("LINE2 `n")
$myEditor.InsertText("LINE3 `n")
$myEditor.InsertText("LINE4 `n")
$myEditor.InsertText("LINE5 `n")
# Use the GetLineLength method to get the length of the third line.
$endColumn = $myEditor.GetLineLength(3)
# Select the text in the first three lines.
$myEditor.Select(1, 1, 3, $endColumn + 1)
$selection = $myEditor.SelectedText
# Clear all the text in the editor.
$myEditor.Clear()
# Add the selected text back, but in lower case.
$myEditor.InsertText($selection.ToLower())
