# Text(ID)

base classes — `bpy_struct`, `ID`

class `bpy.types.``Text`(ID)

  Text data-block 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)

  `current_line_index`

    Index of current TextLine in TextLine collection

    Type: | int in [-inf, inf], default 0

  `filepath`

    Filename of the text file

    Type: | string, default “”, (never None)

  `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: | `bpy_prop_collection` of `TextLine`, (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, (never None)) – New text for this data-block

  `as_string`()

    Return the text as a string.

  `from_string`(string)

    Replace text with this string.

Inherited Properties

`bpy_struct.id_data` `ID.name` `ID.users` `ID.use_fake_user` `ID.tag` | `ID.is_updated` `ID.is_updated_data` `ID.is_library_indirect` `ID.library` `ID.preview`

Inherited Functions

`bpy_struct.as_pointer` `bpy_struct.driver_add` `bpy_struct.driver_remove` `bpy_struct.get` `bpy_struct.is_property_hidden` `bpy_struct.is_property_readonly` `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.property_unset` `bpy_struct.type_recast` `bpy_struct.values` `ID.copy` `ID.user_clear` `ID.animation_data_create` `ID.animation_data_clear` `ID.update_tag`

References

`bpy.context.edit_text` `BlendData.texts` `BlendDataTexts.load` `BlendDataTexts.new` `BlendDataTexts.remove` `Filter2DActuator.glsl_shader` `FreestyleModuleSettings.script` | `NodeFrame.text` `PythonConstraint.text` `PythonController.text` `SceneGameData.dome_text` `ShaderNodeScript.script` `SpaceTextEditor.text`