home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 10 Tools / 10-Tools.zip / evbl0627.zip / everblue_20010627.zip / x11 / Xlib_UninstallColormap.c < prev    next >
C/C++ Source or Header  |  2000-06-21  |  2KB  |  64 lines
  1. #include "Xlib.h"
  2. #include "Xlib_private.h"
  3. #include "GetReq.h"
  4.  
  5. /* 
  6.  * Arguments
  7.  * 
  8.  *  display    Specifies the connection to the X server. 
  9.  *  colormap    Specifies the colormap. 
  10.  * 
  11.  * 
  12.  * Description
  13.  * 
  14.  * The XUninstallColormap() function removes the specified colormap from the required list for its screen. As a result, the
  15.  * specified colormap might be uninstalled, and the X server might implicitly install or uninstall additional colormaps. Which
  16.  * colormaps get installed or uninstalled is server-dependent except that the required list must remain installed. 
  17.  * 
  18.  * If the specified colormap becomes uninstalled, the X server generates a ColormapNotify event on each window that has that
  19.  * colormap. In addition, for every other colormap that is installed or uninstalled as a result of a call to XUninstallColormap(), the
  20.  * X server generates a ColormapNotify event on each window that has that colormap. 
  21.  * 
  22.  * XUninstallColormap() can generate a BadColor error. 
  23.  * 
  24.  * 
  25.  * Diagnostics
  26.  * 
  27.  *  BadColor    A value for a Colormap argument does not name a defined Colormap. 
  28.  */
  29.  
  30.  
  31. /*
  32.  
  33. Copyright 1986, 1998  The Open Group
  34.  
  35. All Rights Reserved.
  36.  
  37. The above copyright notice and this permission notice shall be included in
  38. all copies or substantial portions of the Software.
  39.  
  40. THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
  41. IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
  42. FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.  IN NO EVENT SHALL THE
  43. OPEN GROUP BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN
  44. AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN
  45. CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
  46.  
  47. Except as contained in this notice, the name of The Open Group shall not be
  48. used in advertising or otherwise to promote the sale, use or other dealings
  49. in this Software without prior written authorization from The Open Group.
  50.  
  51. */
  52.  
  53. int XUninstallColormap(register Display *dpy, Colormap cmap)
  54. {
  55.     register xResourceReq *req;
  56.  
  57.     DBUG_ENTER("XUninstallColormap");
  58.     LockDisplay(dpy);
  59.     GetResReq(UninstallColormap, cmap, req);
  60.     UnlockDisplay(dpy);
  61.     SyncHandle();
  62.     DBUG_RETURN(1);
  63. }
  64.