GetClrmap.3
上传用户:rrhhcc
上传日期:2015-12-11
资源大小:54129k
文件大小:3k
源码类别:

通讯编程

开发平台:

Visual C++

  1. '"
  2. '" Copyright (c) 1994 The Regents of the University of California.
  3. '" Copyright (c) 1994-1996 Sun Microsystems, Inc.
  4. '"
  5. '" See the file "license.terms" for information on usage and redistribution
  6. '" of this file, and for a DISCLAIMER OF ALL WARRANTIES.
  7. '" 
  8. '" RCS: @(#) $Id: GetClrmap.3,v 1.3 2002/08/05 04:30:38 dgp Exp $
  9. '" 
  10. .so man.macros
  11. .TH Tk_GetColormap 3 4.0 Tk "Tk Library Procedures"
  12. .BS
  13. .SH NAME
  14. Tk_GetColormap, Tk_FreeColormap - allocate and free colormaps
  15. .SH SYNOPSIS
  16. .nf
  17. fB#include <tk.h>fR
  18. .sp
  19. Colormap
  20. fBTk_GetColormap(fIinterp, tkwin, stringfB)fR
  21. .sp
  22. fBTk_FreeColormap(fIdisplay, colormapfB)fR
  23. .SH ARGUMENTS
  24. .AS "Colormap" colormap
  25. .AP Tcl_Interp *interp in
  26. Interpreter to use for error reporting.
  27. .AP Tk_Window tkwin in
  28. Token for window in which colormap will be used.
  29. .AP "CONST char" *string in
  30. Selects a colormap:  either fBnewfR or the name of a window
  31. with the same screen and visual as fItkwinfR.
  32. .AP Display *display in
  33. Display for which fIcolormapfR was allocated.
  34. .AP Colormap colormap in
  35. Colormap to free;  must have been returned by a previous
  36. call to fBTk_GetColormapfR or fBTk_GetVisualfR.
  37. .BE
  38. .SH DESCRIPTION
  39. .PP
  40. These procedures are used to manage colormaps.
  41. fBTk_GetColormapfR returns a colormap suitable for use in fItkwinfR.
  42. If its fIstringfR argument is fBnewfR then a new colormap is
  43. created;  otherwise fIstringfR must be the name of another window
  44. with the same screen and visual as fItkwinfR, and the colormap from that
  45. window is returned.
  46. If fIstringfR doesn't make sense, or if it refers to a window on
  47. a different screen from fItkwinfR or with
  48. a different visual than fItkwinfR, then fBTk_GetColormapfR returns
  49. fBNonefR and leaves an error message in fIinterp->resultfR.
  50. .PP
  51. fBTk_FreeColormapfR should be called when a colormap returned by
  52. fBTk_GetColormapfR is no longer needed.
  53. Tk maintains a reference count for each colormap returned by
  54. fBTk_GetColormapfR, so there should eventually be one call to
  55. fBTk_FreeColormapfR for each call to fBTk_GetColormapfR.
  56. When a colormap's reference count becomes zero, Tk releases the
  57. X colormap.
  58. .PP
  59. fBTk_GetVisualfR and fBTk_GetColormapfR work together, in that
  60. a new colormap created by fBTk_GetVisualfR may later be returned
  61. by fBTk_GetColormapfR.
  62. The reference counting mechanism for colormaps includes both procedures,
  63. so callers of fBTk_GetVisualfR must also call fBTk_FreeColormapfR
  64. to release the colormap.
  65. If fBTk_GetColormapfR is called with a fIstringfR value of
  66. fBnewfR then the resulting colormap will never
  67. be returned by fBTk_GetVisualfR;  however, it can be used in other
  68. windows by calling fBTk_GetColormapfR with the original window's
  69. name as fIstringfR.
  70. .SH KEYWORDS
  71. colormap