Sdílet prostřednictvím

Objekt ISEEditor

Objekt ISEEditor je instance třídy Microsoft.PowerShell.Host.ISE.ISEEditor. Panel Console je objekt ISEEditor . Každý objekt ISEFile má přiřazený objekt ISEEditor . Následující sekce uvádějí metody a vlastnosti objektu ISEEditor .

Methods

Clear()

Podporováno ve Windows PowerShell ISE 2.0 a novějších.

Vymaže text v editoru.

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

EnsureVisible(int lineNumber)

Podporováno ve Windows PowerShell ISE 2.0 a novějších.

Posouvá editor tak, aby byl viditelný řádek odpovídající zadané hodnotě parametru lineNumber . Vyhodí výjimku, pokud je zadané číslo řádku mimo rozsah 1, posledního řádku, který definuje platná čísla řádků.

  • LineNumber – Číslo řádku, který má být viditelný.
# Scrolls the text in the Script pane so that the fifth line is in view.
$psISE.CurrentFile.Editor.EnsureVisible(5)

Focus()

Podporováno ve Windows PowerShell ISE 2.0 a novějších.

Zaměřuje se na editora.

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

GetLineLength(int lineNumber )

Podporováno ve Windows PowerShell ISE 2.0 a novějších.

Délka řádku je celá pro čáru určenou číslem řádku.

  • lineNumber – Číslo řádku, jehož délka je určena.
  • Returns – Délka řádku na určeném čísle řádku.
# Gets the length of the first line in the text of the Command pane.
$psISE.CurrentPowerShellTab.ConsolePane.GetLineLength(1)

GoToMatch()

Podporováno ve Windows PowerShell ISE 3.0 a novějších, a v dřívějších verzích nebylo.

Přesune kurzor na odpovídající znak, pokud je vlastností CanGoToMatch objektu $trueeditoru , což nastává, když je kurzor těsně před úvodní závorkou, závorkou nebo závorkou

  • (,[, -{ nebo ihned po závorce, závorce či závorce - ),],.} Kurzor se umisťuje před úvodní znak nebo za závěrečný znak. Pokud je vlastnost CanGoToMatch , $falsepak tato metoda nic nedělá.
# Goes to the matching character if CanGoToMatch() is $true
$psISE.CurrentPowerShellTab.ConsolePane.GoToMatch()

InsertText( text )

Podporováno ve Windows PowerShell ISE 2.0 a novějších.

Nahrazuje výběr textem nebo vkládá text na aktuální pozici kurzora.

  • text - Řetězec - Text, který se má vložit.

Viz příklad skriptování později v tomto tématu.

Select( startLine, startColumn, endLine, endColumn )

Podporováno ve Windows PowerShell ISE 2.0 a novějších.

Vybere text z parametrů startLine, startColumn, endLine a endColumn .

  • startLine - Celé číslo - Čára, kde začíná výběr.
  • startColumn - Integer - Sloupec uvnitř začátku, kde výběr začíná.
  • endLine - Celé číslo - Čára, kde výběr končí.
  • endColumn - Integer - Sloupec uvnitř koncové řádky, kde výběr končí.

Viz příklad skriptování později v tomto tématu.

SelectCaretLine()

Podporováno ve Windows PowerShell ISE 2.0 a novějších.

Vybere celý řádek textu, který aktuálně obsahuje kurzor.

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

Podporováno ve Windows PowerShell ISE 2.0 a novějších.

Nastaví pozici karétu na číslo řádku a číslo sloupce. Vyhodí výjimku, pokud buď číslo čáry kurzovy, nebo číslo sloupce kurzourů jsou mimo své platné rozsahy.

  • Číslo řádku - Celé číslo - Číslo čáry karatu.
  • columnNumber - Celé číslo - Číslo sloupce kurzouru.
# Set the CaretPosition.
$psISE.CurrentFile.Editor.SetCaretPosition(5,1)

ToggleOutliningExpansion()

Podporováno ve Windows PowerShell ISE 3.0 a novějších, a v dřívějších verzích nebylo.

Způsobí, že se všechny obrysové sekce rozšíří nebo zhroutí.

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

Vlastnosti

CanGoToMatch

Podporováno ve Windows PowerShell ISE 3.0 a novějších, a v dřívějších verzích nebylo.

Booleovská vlastnost pouze pro čtení, která označuje, zda je karet vedle závorky, závorky nebo závorky - (), [], . {} Pokud je karet bezprostředně před úvodním znakem nebo bezprostředně za uzavíracím znakem páru, pak hodnota této vlastnosti je $true. Jinak je to $false.

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

CaretColumn

Podporováno ve Windows PowerShell ISE 2.0 a novějších.

Vlastnost pouze pro čtení, která získává číslo sloupce odpovídající pozici karatu.

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

CaretLine

Podporováno ve Windows PowerShell ISE 2.0 a novějších.

Vlastnost pouze pro čtení, která získává číslo řádku obsahujícího karet.

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

CaretLineText

Podporováno ve Windows PowerShell ISE 2.0 a novějších.

Vlastnost pouze pro čtení, která získává celý řádek textu obsahující kurzor.

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

LineCount

Podporováno ve Windows PowerShell ISE 2.0 a novějších.

Vlastnost pouze pro čtení, která získává počet řádků z editoru.

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

SelectedText

Podporováno ve Windows PowerShell ISE 2.0 a novějších.

Vlastnost pouze pro čtení, která získává vybraný text z editoru.

Viz příklad skriptování později v tomto tématu.

Text

Podporováno ve Windows PowerShell ISE 2.0 a novějších.

Vlastnost čtení/zápis, která získává nebo nastavuje text v editoru.

Viz příklad skriptování později v tomto tématu.

Příklad skriptování

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

Viz také

  • Last updated on