Objekt ISEEditor

  • Článek

Objekt ISEEditor je instance třídy Microsoft.PowerShell.Host.ISE.ISEEditor. Podokno konzoly je objekt ISEEditor . Každý objekt ISEFile má přidružený objekt ISEEditor . V následujících částech jsou uvedeny metody a vlastnosti ISEEditor objektu.

Metody

Clear()

Podporováno v prostředí Windows PowerShell ISE 2.0 a novějším.

Vymaže text v editoru.

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

EnsureVisible(int lineNumber)

Podporováno v prostředí Windows PowerShell ISE 2.0 a novějším.

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

lineNumber Číslo řádku, který má být zobrazen.

# Scrolls the text in the Script pane so that the fifth line is in view.
$psISE.CurrentFile.Editor.EnsureVisible(5)

Focus()

Podporováno v prostředí Windows PowerShell ISE 2.0 a novějším.

Nastaví fokus na editor.

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

GetLineLength(int lineNumber)

Podporováno v prostředí Windows PowerShell ISE 2.0 a novějším.

Získá délku řádku jako celé číslo pro řádek, který je určen číslem řádku.

lineNumber Číslo řádku, jehož délka se získá.

Vrátí délku řádku řádku na zadané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 v prostředí Windows PowerShell ISE 3.0 a novějších verzích a není k dispozici v dřívějších verzích.

Přesune stříšku na odpovídající znak, pokud CanGoToMatch vlastnost objektu editoru je $true, což nastane, když stříška je bezprostředně před levou závorkou, závorkou nebo složenou závorkou - (,[,{ - nebo bezprostředně za pravou závorkou, závorkou nebo složenou závorkou - ),],}. Stříšku se umístí před levý znak nebo za uzavírací znak. Pokud CanGoToMatch vlastnost je $false, pak tato metoda nic nedělá.

# Goes to the matching character if CanGoToMatch() is $true
$psISE.CurrentPowerShellTab.ConsolePane.GoToMatch()

InsertText( text )

Podporováno v prostředí Windows PowerShell ISE 2.0 a novějším.

Nahradí výběr textem nebo vloží text na aktuální pozici kurzoru.

text – Řetězec: Text, který chcete vložit.

Podívejte se na příklad skriptování dále v tomto tématu.

Select( startLine, startColumn, endLine, endColumn )

Podporováno v prostředí Windows PowerShell ISE 2.0 a novějším.

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

startLine - Celé číslo Řádek, kde výběr začíná.

startColumn - Celé číslo Sloupec v počátečním řádku, kde začíná výběr.

endLine - Celé číslo Řádek, kde výběr končí.

endColumn - Celé číslo Sloupec v rámci koncového řádku, kde výběr končí.

Podívejte se na příklad skriptování dále v tomto tématu.

SelectCaretLine()

Podporováno v prostředí Windows PowerShell ISE 2.0 a novějším.

Vybere celý řádek textu, který aktuálně obsahuje stříšku.

# 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 v prostředí Windows PowerShell ISE 2.0 a novějším.

Nastaví pozici kurzoru na číslo řádku a číslo sloupce. Vyvolá výjimku, pokud číslo řádku stříšky nebo číslo stříšky nejsou z příslušných platných oblastí.

lineNumber – celé číslo stříšky.

columnNumber – celé číslo stříšku.

# Set the CaretPosition.
$psISE.CurrentFile.Editor.SetCaretPosition(5,1)

ToggleOutliningExpansion()

Podporováno v prostředí Windows PowerShell ISE 3.0 a novějších verzích a není k dispozici v dřívějších verzích.

Způsobí rozbalení nebo sbalení všech oddílů osnovy.

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

Vlastnosti

CanGoToMatch

Podporováno v prostředí Windows PowerShell ISE 3.0 a novějších verzích a není k dispozici v dřívějších verzích.

Logická vlastnost jen pro čtení označující, zda je stříška vedle závorky, závorky nebo závorky - (), {}[]. Pokud je stříška bezprostředně před levým znakem nebo bezprostředně za uzavíracím znakem páru, je $truetato hodnota vlastnosti . Jinak je $falseto .

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

CaretColumn

Podporováno v prostředí Windows PowerShell ISE 2.0 a novějším.

Vlastnost jen pro čtení, která získá číslo sloupce odpovídající pozici stříšky.

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

Stříškové čáry

Podporováno v prostředí Windows PowerShell ISE 2.0 a novějším.

Vlastnost jen pro čtení, která získá číslo řádku, který obsahuje stříšku.

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

CaretLineText

Podporováno v prostředí Windows PowerShell ISE 2.0 a novějším.

Vlastnost jen pro čtení, která získá úplný řádek textu, který obsahuje stříšku.

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

LineCount

Podporováno v prostředí Windows PowerShell ISE 2.0 a novějším.

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

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

SelectedText

Podporováno v prostředí Windows PowerShell ISE 2.0 a novějším.

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

Podívejte se na příklad skriptování dále v tomto tématu.

Text

Podporováno v prostředí Windows PowerShell ISE 2.0 a novějším.

Vlastnost pro čtení a zápis, která získá nebo nastaví text v editoru.

Podívejte se na příklad skriptování dále 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é