I want the user to be able to select some data from a CollectionProperty

audioFiles = CollectionProperty(type=AudioFileNameGroup)

holding data of a custom PropertyGroup type:

class AudioFileNameGroup(types.PropertyGroup):
    fileName = StringProperty(name="File Name", subtype='FILE_NAME')

To enable the selection for the user, in a panel I'm using prop_search on that:

navStateCol.prop_search(obj, "audioAction", context.scene.frameworkReferences, 'audioFiles', translate=False,

but I can't get it to work:

If the obj.audioAction property is a StringProperty

audioAction = StringProperty(name="Audio Effect", subtype='FILE_NAME')

i don't get anything to select from:

no suggestions

This makes sense, as the system has no way of knowing, that it should refer to the fileName StringProperty inside the AudioFileNameGroup.

If the obj.audioAction property is

audioAction = PointerProperty(type=AudioFileNameGroup, name="AudioAction")

it is not editable, and the ui is disabled: disabled ui

How can I use prop_search on the audioFiles collectionproperty?

  • 2
    $\begingroup$ As a side note since you are looking at audio files, bpy.path.extensions_audio is a set of audio file extensions supported by the user's blender. $\endgroup$
    – batFINGER
    Jun 12, 2018 at 15:40

1 Answer 1


Set the name on the collection

Set the name of the collection item, as this is what appears in the prop search. Simple test script, the collection is populated from a simple list.

import bpy

class HelloWorldPanel(bpy.types.Panel):
    """Creates a Panel in the Object properties window"""
    bl_label = "Hello World Panel"
    bl_idname = "OBJECT_PT_hello"
    bl_space_type = 'PROPERTIES'
    bl_region_type = 'WINDOW'
    bl_context = "object"

    def draw(self, context):
        layout = self.layout

        obj = context.object        
        layout.prop_search(obj, "audioAction", context.scene, "audioFiles", icon='SPEAKER')

class AudioFileNameGroup(bpy.types.PropertyGroup):
    name = bpy.props.StringProperty(name="File Name", subtype='FILE_NAME')

def register():       
    audioAction = bpy.props.StringProperty(name="Audio Effect", subtype='FILE_NAME')
    bpy.types.Object.audioAction = audioAction        
    bpy.types.Scene.audioFiles = bpy.props.CollectionProperty(type=AudioFileNameGroup)

def unregister():
    # fill this in

if __name__ == "__main__":
    items = (
        ('FOO', 'Foo', ''),
        ('BAR', 'Bar', '')
    scene = bpy.context.scene
    for identifier, name, description in items:
        scene.audioFiles.add().name = name

Your Answer

By clicking “Post Your Answer”, you agree to our terms of service, privacy policy and cookie policy

Not the answer you're looking for? Browse other questions tagged or ask your own question.