Objek ISEEditor

  • Artikel

Objek ISEEditor adalah instans kelas Microsoft.PowerShell.Host.ISE.ISEEditor. Panel Konsol adalah objek ISEEditor . Setiap objek ISEFile memiliki objek ISEEditor terkait. Bagian berikut mencantumkan metode dan properti objek ISEEditor .

Metode

Clear()

Didukung di Windows PowerShell ISE 2.0 dan yang lebih baru.

Menghapus teks di editor.

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

EnsureVisible(int lineNumber)

Didukung di Windows PowerShell ISE 2.0 dan yang lebih baru.

Menggulir editor sehingga baris yang sesuai dengan nilai parameter lineNumber yang ditentukan terlihat. Ini melemparkan pengecualian jika nomor baris yang ditentukan berada di luar rentang 1,nomor baris terakhir, yang menentukan nomor baris yang valid.

lineNumber Jumlah baris yang akan dibuat terlihat.

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

Fokus()

Didukung di Windows PowerShell ISE 2.0 dan yang lebih baru.

Mengatur fokus ke editor.

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

GetLineLength(int lineNumber )

Didukung di Windows PowerShell ISE 2.0 dan yang lebih baru.

Mendapatkan panjang garis sebagai bilangan bulat untuk baris yang ditentukan oleh nomor baris.

lineNumber Jumlah baris yang akan mendapatkan panjangnya.

Mengembalikan Panjang baris untuk baris pada nomor baris yang ditentukan.

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

GoToMatch()

Didukung di Windows PowerShell ISE 3.0 dan yang lebih baru, dan tidak ada di versi sebelumnya.

Memindahkan tanda sisipan ke karakter yang cocok jika properti CanGoToMatch dari objek editor adalah $true, yang terjadi ketika tanda sisipan segera sebelum tanda kurung buka, kurung, atau kurung kurawal - (,[,{ - atau segera setelah kurung tutup, tanda kurung, atau kurung kurung - ),],}. Tanda sisipan ditempatkan sebelum karakter pembuka atau setelah karakter penutup. Jika properti CanGoToMatch adalah $false, maka metode ini tidak melakukan apa pun.

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

InsertText( text )

Didukung di Windows PowerShell ISE 2.0 dan yang lebih baru.

Mengganti pilihan dengan teks atau menyisipkan teks pada posisi tanda sisipan saat ini.

text - String Teks yang akan disisipkan.

Lihat Contoh Pembuatan Skrip nanti dalam topik ini.

Pilih( startLine, startColumn, endLine, endColumn )

Didukung di Windows PowerShell ISE 2.0 dan yang lebih baru.

Memilih teks dari parameter startLine, startColumn, endLine, dan endColumn .

startLine - Bilangan Bulat Baris tempat pemilihan dimulai.

startColumn - Bilangan bulat Kolom dalam baris mulai tempat pemilihan dimulai.

endLine - Bilangan bulat Baris tempat pilihan berakhir.

endColumn - Bilangan bulat Kolom di dalam baris akhir tempat pilihan berakhir.

Lihat Contoh Pembuatan Skrip nanti dalam topik ini.

PilihCaretLine()

Didukung di Windows PowerShell ISE 2.0 dan yang lebih baru.

Memilih seluruh baris teks yang saat ini berisi tanda sisipan.

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

Didukung di Windows PowerShell ISE 2.0 dan yang lebih baru.

Mengatur posisi tanda sisipan pada nomor baris dan nomor kolom. Ini melemparkan pengecualian jika nomor baris tanda sisipan atau nomor kolom tanda sisipan berada di luar rentang valid masing-masing.

lineNumber - Bilangan bulat Nomor baris tanda sisipan.

columnNumber - Bilangan bulat Nomor kolom tanda sisipan.

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

ToggleOutliningExpansion()

Didukung di Windows PowerShell ISE 3.0 dan yang lebih baru, dan tidak ada di versi sebelumnya.

Menyebabkan semua bagian kerangka diperluas atau diciutkan.

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

Properti

CanGoToMatch

Didukung di Windows PowerShell ISE 3.0 dan yang lebih baru, dan tidak ada di versi sebelumnya.

Properti Boolean baca-saja untuk menunjukkan apakah tanda sisipan berada di samping tanda kurung, kurung siku, atau kurung kurawal - (), , []{}. Jika tanda sisipan segera sebelum karakter pembuka atau segera setelah karakter penutup pasangan, maka nilai properti ini adalah $true. Jika tidak, ini adalah $false.

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

CaretColumn

Didukung di Windows PowerShell ISE 2.0 dan yang lebih baru.

Properti baca-saja yang mendapatkan nomor kolom yang sesuai dengan posisi tanda sisipan.

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

Garis Karier

Didukung di Windows PowerShell ISE 2.0 dan yang lebih baru.

Properti baca-saja yang mendapatkan jumlah baris yang berisi tanda sisipan.

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

CaretLineText

Didukung di Windows PowerShell ISE 2.0 dan yang lebih baru.

Properti baca-saja yang mendapatkan baris lengkap teks yang berisi tanda sisipan.

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

LineCount

Didukung di Windows PowerShell ISE 2.0 dan yang lebih baru.

Properti baca-saja yang mendapatkan jumlah baris dari editor.

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

Teks Terpilih

Didukung di Windows PowerShell ISE 2.0 dan yang lebih baru.

Properti baca-saja yang mendapatkan teks yang dipilih dari editor.

Lihat Contoh Pembuatan Skrip nanti dalam topik ini.

Teks

Didukung di Windows PowerShell ISE 2.0 dan yang lebih baru.

Properti baca/tulis yang mendapatkan atau mengatur teks di editor.

Lihat Contoh Pembuatan Skrip nanti dalam topik ini.

Contoh Pembuatan Skrip

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

Lihat Juga