Partager via

L’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 possède un objet ISEEditor associé. Les sections suivantes listent les méthodes et propriétés d’un objet ISEEditor .

Méthodes

Clear()

Pris en charge sous Windows PowerShell ISE 2.0 et versions ultérieures.

Ça efface le texte dans l’éditeur.

# Clears the text in the Console pane.
$psISE.CurrentPowerShellTab.ConsolePane.Clear()

EnsureVisible(int lineNumber)

Pris en charge sous Windows PowerShell ISE 2.0 et versions ultérieures.

Fait défiler l’éditeur de façon à ce que la ligne correspondant à la valeur spécifiée du paramètre lineNumber soit visible. Il lance une exception si le numéro de ligne spécifié est en dehors de la plage de 1, dernier numéro de ligne, ce qui définit les numéros de ligne valides.

  • Numéro de ligne - Le numéro de la ligne à 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 sous Windows PowerShell ISE 2.0 et versions ultérieures.

Concentre l’attention sur l’éditeur.

# Sets focus to the Console pane.
$psISE.CurrentPowerShellTab.ConsolePane.Focus()

GetLineLength(int lineNumber )

Pris en charge sous Windows PowerShell ISE 2.0 et versions ultérieures.

Obtient la longueur de la ligne en entier pour la droite spécifiée par le numéro de ligne.

  • Numéro de ligne - Le nombre de la ligne dont on obtient la longueur.
  • Retours - La 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 ultérieurs, et absent dans les versions antérieures.

Déplace le caret vers le caractère correspondant si la propriété CanGoToMatch de l’objet éditeur est $true, ce qui se produit lorsque le caret est immédiatement avant une parenthèse d’ouverture, un crochet ou un entretoi

  • (,[,{ - ou juste après une parenthèse, un crochet ou une accolade de clôture - ),],}. Le caret est placé avant un caractère d’ouverture ou après un caractère de clôture. Si la propriété CanGoToMatch est $false, alors cette méthode ne fait rien.
# Goes to the matching character if CanGoToMatch() is $true
$psISE.CurrentPowerShellTab.ConsolePane.GoToMatch()

InsertText( text )

Pris en charge sous Windows PowerShell ISE 2.0 et versions ultérieures.

Remplace la sélection par du texte ou insère du texte à la position actuelle du caret.

  • texte - Chaîne - Le texte à insérer.

Voir l’exemple de scripting plus loin dans ce sujet.

Select( startLine, startColumn, endLine, endColumn )

Pris en charge sous Windows PowerShell ISE 2.0 et versions ultérieures.

Sélectionne le texte des paramètres startLine, startColumn, endLine et endColumn .

  • startLine - Integer - La ligne où commence la sélection.
  • startColumn - Integer - La colonne à l’intérieur de la ligne de départ où commence la sélection.
  • Ligne de fin - Entier - La ligne où la sélection se termine.
  • endColumn - Integer - La colonne à l’intérieur de la ligne de fin où la sélection se termine.

Voir l’exemple de scripting plus loin dans ce sujet.

SelectCaretLine()

Pris en charge sous Windows PowerShell ISE 2.0 et versions ultérieures.

Sélectionne toute la ligne de texte qui contient actuellement le carète.

# 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 sous Windows PowerShell ISE 2.0 et versions ultérieures.

Fixe la position du caret au numéro de ligne et au numéro de colonne. Il fait une exception si le numéro de ligne du caret ou celui de la colonne du caret sont hors de leur plage valide respective.

  • Numéro de ligne - Entier - Le numéro de ligne du caret.
  • colonNumber - Integer - Le numéro de colonne du caret.
# Set the CaretPosition.
$psISE.CurrentFile.Editor.SetCaretPosition(5,1)

ToggleOutliningExpansion()

Pris en charge dans Windows PowerShell ISE 3.0 et ultérieurs, et absent dans les versions antérieures.

Cela fait que toutes les sections de contour se dilatent ou s’effondrent.

# Toggle the outlining expansion
$psISE.CurrentFile.Editor.ToggleOutliningExpansion()

Propriétés

CanGoToMatch

Pris en charge dans Windows PowerShell ISE 3.0 et ultérieurs, et absent dans les versions antérieures.

La propriété booléenne en lecture seule indique si le caret se trouve à côté d’une parenthèse, d’un crochet ou d’un entrecoupelle - (), [], . {} Si le caret est immédiatement avant le caractère d’ouverture ou immédiatement après le caractère de fermeture d’une paire, alors cette valeur de propriété est $true. Dans le cas contraire, il prend la valeur $false.

# Test to see if the caret is next to a parenthesis, bracket, or brace
$psISE.CurrentFile.Editor.CanGoToMatch

ColonneCaretT

Pris en charge sous Windows PowerShell ISE 2.0 et versions ultérieures.

La propriété en lecture seule qui obtient le numéro de colonne correspondant à la position du caratt.

# Get the CaretColumn.
$psISE.CurrentFile.Editor.CaretColumn

CaretLine

Pris en charge sous Windows PowerShell ISE 2.0 et versions ultérieures.

La propriété en lecture seule qui obtient le numéro de la ligne contenant le caratt.

# Get the CaretLine.
$psISE.CurrentFile.Editor.CaretLine

CaretLineText

Pris en charge sous Windows PowerShell ISE 2.0 et versions ultérieures.

La propriété en lecture seule qui obtient la ligne complète de texte contenant le carète.

# Get all of the text on the line that contains the caret.
$psISE.CurrentFile.Editor.CaretLineText

LineCount

Pris en charge sous Windows PowerShell ISE 2.0 et versions ultérieures.

La propriété de lecture seule qui obtient le nombre de lignes de l’éditeur.

# Get the LineCount.
$psISE.CurrentFile.Editor.LineCount

SelectedText

Pris en charge sous Windows PowerShell ISE 2.0 et versions ultérieures.

La propriété en lecture seule qui obtient le texte sélectionné depuis l’éditeur.

Voir l’exemple de scripting plus loin dans ce sujet.

Texto

Pris en charge sous Windows PowerShell ISE 2.0 et versions ultérieures.

La propriété de lecture/écriture qui obtient ou place le texte dans l’éditeur.

Voir l’exemple de scripting plus loin dans ce sujet.

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())

Voir aussi

  • Last updated on