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

bpy_struct.id_data ID.name ID.use_fake_user

ID.library ID.tag ID.users

Inherited Functions

bpy_struct.as_pointer bpy_struct.callback_add bpy_struct.callback_remove bpy_struct.driver_add bpy_struct.driver_remove bpy_struct.get bpy_struct.is_property_hidden bpy_struct.is_property_set bpy_struct.items bpy_struct.keyframe_delete

bpy_struct.keyframe_insert bpy_struct.keys bpy_struct.path_from_id bpy_struct.path_resolve bpy_struct.type_recast bpy_struct.values ID.copy ID.user_clear ID.animation_data_create ID.animation_data_clear

References

BlendData.texts Filter2DActuator.glsl_shader MainTexts.load MainTexts.new MainTexts.remove

PythonConstraint.text PythonController.text SceneGameData.dome_text SpaceTextEditor.text