home *** CD-ROM | disk | FTP | other *** search
/ Chip 2000 May / Chip_2000-05_cd1.bin / zkuste / Perl / ActivePerl-5.6.0.613.msi / 䆊䌷䈹䈙䏵-䞅䞆䞀㡆䞃䄦䠥 / _f435cae4e33eda9feaceec28a494fb08 < prev    next >
Text File  |  2000-03-23  |  4KB  |  100 lines
  1.  
  2. <HTML>
  3. <HEAD>
  4. <TITLE>Tk::clipboard - Manipulate Tk clipboard</TITLE>
  5. <LINK REL="stylesheet" HREF="../../../Active.css" TYPE="text/css">
  6. <LINK REV="made" HREF="mailto:">
  7. </HEAD>
  8.  
  9. <BODY>
  10. <TABLE BORDER=0 CELLPADDING=0 CELLSPACING=0 WIDTH=100%>
  11. <TR><TD CLASS=block VALIGN=MIDDLE WIDTH=100% BGCOLOR="#cccccc">
  12. <STRONG><P CLASS=block> Tk::clipboard - Manipulate Tk clipboard</P></STRONG>
  13. </TD></TR>
  14. </TABLE>
  15.  
  16. <A NAME="__index__"></A>
  17. <!-- INDEX BEGIN -->
  18.  
  19. <UL>
  20.  
  21.     <LI><A HREF="#name">NAME</A></LI><LI><A HREF="#supportedplatforms">SUPPORTED PLATFORMS</A></LI>
  22.  
  23.     <LI><A HREF="#synopsis">SYNOPSIS</A></LI>
  24.     <LI><A HREF="#description">DESCRIPTION</A></LI>
  25.     <LI><A HREF="#keywords">KEYWORDS</A></LI>
  26. </UL>
  27. <!-- INDEX END -->
  28.  
  29. <HR>
  30. <P>
  31. <H1><A NAME="name">NAME</A></H1>
  32. <P>Tk::clipboard - Manipulate Tk clipboard</P>
  33. <P>
  34. <HR>
  35. <H1><A NAME="supportedplatforms">SUPPORTED PLATFORMS</A></H1>
  36. <UL>
  37. <LI>Linux</LI>
  38. <LI>Solaris</LI>
  39. <LI>Windows</LI>
  40. </UL>
  41. <HR>
  42. <H1><A NAME="synopsis">SYNOPSIS</A></H1>
  43. <P><EM>$widget</EM>-><STRONG>clipboard</STRONG><EM>Option</EM>?(<EM>args</EM>)?</P>
  44. <P>
  45. <HR>
  46. <H1><A NAME="description">DESCRIPTION</A></H1>
  47. <P>This command provides an interface to the Tk clipboard,
  48. which stores data for later retrieval using the selection mechanism.
  49. In order to copy data into the clipboard, <STRONG>clipboardClear</STRONG> must
  50. be called, followed by a sequence of one or more calls to
  51. <STRONG>clipboardAppend</STRONG>.  To ensure that the clipboard is updated atomically, all
  52. appends should be completed before returning to the event loop.</P>
  53. <P>The following methods are currently supported:</P>
  54. <DL>
  55. <DT><STRONG><A NAME="item_clipboardClear"><EM>$widget</EM>-><STRONG>clipboardClear</STRONG></A></STRONG><BR>
  56. <DD>
  57. Claims ownership of the clipboard on <EM>$widget</EM>'s display and removes
  58. any previous contents.   Returns an empty string.
  59. <P></P>
  60. <DT><STRONG><A NAME="item_clipboardAppend"><EM>$widget</EM>-><STRONG>clipboardAppend</STRONG>(?<STRONG>-format</STRONG>=><EM>format</EM>?,?<STRONG>-type</STRONG>=><EM>type</EM>?,?<STRONG>--</STRONG>?,<EM>data</EM>)</A></STRONG><BR>
  61. <DD>
  62. Appends <EM>data</EM> to the clipboard on $widget's
  63. display in the form given by <EM>type</EM> with the representation given
  64. by <EM>format</EM> and claims ownership of the clipboard on $widget's
  65. display.
  66. <P><EM>Type</EM> specifies the form in which the selection is to be returned
  67. (the desired ``target'' for conversion, in ICCCM terminology), and
  68. should be an atom name such as STRING or FILE_NAME; see the
  69. Inter-Client Communication Conventions Manual for complete details.
  70. <EM>Type</EM> defaults to STRING.</P>
  71. <P>The <EM>format</EM> argument specifies the representation that should be
  72. used to transmit the selection to the requester (the second column of
  73. Table 2 of the ICCCM), and defaults to STRING.  If <EM>format</EM> is
  74. STRING, the selection is transmitted as 8-bit ASCII characters.
  75. See the <A HREF="../../../Tk/Selection.html">the Tk::Selection manpage</A> documentation for explanation of what happens
  76. if <EM>format</EM> is not STRING.
  77. Note that arguments passed to
  78. <STRONG>clipboardAppend</STRONG> are concatenated before conversion, so the
  79. caller must take care to ensure appropriate spacing across string
  80. boundaries.  All items appended to the clipboard with the same
  81. <EM>type</EM> must have the same <EM>format</EM>.</P>
  82. <P>A <STRONG>--</STRONG> argument may be specified to mark the end of options:  the
  83. next argument will always be used as <EM>data</EM>.
  84. This feature may be convenient if, for example, <EM>data</EM> starts
  85. with a <STRONG>-</STRONG>.</P>
  86. </DL>
  87. <P>
  88. <HR>
  89. <H1><A NAME="keywords">KEYWORDS</A></H1>
  90. <P>clear, format, clipboard, append, selection, type</P>
  91. <TABLE BORDER=0 CELLPADDING=0 CELLSPACING=0 WIDTH=100%>
  92. <TR><TD CLASS=block VALIGN=MIDDLE WIDTH=100% BGCOLOR="#cccccc">
  93. <STRONG><P CLASS=block> Tk::clipboard - Manipulate Tk clipboard</P></STRONG>
  94. </TD></TR>
  95. </TABLE>
  96.  
  97. </BODY>
  98.  
  99. </HTML>
  100.