Объект Options представляет различные параметры Windows PowerShell ISE. Он является экземпляром класса Microsoft.PowerShell.Host.ISE.ISEOptions.

Методы

RestoreDefaultTokenColors()

Восстанавливает значения по умолчанию для цветов токенов.

# Changes the color of the comments in the script to red and then restores it to its default value.
$psISE.Options.TokenColors["Comment"]="red"
$psISE.Options.RestoreDefaultTokenColors()

RestoreDefaults()

Восстанавливает значения по умолчанию для всех параметров. Также сбрасывает поведение различных предупреждений, для которых имеется стандартный флажок "Не выводить это сообщение в дальнейшем".

# Changes the background color in the Command Pane and then restores it to its default value.
$psISE.Options.CommandPaneBackground = "orange"
$psISE.Options.RestoreDefaults()

Свойства

CommandPaneBackgroundColor

Это свойство доступно для чтения и записи. Оно возвращает или задает цвет фона редактора области команд. Оно является экземпляром класса System.Windows.Media.Color.

# Changes the background color of the Command Pane to orange. 
$psISE.Options.CommandPaneBackground = "orange"

CommandPaneUp

Это свойство доступно для чтения и записи. Оно возвращает или задает логическое значение, показывающее, расположена ли область команд над областью вывода.

# Moves the Command Pane to the top of the screen.
$psISE.Options.CommandPaneUp  = $true

DebugBackgroundColor

Это свойство доступно для чтения и записи. Оно возвращает или задает цвет фона текста сообщений для отладки в области вывода. Оно является экземпляром класса System.Windows.Media.Color.

# Changes the background color for the debug text that appears in the Output Pane to blue. 
$psISE.Options.DebugBackgroundColor ='#0000FF'

DebugForegroundColor

Это свойство доступно для чтения и записи. Оно возвращает или задает цвет переднего плана текста сообщений для отладки в области вывода. Оно является экземпляром класса System.Windows.Media.Color.

# Changes the foreground color for the debug text that appears in the Output Pane to yellow. 
$psISE.Options.DebugForegroundColor =”yellow”

DefaultOptions

Это свойство доступно только для чтения. Оно возвращает значения по умолчанию для параметров.

# Displays the name of the default options. 
$psISE.Options.DefaultOptions

# Here is a typical listing of the default options:
SelectedScriptPaneState	 : Right
ShowToolBar				 : True
TokenColors				 : {[Attribute, #FFADD8E6], [Command, #FF0000FF], [Com
								mandArgument, #FF8A2BE2], [CommandParameter, #FF000
								080]...}
DefaultOptions				: Microsoft.PowerShell.Host.ISE.ISEOptions
FontSize					: 12
FontName					: Lucida Console
ErrorForegroundColor		: #FF0000FF
ErrorBackgroundColor		: #00FFFFFF
WarningForegroundColor		: #FFFF8C00
WarningBackgroundColor		: #00FFFFFF
VerboseForegroundColor		: #FF0000FF
VerboseBackgroundColor		: #00FFFFFF
DebugForegroundColor		: #FF0000FF
DebugBackgroundColor		: #00FFFFFF
OutputPaneBackgroundColor	 : #FFF0F8FF
OutputPaneTextBackgroundColor : #FFF0F8FF
OutputPaneForegroundColor	 : #FF000000
CommandPaneBackgroundColor	: #FFFFFFFF
ScriptPaneBackgroundColor	 : #FFFFFFFF
ShowWarningForDuplicateFiles  : True
ShowWarningBeforeSavingOnRun  : True
UseLocalHelp				: True
CommandPaneUp				 : False

ErrorBackgroundColor

Это свойство доступно для чтения и записи. Оно возвращает или задает цвет фона текста сообщений об ошибках в области вывода. Оно является экземпляром класса System.Windows.Media.Color.

# Changes the background color for the error text that appears in the Output Pane to black. 
$psISE.Options.ErrorBackgroundColor="black"

ErrorForegroundColor

Это свойство доступно для чтения и записи. Оно возвращает или задает цвет переднего плана текста сообщений об ошибках в области вывода. Оно является экземпляром класса System.Windows.Media.Color.

# Changes the foreground color for the error text that appears in the Output Pane to green. 
$psISE.Options.ErrorForegroundColor =”green”

FontName

Это свойство доступно для чтения и записи. Оно возвращает или задает имя шрифта, используемого в областях скриптов, команд и вывода.

# Changes the font used in all the panes. 
$psISE.Options.FontName = "courier new"

FontSize

Это свойство доступно для чтения и записи. Оно возвращает или задает целочисленный размер шрифта, используемого в областях скриптов, команд и вывода. Допустимый диапазон значений: (8, 32).

# Changes the font size in all the panes.
$psISE.Options.FontSize = 20

OutputPaneBackgroundColor

Это свойство доступно для чтения и записи. Оно возвращает или задает цвет фона области вывода. Оно является экземпляром класса System.Windows.Media.Color.

# Changes the background color of the Output Pane to gold. 
$psISE.Options.OutputPaneForegroundColor = "gold"

OutputPaneTextForegroundColor

Это свойство доступно для чтения и записи. Оно изменяет цвет переднего плана текста в области вывода.

# Changes the foreground color of the text in the Output Pane to blue.
$psISE.Options.OutputPaneTextForegroundColor  = "blue"

OutputPaneTextBackgroundColor

Это свойство доступно для чтения и записи. Оно изменяет цвет фона текста в области вывода.

# Changes the background color of the Output Pane text to pink. 
$psISE.Options.OutputPaneTextBackgroundColor = "pink"

ScriptPaneBackgroundColor

Это свойство доступно для чтения и записи. Оно возвращает или задает цвет фона для файлов. Оно является экземпляром класса System.Windows.Media.Color.

 
# Sets the color of the script pane background to yellow.
$psISE.Options.ScriptPaneBackgroundColor = ”yellow”

ScriptPaneForegroundColor

Это свойство доступно для чтения и записи. Оно возвращает или задает цвет переднего плана для файлов, отличных от файлов скриптов, в области скриптов. Цвет переднего плана для файлов скриптов задается с помощью свойства TokenColors.

# Sets the foreground to color of non-script files in the script pane to green.
$psISE.Options.ScriptPaneBackgroundColor = ”green”

SelectedScriptPaneState

Это свойство доступно для чтения и записи. Оно возвращает или задает положение области скриптов на экране. Возможные значения: "Top", "Right" и "Maximized".

# Moves the Script Pane to the top
$psISE.Options.SelectedScriptPaneState = "Top"
# Moves the Script Pane to the right.
$psISE.Options.SelectedScriptPaneState = "Right"
# Maximizes the Script Pane
$psISE.Options.SelectedScriptPaneState = "Maximized"

ShowToolBar

Это свойство логического типа доступно для чтения и записи. Оно определяет, отображается ли панель инструментов.

# Show the tool bar.
$psISe.Options.ShowToolBar = $true

ShowWarningBeforeSavingOnRun

Это свойство доступно для чтения и записи. Оно возвращает или задает логическое значение, определяющее, отображается ли предупреждение при автоматическом сохранении скрипта перед его выполнением.

# Sets the option to display a warning message 
# when an attempt is made to save a script before running it.
$psISE.Options.ShowWarningBeforeSavingOnRun=$true

ShowWarningForDuplicateFiles

Это свойство доступно для чтения и записи. Оно возвращает или задает логическое значение, определяющее, отображается ли предупреждение, если один и тот же файл открыт на разных вкладках PowerShell.

# Set the ShowWarningForDuplicateFiles property to true. 
$psISE.Options.ShowWarningForDuplicateFiles = $true
# The following  message is displayed: “A copy of this file
# is open in another PowerShell Tab. Changes made to this
# file will affect all open copies.”

TokenColors

Это свойство возвращает объект словаря, содержащий пары "имя-значение" для типов и цветов токенов в областях команд и скриптов.

# Sets the color of commands to green.
$psISE.Options.TokenColors["Command"] = "green"
# Sets the color of keywords to magenta.
$psISE.Options.TokenColors["Keyword"] = "magenta"

UseLocalHelp

Это свойство доступно для чтения и записи. Оно возвращает или задает логическое значение, показывающее, какая именно справка отображается: локальная или интернет-справка.

# Sets the option for the online help to be displayed. 
$psISE.Options.LocalHelp=$false

VerboseBackgroundColor

Это свойство доступно для чтения и записи. Оно возвращает или задает цвет фона текста подробных сообщений в области вывода. Оно является объектом System.Windows.Media.Color.

# Changes the background color for the verbose text that appears in the Output Pane to blue. 
$psISE.Options.VerboseBackgroundColor ='#0000FF'

VerboseForegroundColor

Это свойство доступно для чтения и записи. Оно возвращает или задает цвет переднего плана текста подробных сообщений в области вывода. Оно является объектом System.Windows.Media.Color.

# Changes the foreground color for the verbose text that appears in the Output Pane to yellow. 
$psISE.Options.VerboseForegroundColor =”yellow”

WarningBackgroundColor

Это свойство доступно для чтения и записи. Оно возвращает или задает цвет фона текста предупреждений в области вывода. Оно является объектом System.Windows.Media.Color.

# Changes the background color for the warning text that appears in the Output Pane to blue. 
$psISE.Options.WarningBackgroundColor ='#0000FF'

WarningForegroundColor

Это свойство доступно для чтения и записи. Оно возвращает или задает цвет переднего плана текста предупреждений в области вывода. Оно является объектом System.Windows.Media.Color.

# Changes the foreground color for the warning text that appears in the Output Pane to yellow. 
$psISE.Options.WarningForegroundColor =”yellow”

См. также



  • Объект ISEMenuItemCollection
  • Объект ObjectModelRoot