ISEEditor-objektet

  • Artikel

Ett ISEEditor-objekt är en instans av klassen Microsoft.PowerShell.Host.ISE.ISEEditor. Konsolfönstret är ett ISEEditor-objekt . Varje ISEFile-objekt har ett associerat ISEEditor-objekt . I följande avsnitt visas metoderna och egenskaperna för ett ISEEditor-objekt .

Metoder

Clear()

Stöds i Windows PowerShell ISE 2.0 och senare.

Rensar texten i redigeraren.

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

EnsureVisible(int lineNumber)

Stöds i Windows PowerShell ISE 2.0 och senare.

Rullar redigeraren så att raden som motsvarar det angivna lineNumber-parametervärdet visas. Det utlöser ett undantag om det angivna radnumret ligger utanför intervallet 1,sista radnumret, vilket definierar giltiga radnummer.

lineNumber Antalet rader som ska göras synliga.

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

Focus()

Stöds i Windows PowerShell ISE 2.0 och senare.

Ställer in fokus på redigeraren.

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

GetLineLength(int lineNumber )

Stöds i Windows PowerShell ISE 2.0 och senare.

Hämtar radlängden som ett heltal för den rad som anges av radnumret.

lineNumber Numret på den rad som längden ska hämtas för.

Returnerar radlängden för raden vid det angivna radnumret.

# Gets the length of the first line in the text of the Command pane.
$psISE.CurrentPowerShellTab.ConsolePane.GetLineLength(1)

GoToMatch()

Stöds i Windows PowerShell ISE 3.0 och senare och finns inte i tidigare versioner.

Flyttar caret till det matchande tecknet om egenskapen CanGoToMatch för redigeringsobjektet är $true, vilket inträffar när caret är omedelbart före en inledande parentes, hakparentes eller klammerparentes - (,[,{ - eller omedelbart efter en avslutande parentes, hakparentes eller klammerparentes - ),],}. Caret placeras före ett inledande tecken eller efter ett avslutande tecken. Om egenskapen CanGoToMatch är $falsegör den här metoden ingenting.

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

InsertText( text )

Stöds i Windows PowerShell ISE 2.0 och senare.

Ersätter markeringen med text eller infogar text vid aktuell position.

text – Sträng Texten som ska infogas.

Se skriptexemplet senare i det här avsnittet.

Select( startLine, startColumn, endLine, endColumn )

Stöds i Windows PowerShell ISE 2.0 och senare.

Markerar texten från parametrarna startLine, startColumn, endLine och endColumn.

startLine – Heltal Raden där markeringen startar.

startColumn – Heltal Kolumnen på startraden där markeringen startar.

endLine – Heltal Raden där markeringen slutar.

endColumn – Heltal Kolumnen på slutlinjen där markeringen slutar.

Se skriptexemplet senare i det här avsnittet.

SelectCaretLine()

Stöds i Windows PowerShell ISE 2.0 och senare.

Markerar hela textraden som för närvarande innehåller caret.

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

Stöds i Windows PowerShell ISE 2.0 och senare.

Anger caret-positionen vid radnumret och kolumnnumret. Det utlöser ett undantag om antingen caret-radnumret eller det vårdade kolumnnumret ligger utom deras respektive giltiga intervall.

lineNumber – Heltal Det vårdande radnumret.

columnNumber – Heltal Det vårdande kolumnnumret.

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

VäxlaOutliningExpansion()

Stöds i Windows PowerShell ISE 3.0 och senare och finns inte i tidigare versioner.

Gör att alla dispositionsavsnitt expanderas eller döljs.

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

Egenskaper

CanGoToMatch

Stöds i Windows PowerShell ISE 3.0 och senare och finns inte i tidigare versioner.

Den skrivskyddade booleska egenskapen för att ange om vården ligger bredvid en parentes, hakparentes eller klammerparentes - (), [], {}. Om caret är omedelbart före det inledande tecknet eller omedelbart efter ett pars avslutande tecken är $truedet här egenskapsvärdet . Annars är $falsedet .

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

CaretColumn

Stöds i Windows PowerShell ISE 2.0 och senare.

Den skrivskyddade egenskapen som hämtar kolumnnumret som motsvarar caretens position.

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

CaretLine

Stöds i Windows PowerShell ISE 2.0 och senare.

Den skrivskyddade egenskapen som hämtar numret på raden som innehåller caret.

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

CaretLineText

Stöds i Windows PowerShell ISE 2.0 och senare.

Den skrivskyddade egenskapen som hämtar den fullständiga textraden som innehåller caret.

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

LineCount

Stöds i Windows PowerShell ISE 2.0 och senare.

Den skrivskyddade egenskapen som hämtar radantalet från redigeraren.

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

SelectedText

Stöds i Windows PowerShell ISE 2.0 och senare.

Den skrivskyddade egenskapen som hämtar den markerade texten från redigeraren.

Se skriptexemplet senare i det här avsnittet.

Text

Stöds i Windows PowerShell ISE 2.0 och senare.

Den läs-/skrivegenskap som hämtar eller anger texten i redigeraren.

Se skriptexemplet senare i det här avsnittet.

Skriptexempel

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

Se även