Generic FunctionPackage: cgToCDocOverviewCGDocRelNotesFAQIndexPermutedIndex
Allegro CL version 8.1
Unrevised from 8.0 to 8.1.
8.0 version

file-selection-buffer-size

Arguments: configuration

Returns (or sets with setf) the byte length of the buffer that is used for returning the selected pathnames from calls to ask-user-for-existing-pathname, ask-user-for-new-pathname, and ask-user-for-directory.

The interesting case is when ask-user-for-existing-pathname is called with the multiple-p option to allow the end user to select any number of files. If Allegro CL made the buffer large enough to hold the largest set of pathnames that might be selected in any application, a static buffer would make all standalone applications significantly larger, or a dynamically-allocated buffer might even make the dialog noticeably slower to appear. Therefore we use a modest-sized buffer by default, but also provide this configuration option for an application to increase the size of the buffer if needed.

The initial buffer would hold a dozen pathnames of maximum length. Since the maximum pathname length in the Windows API is currently 260, this makes the default buffer 3120 bytes in size. An application in which the end user may select a set of pathnames whose combined length is larger should increase this buffer size with a form such as

(setf (file-selection-buffer-size (configuration *system*))
       new-size)

file-selection-buffer-size is a property of the configuration class.


Copyright (c) 1998-2009, Franz Inc. Oakland, CA., USA. All rights reserved.
Documentation for Allegro CL version 8.1. This page was not revised from the 8.0 page.
Created 2009.9.22.

ToCDocOverviewCGDocRelNotesFAQIndexPermutedIndex
Allegro CL version 8.1
Unrevised from 8.0 to 8.1.
8.0 version