Display a scrolling list of selectable items The chooser object is similar to the umenu object, but it displays a scrolling list of selectable items rather than a pop-up menu. Cycling '74 TEXT_HERE Messages TEXT_HERE Index (Message or Single-Click) The index of the list item received as a message or the item chosen by a single mouse click. Item (Message or Single-Click) The text of the item received as a message or the item chosen by a single mouse click. Index (Double-Click) The index of the item chosen by a double mouse click. Item (Double-Click) The text of the item chosen by a double mouse click. Preview Control Connect this inlet to the left inlet of an sfplay~, imovie, movie, jit.movie, or jit.movie~ object to control these objects to play files when preview is enabled. Dump Outlet TEXT_HERE None TEXT_HERE Report current item Sends the contents of the currently selected item out the second outlet and the index of the currently selected out the left outlet. Sets current item by index Sets the currently selected item to the specified index, then sends that item's contents out the second outlet and its index out the left outlet. Sets current item by index Sets the currently selected item to the specified index, then sends that item's contents out the second outlet and its index out the left outlet. Sets current item by contents If the chooser object contains an item whose contents matches the message, that item will be selected. Then the item's contents will be sent out the second outlet and its index will be sent out the left outlet. If there is no match, the currently selected item is not changed and no output occurs. Adds a chooser item The word append, followed by any message, appends that message to the end of the chooser object's item list. Removes all items TEXT_HERE Reports the number of items Sends the number of items currently in the item list out the right outlet, preceded by the word count. Removes one or more items The word delete, followed by one or more item numbers, removes the numbered items from the item list. Deselect currently selected item The word deselect removes the visual reprepesentation of the selected item from the chooser object. It does not change the chooser object's current value, so a bang will still output the last selected item. Set the items for chooser with a dictionary The word dictionary, followed by a dictionary name, will set the items for chooser. You can also attach the first outlet of a dict object to the first inlet of chooser. In order for this to work, the dictionary needs to include an "items" entry. For example, the following dictionary entry will populate chooser with the items "hank, carol, andreas, roland":

"items" : [ "hank", "carol", "andreas", "roland" ] Inserts an item The word insert, followed by an index number and a message, inserts a new item to the list at the position specified by the index. Selects an item A single-click on an item selects the item, causing its contents to be sent out the second outlet and its index to be sent out the left outlet. A double-click on an item sends its contents out the fourth outlet and its item index out the third outlet. Selects the next item The next message selects the next item in the list, then sends the selected item's contents out the second outlet and its index out the left outlet. Previews a media file The word play, followed by an index number, sends a command to an object (such as sfplay~ or jit.movie) connected to the fifth outlet to open and play the specified media file. The index argument selects the file to play. Selects the previous item The prev message selects the previous item in the list, then sends the selected item's contents out the second outlet and its index out the left outlet. Sets the relative preview location When the preview attribute is on, the word progress, followed by a float between 0.0 and 1.0, will update the display of the current preview progress circle. Selects an item without output The word set, followed by a number, sets the currently selected item to the specified index, but does not produce any output. Selects the next item without output Selects the item below the currently selected item in the list, but does not produce any output. Selects the previous item without output Selects the item above the currently selected item in the list, but does not produce any output. Sorts items by contents The word sort followed by a positive number, sorts the chooser object's items alphetically in ascending order (A-Z). sort followed by a negative number sorts the list of items alphabetically in descending order (Z - A). Stops preview playback The word stop causes the current preview playback of any item to stop. Set automatically from file queries When the autopopulate attribute is enabled, the chooser object updates its item list whenever the prefix attribute is set with a path or the collection or filekind attributes are set with a database query. When autopopulate is disabled, changing the object's current folder or file query has no effect on the item list. However, if you enable autopopulate after changing the prefix, collection, or filekind attributes, the item list will immediately update. Background Color Sets the background color of one of the chooser object's rows in RGBA format. The other row background color is set by the stripecolor attribute. Collection Name When the collection attribute is set to a collection name, the item list will be populated with the names of files contained in the named collection. You can define a collection of files using the File Browser. TEXT_HERE TEXT_HERE TEXT_HERE TEXT_HERE TEXT_HERE TEXT_HERE TEXT_HERE TEXT_HERE TEXT_HERE TEXT_HERE TEXT_HERE TEXT_HERE TEXT_HERE TEXT_HERE TEXT_HERE TEXT_HERE TEXT_HERE TEXT_HERE TEXT_HERE TEXT_HERE TEXT_HERE TEXT_HERE TEXT_HERE TEXT_HERE Folder recursion depth If the value of depth is 0, only the files contained in the folder specified by prefix will be added to the item list. If depth is greater than zero, then items in subfolders of the prefix folder will be added to the list, with the folder names(s) prepended to them. Items in subfolders up to the level specified by the depth attribute are included. Enable Drag and Drop When the enabledrag attribute is enabled, you can drag a named file item in the list to any Max object that accepts it (such as a playlist~). Include Factory Content When the factorycontent attribute is enabled, files added to the chooser via the use of the collection or filekind query will include example files that ship with the Max application. File Kind The filekind attribute permits you to build a list of chooser items containing all files of a specified type currently present in Max's search path. In order for the filenames to appear, the autopopulate attribute must be enabled. TEXT_HERE TEXT_HERE TEXT_HERE TEXT_HERE TEXT_HERE TEXT_HERE TEXT_HERE TEXT_HERE TEXT_HERE TEXT_HERE TEXT_HERE TEXT_HERE TEXT_HERE TEXT_HERE TEXT_HERE TEXT_HERE TEXT_HERE TEXT_HERE TEXT_HERE TEXT_HERE TEXT_HERE TEXT_HERE TEXT_HERE TEXT_HERE TEXT_HERE TEXT_HERE TEXT_HERE TEXT_HERE TEXT_HERE TEXT_HERE TEXT_HERE TEXT_HERE TEXT_HERE TEXT_HERE TEXT_HERE TEXT_HERE TEXT_HERE TEXT_HERE TEXT_HERE TEXT_HERE TEXT_HERE TEXT_HERE TEXT_HERE TEXT_HERE TEXT_HERE TEXT_HERE TEXT_HERE TEXT_HERE TEXT_HERE TEXT_HERE TEXT_HERE TEXT_HERE TEXT_HERE TEXT_HERE TEXT_HERE TEXT_HERE TEXT_HERE TEXT_HERE TEXT_HERE TEXT_HERE TEXT_HERE TEXT_HERE TEXT_HERE TEXT_HERE TEXT_HERE TEXT_HERE TEXT_HERE TEXT_HERE TEXT_HERE TEXT_HERE TEXT_HERE TEXT_HERE TEXT_HERE TEXT_HERE TEXT_HERE TEXT_HERE TEXT_HERE TEXT_HERE TEXT_HERE TEXT_HERE TEXT_HERE TEXT_HERE TEXT_HERE TEXT_HERE TEXT_HERE TEXT_HERE TEXT_HERE TEXT_HERE TEXT_HERE TEXT_HERE TEXT_HERE TEXT_HERE TEXT_HERE TEXT_HERE TEXT_HERE TEXT_HERE TEXT_HERE TEXT_HERE TEXT_HERE TEXT_HERE TEXT_HERE TEXT_HERE TEXT_HERE TEXT_HERE TEXT_HERE TEXT_HERE TEXT_HERE TEXT_HERE Filter Text The filtertext attribute defines a text filter that modifies the list populated by the prefix, collection, or filekind attributes. Only files that contain the text in filtertext will be included in the chooser object's list. When filtertext is empty, no filtering occurs. Header Height The headerheight attribute sets the height of the chooser object's header in pixels. By default the height is zero and the header is not shown. Header Label TEXT_HERE List Items The items attribute is used by the inspector to set the text of all the items in the list after you edit them. However, when changing this attribute with a message, you can only set the first item, so we recommend using a clear message followed by a series of append messages to set a list of multiple items. Keys Select Matching Items The keynavigate attribute enables/disables letter key search navigation for chooser. When enabled (1) and the chooser object is selected, pressing a letter on your keyboard will cause chooser to select the item that begins with that letter. When disabled, key search navigation does not work. Disabling this attribute can be useful if you are using other key commands in your patch, such as with the key object. Text Margin The margin attribute sets the left and right text margins used when drawing the item text. When the margin attribute is 0, the object draws the text using a default margin equal to 80% of the currently used font's height. Multiple Selection When multiselect is enabled, the chooser object permits a user to select more than one item at a time by shift-clicking or command / control clicking. In addition, the multiselect attribute modifies how the chooser object sends selected items out its outlets. The first and third item index outlets will send the message selectedindices followed by a list of one or more indices for each of the selected items. The second and fourth item contents outlets send the message selecteditems followed by a list of one or more symbols with the contents of each of the selected items. Parameter Mode Enable Enables use of this object with Max for Live Parameters and allows for setting initial parameter values in the Max environment. Visible to Mapping When parameter_mappable is enabled, the object will be available for mapping to keyboard or MIDI input using the Mappings feature. Prefix or Folder The prefix attribute specifies a file path that will be used to populate the list of items. A file will be included in the list if its name contains the text of the current value of the filtertext attribute and its type is included in the types specified by the types attribute. In addition the depth attribute controls whether files contained within any subfolders of the prefix folder are listed. In order for the contents of the folder designated by prefix set the item list, the autopopulate attribute must be enabled. Prefix Mode The prefix_mode attribute controls how the chooser object outputs the path location of a chosen filename when using prefix to list the contents of a folder. TEXT_HERE The file name is combined with its containing folder name to create a single complete path name. TEXT_HERE The containing folder name is output as a separate symbol followed by the file name. This prefix mode cannot be used when multiselect is enabled. TEXT_HERE Only the file name is output. Show Preview When the preview attribute is enabled, the chooser object shows a play button the to left of each item. If you connect the fifth outlet of chooser to an object that can play the type of file displayed in the list (sfplay~, jit.movie, or jit.playlist, clicking the play button next to an item will send commands to the connected object to begin playing the file specified by the item. Report Clicks on Selected Items When selectedclick is enabled, clicking on an already selected item reports that item. Otherwise items are only reported when the selection changes. Selection Color Sets the background color of the chooser object's currently selected item in RGBA format. A custom background color for the selected item is only displayed if the useselectioncolor attribute is enabled. Show Dot Files Toggles the display of a any files whose names begin with a dot (period). The display of these files is normally supressed. Background Color 2 Sets the second (alternating) background row color in RGBA format. The other row background color is set by the bgcolor attribute. Style Sets the style to be used for the chooser object's visual display. Text Color Sets the text color of the chooser object in RGBA format. File Types The types attribute is used in conjunciton with the prefix attribute. It permits filtering files contained in the prefix folder according to one or more types. The types are four-character type codes as those used by the folder object such as AIFF, WAVE, TEXT, and JSON. Use Custom Selection Color Toggles the use of the selectcolor attribute to define a custom selection color.