Un objet ISEEditor est une instance de la classe Microsoft.PowerShell.Host.ISE.ISEEditor. Les éditeurs des volets de sortie et de commandes sont des objets ISEEditor. Chaque objet ISEFile a un objet ISEEditor associé. Les sections suivantes répertorient les méthodes et propriétés d'un objet ISEEditor.
Méthodes
Clear()
Efface le texte dans editor.fre
# Clears the text in the Output pane. $psIse.CurrentPowerShellTab.Output.Clear()
EnsureVisible(int lineNumber)
Fait défiler l'éditeur afin que la ligne correspondant au numéro de ligne lineNumber spécifié soit visible. Cette méthode lève une exception si le numéro de ligne lineNumber spécifié n'est pas compris dans l'intervalle (1, numéro de la dernière ligne) qui définit la plage de numéros de ligne valides.
- lineNumber
- Numéro de la ligne qui doit être visible.
# Scrolls the text in the Script Pane so that the fifth line is in view. $psIse.CurrentFile.Editor.EnsureVisible(5)
Focus()
Définit le focus sur l'éditeur.
# Sets focus to the Output pane. $psISE.CurrentPowerShellTab.Output.Focus()
GetLineLength(int lineNumber)
Obtient la longueur (nombre entier) de la ligne spécifiée par lineNumber.
- lineNumber
- Numéro de la ligne dont la longueur doit être obtenue.
- Returns
- Longueur de la ligne spécifiée par lineNumber.
# Gets the length of the first line in the text of the Command pane. $psIse.CurrentPowerShellTab.CommandPane.GetLineLength(1)
InsertText(string text)
Remplace la sélection par le texte ou insère le texte au point d'insertion actuel.
- text
- Texte à insérer.
Consultez Scripting Example plus loin dans cette rubrique.
Select(int startLine, int startColumn, int endLine, int endColumn)
Sélectionne le texte de startLine, startColumn à endLine, endColumn.
- startLine
- Ligne où la sélection commence.
- startColumn
- Colonne de la ligne startLine où la sélection commence.
- endLine
- Ligne où la sélection se termine.
- endColumn
- Colonne de la ligne endLine où la sélection se termine.
Consultez Scripting Example plus loin dans cette rubrique.
SetCaretPosition(int lineNumber, int columnNumber)
Définit la position du point d'insertion sur la ligne lineNumber et à la colonne columnNumber. Lève une exception si le numéro de ligne lineNumber ou le numéro de colonne columnNumber ne sont pas compris dans leurs plages valides respectives.
- lineNumber
- Numéro de ligne du point d'insertion.
- columnNumber
- Numéro de colonne du point d'insertion.
# Set the CaretPosition. $firstfile=$psIse.CurrentFile $firstFile.Editor.SetCaretPosition(5,1)
Propriétés
CaretColumn
Propriété en lecture seule qui obtient le numéro de colonne correspondant à la position du point d'insertion.
# Get the CaretColumn. $firstfile=$psIse.CurrentFile $firstFile.Editor.CaretColumn
CaretLine
Propriété en lecture seule qui obtient le numéro de la ligne qui contient le point d'insertion.
# Get the CaretLine. $firstfile=$psIse.CurrentFile $firstFile.Editor.CaretLine
LineCount
Propriété en lecture seule qui obtient le nombre de lignes de l'éditeur.
# Get the LineCount. $firstfile=$psIse.CurrentFile $firstFile.Editor.LineCount
SelectedText
Propriété en lecture seule qui obtient le texte sélectionné dans l'éditeur.
Consultez Scripting Example plus loin dans cette rubrique.
Text
Propriété en lecture/écriture qui obtient le texte dans l'éditeur.
Consultez Scripting Example 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.
$myfile=$psIse.CurrentFile
# Start with clearing the text in the current file editor.
$myfile.Editor.Clear()
# Make sure the file has at least two lines of text.
$myfile.Editor.InsertText("LINE1 `n")
$myfile.Editor.InsertText("LINE2 `n")
$myfile.Editor.InsertText("LINE3 `n")
$myfile.Editor.InsertText("LINE4 `n")
$myfile.Editor.InsertText("LINE5 `n")
# You can use the GetLineLength method to get the length of the third line.
$endColumn= $myfile.Editor.GetLineLength(3)
# Select the text in the first three lines.
$myfile.Editor.Select(1,1,3,$endColumn + 1)
$selection = $myfile.Editor.SelectedText
# Clear all the text in the editor.
$myfile.Editor.Clear()
# Add the selected text back, but in lower case.
$myFile.Editor.InsertText($selection.ToLower())
Voir aussi