


XmClipboardUnlock(3X)					XmClipboardUnlock(3X)
OSF/Motif							    OSF/Motif



NAME
  XXmmCClliippbbooaarrddUUnnlloocckk - A	clipboard function that	unlocks	the clipboard

SYNOPSIS


  ##iinncclluuddee <<XXmm//XXmm..hh>>
  ##iinncclluuddee <<XXmm//CCuuttPPaassttee..hh>>
  iinntt XXmmCClliippbbooaarrddUUnnlloocckk	((_d_i_s_p_l_a_y, _w_i_n_d_o_w, _r_e_m_o_v_e__a_l_l__l_o_c_k_s))
       DDiissppllaayy	 * _d_i_s_p_l_a_y;;
       WWiinnddooww	 _w_i_n_d_o_w;;
       BBoooolleeaann	 _r_e_m_o_v_e__a_l_l__l_o_c_k_s;;

DESCRIPTION
  XXmmCClliippbbooaarrddUUnnlloocckk unlocks the	clipboard, enabling it to be accessed by
  other	applications.

  If multiple calls to XXmmCClliippbbooaarrddLLoocckk have occurred, the same number of
  calls	to XXmmCClliippbbooaarrddUUnnlloocckk is	necessary to unlock the	clipboard, unless
  _r_e_m_o_v_e__a_l_l__l_o_c_k_s is set to True.

  _d_i_s_p_l_a_y     Specifies	a pointer to the DDiissppllaayy structure that	was returned
	      in a previous call to XXOOppeennDDiissppllaayy or XXttDDiissppllaayy.

  _w_i_n_d_o_w      Specifies	a widget's window ID that relates the application
	      window to	the clipboard.	The widget's window ID can be
	      obtained by using	XXttWWiinnddooww.  The same application	instance
	      should pass the same window ID to	each of	the clipboard func-
	      tions that it calls.

  _r_e_m_o_v_e__a_l_l__l_o_c_k_s
	      When True, indicates that	all nested locks should	be removed.
	      When False, indicates that only one level	of lock	should be
	      removed.

RETURN VALUE

  CClliippbbooaarrddSSuucccceessss
	      The function is successful.

  CClliippbbooaarrddFFaaiill
	      The function failed because the clipboard	was not	locked or was
	      locked by	another	application.

RELATED	INFORMATION
  XXmmCClliippbbooaarrddCCaanncceellCCooppyy((33XX)), XXmmCClliippbbooaarrddCCooppyy((33XX)), XXmmCClliippbbooaarrddEEnnddCCooppyy((33XX)),
  XXmmCClliippbbooaarrddEEnnddRReettrriieevvee((33XX)), XXmmCClliippbbooaarrddIInnqquuiirreeCCoouunntt((33XX)),
  XXmmCClliippbbooaarrddIInnqquuiirreeFFoorrmmaatt((33XX)),	XXmmCClliippbbooaarrddIInnqquuiirreeLLeennggtthh((33XX)),
  XXmmCClliippbbooaarrddIInnqquuiirreePPeennddiinnggIItteemmss((33XX)), XXmmCClliippbbooaarrddLLoocckk((33XX)),
  XXmmCClliippbbooaarrddRReeggiisstteerrFFoorrmmaatt((33XX)), XXmmCClliippbbooaarrddRReettrriieevvee((33XX)),
  XXmmCClliippbbooaarrddSSttaarrttCCooppyy((33XX)), XXmmCClliippbbooaarrddSSttaarrttRReettrriieevvee((33XX)),
  XXmmCClliippbbooaarrddUUnnddooCCooppyy((33XX)), and XXmmCClliippbbooaarrddWWiitthhddrraawwFFoorrmmaatt((33XX)).






