ask-user-for-color

Function

Package: common-graphics

Arguments: &key initial-color show-custom-colors disable-custom-colors stream

Displays a Common Dialog for color selection provided by the Windows Operating System. Returns the color selected, or initial-color if no color is selected. If the user cancels the interaction (by pressing the cancel button on the dialog), nil is returned. initial-color should be a rgb-color (such as created by make-rgb and returned by this function).

If show-custom-colors is specified true, the extra section of the dialog that allows users to define custom colors in addition to the standard set is displayed initially. If nil, the extra section is displayed only if the user clicks the button whose appearance is controlled by the next argument.

If disable-custom-colors is specified true, the button that brings up the extra section of the dialog, which shows custom colors, is masked.

Common Graphics and IDE documentation is described in About Common Graphics and IDE documentation in cgide.htm.

The documentation is described in introduction.htm and the index is in index.htm.

Copyright (c) 1998-2000, Franz Inc. Berkeley, CA., USA. All rights reserved.

Created 2000.10.5.