Объект 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”
См. также