FileSelectParams(bpy_struct)

base class — bpy_struct

subclasses — FileAssetSelectParams

class bpy.types.FileSelectParams(bpy_struct)

File Select Parameters

directory

Directory displayed in the file browser (default b””, never None)

Type:

bytes

display_size

Change the size of thumbnails (in [16, 256], default 96)

Type:

int

display_size_discrete

Change the size of thumbnails in discrete steps (default 'TINY')

Type:

Literal[‘TINY’, ‘SMALL’, ‘NORMAL’, ‘BIG’, ‘LARGE’]

display_type

Display mode for the file list (default 'LIST_VERTICAL')

  • LIST_VERTICAL Vertical List – Display files as a vertical list.

  • LIST_HORIZONTAL Horizontal List – Display files as a horizontal list.

  • THUMBNAIL Thumbnails – Display files as thumbnails.

Type:

Literal[‘LIST_VERTICAL’, ‘LIST_HORIZONTAL’, ‘THUMBNAIL’]

filename

Active file in the file browser (default “”, never None)

Type:

str

filter_glob

UNIX shell-like filename patterns matching, supports wildcards (‘*’) and list of patterns separated by ‘;’ (default “”, never None)

Type:

str

filter_id

Which ID types to show/hide, when browsing a library (readonly, never None)

Type:

FileSelectIDFilter

Filter by name or tag, supports ‘*’ wildcard (default “”, never None)

Type:

str

list_column_size

The width of columns in horizontal list views (in [32, 750], default 32)

Type:

int

list_display_size

Change the size of thumbnails in list views (in [16, 128], default 32)

Type:

int

recursion_level

Numbers of dirtree levels to show simultaneously (default 'NONE')

  • NONE None – Only list current directory’s content, with no recursion.

  • BLEND Blend File – List .blend files’ content.

  • ALL_1 One Level – List all sub-directories’ content, one level of recursion.

  • ALL_2 Two Levels – List all sub-directories’ content, two levels of recursion.

  • ALL_3 Three Levels – List all sub-directories’ content, three levels of recursion.

Type:

Literal[‘NONE’, ‘BLEND’, ‘ALL_1’, ‘ALL_2’, ‘ALL_3’]

show_details_datetime

Show a column listing the date and time of modification for each file (default False)

Type:

bool

show_details_size

Show a column listing the size of each file (default False)

Type:

bool

show_hidden

Show hidden dot files (default True)

Type:

bool

sort_method

(default 'FILE_SORT_ALPHA')

Type:

Literal[Fileselect Params Sort Items]

title

Title for the file browser (default “”, readonly, never None)

Type:

str

use_filter

Enable filtering of files (default False)

Type:

bool

use_filter_asset_only

Hide .blend files items that are not data-blocks with asset metadata (default False)

Type:

bool

use_filter_backup

Show .blend1, .blend2, etc. files (default False)

Type:

bool

use_filter_blender

Show .blend files (default False)

Type:

bool

use_filter_blendid

Show .blend files items (objects, materials, etc.) (default False)

Type:

bool

use_filter_folder

Show folders (default False)

Type:

bool

use_filter_font

Show font files (default False)

Type:

bool

use_filter_image

Show image files (default False)

Type:

bool

use_filter_movie

Show movie files (default False)

Type:

bool

use_filter_script

Show script files (default False)

Type:

bool

use_filter_sound

Show sound files (default False)

Type:

bool

use_filter_text

Show text files (default False)

Type:

bool

use_filter_volume

Show 3D volume files (default False)

Type:

bool

use_library_browsing

Whether we may browse Blender files’ content or not (default False, readonly)

Type:

bool

use_sort_invert

Sort items descending, from highest value to lowest (default False)

Type:

bool

classmethod bl_rna_get_subclass(id, default=None, /)
Parameters:
  • id (str) – The RNA type identifier.

  • default (bpy.types.Struct | None) – The value to return when not found.

Returns:

The RNA type or default when not found.

Return type:

bpy.types.Struct

classmethod bl_rna_get_subclass_py(id, default=None, /)
Parameters:
  • id (str) – The RNA type identifier.

  • default (type | None) – The value to return when not found.

Returns:

The class or default when not found.

Return type:

type

Inherited Properties

Inherited Functions

References