Text(ID)

base classes — bpy_struct, ID

class bpy.types.Text(ID)

Text datablock referencing an external or packed text file

current_character

Index of current character in current line, and also start index of character in selection if one exists

Type :int in [0, inf], default 0, (readonly)
current_line

Current line, and start line of selection if one exists

Type :TextLine, (readonly, never None)
filepath

Filename of the text file

Type :string, default “”
is_dirty

Text file has been edited since last save

Type :boolean, default False, (readonly)
is_in_memory

Text file is in memory, without a corresponding file on disk

Type :boolean, default False, (readonly)
is_modified

Text file on disk is different than the one in memory

Type :boolean, default False, (readonly)
lines

Lines of text

Type :Collection of TextLine, (readonly)
markers

Text markers highlighting part of the text

Type :Collection of TextMarker, (readonly)
select_end_character

Index of character after end of selection in the selection end line

Type :int in [0, inf], default 0, (readonly)
select_end_line

End line of selection

Type :TextLine, (readonly, never None)
use_module

Register this text as a module on loading, Text name must end with ”.py”

Type :boolean, default False
use_tabs_as_spaces

Automatically converts all new tabs into spaces

Type :boolean, default False
users_logic

Logic bricks that use this text (readonly)

clear()

clear the text block.

write(text)

write text at the cursor location and advance to the end of the text block.

Parameters:
  • text (string) – New text for this datablock.
static as_string(self)

Return the text as a string.

from_string(string)

Replace text with this string.

Inherited Properties

Inherited Functions

References

Previous topic

TexMapping(bpy_struct)

Next topic

TextBox(bpy_struct)