Az ISEEditor objektum

  • Cikk

Az I Standard kiadás Editor-objektum a Microsoft.PowerShell.Host.I Standard kiadás egy példánya. Én Standard kiadás Editor osztály. A Konzol panel egy I Standard kiadás Editor objektum. Minden I Standard kiadás File objektumhoz társított I Standard kiadás Editor-objektum tartozik. Az alábbi szakaszok egy I Standard kiadás Editor-objektum metódusait és tulajdonságait sorolják fel.

Metódusok

Clear()

A Windows PowerShell I Standard kiadás 2.0-s és újabb verzióiban támogatott.

Törli a szöveget a szerkesztőben.

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

EnsureVisible(int lineNumber)

A Windows PowerShell I Standard kiadás 2.0-s és újabb verzióiban támogatott.

Görgeti a szerkesztőt, hogy a megadott lineNumber paraméterértéknek megfelelő sor látható legyen. Kivételt jelent, ha a megadott sorszám kívül esik az 1,utolsó sorszám tartományán, amely meghatározza az érvényes vonalszámokat.

lineNumber A láthatóvá tenni kívánt sor száma.

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

Fókusz()

A Windows PowerShell I Standard kiadás 2.0-s és újabb verzióiban támogatott.

A fókuszt a szerkesztőre állítja.

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

GetLineLength(int lineNumber )

A Windows PowerShell I Standard kiadás 2.0-s és újabb verzióiban támogatott.

A sor hosszát egész számként adja meg a vonalszám által megadott vonalhoz.

lineNumber Annak a vonalnak a száma, amelynek a hosszát le szeretné kapni.

A megadott sorszámnál a vonal hosszát adja vissza.

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

GoToMatch()

A Windows PowerShell I Standard kiadás 3.0-s és újabb verzióiban támogatott, és nem szerepel a korábbi verziókban.

Ha a szerkesztőobjektum $trueCanGoToMatch tulajdonsága közvetlenül a nyitó zárójel, szögletes zárójel vagy zárójel ([előtt van, akkor a simítót az egyező karakterre helyezi át ,{ vagy közvetlenül egy záró zárójel, zárójel vagy zárójel után – ),],}. A simító egy nyitó karakter előtt vagy egy záró karakter után van elhelyezve. Ha a CanGoToMatch tulajdonság az $false, akkor ez a metódus nem tesz semmit.

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

Szöveg beszúrása ( szöveg )

A Windows PowerShell I Standard kiadás 2.0-s és újabb verzióiban támogatott.

Lecseréli a kijelölést szövegre, vagy beszúrja a szöveget az aktuális simító pozícióba.

szöveg – Sztring A beszúrni kívánt szöveg.

Lásd a szkriptelési példát a témakör későbbi részében.

Select( startLine, startColumn, endLine, endColumn )

A Windows PowerShell I Standard kiadás 2.0-s és újabb verzióiban támogatott.

Kijelöli a szöveget a startLine, a startColumn, a endLine és az endColumn paraméterekből.

startLine – Egész szám A kijelölés kezdővonala.

startColumn – Egész szám A kijelölés kezdővonalán belüli oszlop.

endLine – Egész szám A kijelölés végének sora.

endColumn – Egész szám A kijelölés végének oszlopa.

Lásd a szkriptelési példát a témakör későbbi részében.

SelectCaretLine()

A Windows PowerShell I Standard kiadás 2.0-s és újabb verzióiban támogatott.

Kijelöli a teljes szövegsort, amely jelenleg a simítót tartalmazza.

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

A Windows PowerShell I Standard kiadás 2.0-s és újabb verzióiban támogatott.

A sorszámnál és az oszlopszámnál beállítja a simító pozíciót. Kivételt képez, ha a gondozási sor száma vagy a simítóoszlop száma kívül esik a megfelelő érvényes tartományon.

lineNumber – Egész szám: A simítási sor száma.

columnNumber – Egész szám: A gondozott oszlop száma.

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

ToggleOutliningExpansion()

A Windows PowerShell I Standard kiadás 3.0-s és újabb verzióiban támogatott, és nem szerepel a korábbi verziókban.

Az összes szerkezeti szakasz kibontását vagy összecsukását okozza.

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

Tulajdonságok

CanGoToMatch

A Windows PowerShell I Standard kiadás 3.0-s és újabb verzióiban támogatott, és nem szerepel a korábbi verziókban.

Az írásvédett logikai tulajdonság azt jelzi, hogy a simító zárójel, zárójel vagy zárójel mellett van-e – (), []. {} Ha a simító közvetlenül a nyitó karakter előtt vagy közvetlenül egy pár záró karaktere után van, akkor ez a tulajdonság értéke .$true Ellenkező esetben az .$false

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

CaretColumn

A Windows PowerShell I Standard kiadás 2.0-s és újabb verzióiban támogatott.

Az írásvédett tulajdonság, amely a gondviselet helyének megfelelő oszlopszámot kapja.

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

CaretLine

A Windows PowerShell I Standard kiadás 2.0-s és újabb verzióiban támogatott.

Az írásvédett tulajdonság, amely a gondnokot tartalmazó sor számát kapja meg.

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

CaretLineText

A Windows PowerShell I Standard kiadás 2.0-s és újabb verzióiban támogatott.

Az írásvédett tulajdonság, amely lekéri a teljes szövegsort, amely tartalmazza a gondviseletet.

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

LineCount

A Windows PowerShell I Standard kiadás 2.0-s és újabb verzióiban támogatott.

Az írásvédett tulajdonság, amely lekéri a sorok számát a szerkesztőből.

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

Kijelölt szöveg

A Windows PowerShell I Standard kiadás 2.0-s és újabb verzióiban támogatott.

Az írásvédett tulajdonság, amely lekéri a kijelölt szöveget a szerkesztőből.

Lásd a szkriptelési példát a témakör későbbi részében.

Szöveg

A Windows PowerShell I Standard kiadás 2.0-s és újabb verzióiban támogatott.

Az olvasási/írási tulajdonság, amely lekéri vagy beállítja a szöveget a szerkesztőben.

Lásd a szkriptelési példát a témakör későbbi részében.

Példa szkriptelésre

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

Kapcsolódó információk