% method of class @parameter
% 
% (c) 2003-2008, University of Cambridge
% Maintained by Tom Walters (tcw24@cam.ac.uk), written by Stefan Bleeck (stefan@bleeck.de)
% http://www.pdn.cam.ac.uk/cnbh/aim2006/tools/parameter
% $Date: 2008-06-10 18:00:16 +0100 (Tue, 10 Jun 2008) $

function param=sethandle(param,text,hand,inbox,handle_nr)
% sets the handle of this item. handles_nr is usually 1 but can be 2 in
% cases when more then one object is on the screen (float with unit,
% filename...)

cont=param.entries;
nrent=length(cont);

if nargin<5
    handle_nr=1;
end

if nargin<4
    inbox='all';
end

nr=getentrynumberbytext(param,text,inbox);
if nr>0
    param.entries{nr}.handle{handle_nr}=hand;
    return
else
    val='sethandle: error, the entry does not exist';
end
