Up to date

This page is up to date for Godot 4.1. If you still find outdated information, please open an issue.

CodeHighlighter

Inherits: SyntaxHighlighter < Resource < RefCounted < Object

A syntax highlighter intended for code.

Description

By adjusting various properties of this resource, you can change the colors of strings, comments, numbers, and other text patterns inside a TextEdit control.

Properties

Dictionary

color_regions

{}

Color

function_color

Color(0, 0, 0, 1)

Dictionary

keyword_colors

{}

Dictionary

member_keyword_colors

{}

Color

member_variable_color

Color(0, 0, 0, 1)

Color

number_color

Color(0, 0, 0, 1)

Color

symbol_color

Color(0, 0, 0, 1)

Methods

void

add_color_region ( String start_key, String end_key, Color color, bool line_only=false )

void

add_keyword_color ( String keyword, Color color )

void

add_member_keyword_color ( String member_keyword, Color color )

void

clear_color_regions ( )

void

clear_keyword_colors ( )

void

clear_member_keyword_colors ( )

Color

get_keyword_color ( String keyword ) const

Color

get_member_keyword_color ( String member_keyword ) const

bool

has_color_region ( String start_key ) const

bool

has_keyword_color ( String keyword ) const

bool

has_member_keyword_color ( String member_keyword ) const

void

remove_color_region ( String start_key )

void

remove_keyword_color ( String keyword )

void

remove_member_keyword_color ( String member_keyword )


Property Descriptions

Dictionary color_regions = {}

Sets the color regions. All existing regions will be removed. The Dictionary key is the region start and end key, separated by a space. The value is the region color.


Color function_color = Color(0, 0, 0, 1)

  • void set_function_color ( Color value )

  • Color get_function_color ( )

Sets color for functions. A function is a non-keyword string followed by a '('.


Dictionary keyword_colors = {}

Sets the keyword colors. All existing keywords will be removed. The Dictionary key is the keyword. The value is the keyword color.


Dictionary member_keyword_colors = {}

Sets the member keyword colors. All existing member keyword will be removed. The Dictionary key is the member keyword. The value is the member keyword color.


Color member_variable_color = Color(0, 0, 0, 1)

  • void set_member_variable_color ( Color value )

  • Color get_member_variable_color ( )

Sets color for member variables. A member variable is non-keyword, non-function string proceeded with a '.'.


Color number_color = Color(0, 0, 0, 1)

  • void set_number_color ( Color value )

  • Color get_number_color ( )

Sets the color for numbers.


Color symbol_color = Color(0, 0, 0, 1)

  • void set_symbol_color ( Color value )

  • Color get_symbol_color ( )

Sets the color for symbols.


Method Descriptions

void add_color_region ( String start_key, String end_key, Color color, bool line_only=false )

Adds a color region such as comments or strings.

Both the start and end keys must be symbols. Only the start key has to be unique.

line_only denotes if the region should continue until the end of the line or carry over on to the next line. If the end key is blank this is automatically set to true.


void add_keyword_color ( String keyword, Color color )

Sets the color for a keyword.

The keyword cannot contain any symbols except '_'.


void add_member_keyword_color ( String member_keyword, Color color )

Sets the color for a member keyword.

The member keyword cannot contain any symbols except '_'.

It will not be highlighted if preceded by a '.'.


void clear_color_regions ( )

Removes all color regions.


void clear_keyword_colors ( )

Removes all keywords.


void clear_member_keyword_colors ( )

Removes all member keywords.


Color get_keyword_color ( String keyword ) const

Returns the color for a keyword.


Color get_member_keyword_color ( String member_keyword ) const

Returns the color for a member keyword.


bool has_color_region ( String start_key ) const

Returns true if the start key exists, else false.


bool has_keyword_color ( String keyword ) const

Returns true if the keyword exists, else false.


bool has_member_keyword_color ( String member_keyword ) const

Returns true if the member keyword exists, else false.


void remove_color_region ( String start_key )

Removes the color region that uses that start key.


void remove_keyword_color ( String keyword )

Removes the keyword.


void remove_member_keyword_color ( String member_keyword )

Removes the member keyword.