\begindata{text,538478848}
\textdsversion{12}
\template{help}
\define{global
}
\chapter{Pushbutton Inset:  A Triggering Mechanism

}
\section{What Pushbutton is

}\leftindent{
The \bold{Pushbutton} inset is a button that resides in the text of a 
document. It can be used by \helptopic{Ness} or \helptopic{Class} 
applications, since it defines a trigger, or subclassed, to produce 
button-like insets that perform various actions.

}
\section{Using Pushbutton

}\leftindent{
The best way to insert a Pushbutton is with the  \italic{\helptopic{Arbcon}} 
 object.  Add the pushbutton object to the list of known Arbcon objects, 
create one, give it a name, then paste it into your document.  Using Ness, you 
can then extend the pushbutton like this:


\leftindent{extend "\italic{yourbuttonname}"

on event "buttonpushed"

	-- your Ness code here

end event

end extend

}
Where "yourbuttonname" is the name you gave the button in the Arbcon.

}
\section{Can I change the way it looks?

}
\leftindent{There is a preference option, the \typewriter{pushbuttonstyle}, 
which you can adjust so that your pushbuttons will look different.  Please see 
the help document on preferences for more information.  You can also change 
the style, label and colors by calling the \typewriter{pushbutton_SetStyle}, 
\typewriter{pushbutton_SetText, pushbutton_SetFGColor }or\typewriter{ 
pushbuttonSetBGColor } methods from Ness or Class. 


Furthermore, there is a user interface to these features, on the "Pushbutton" 
menu card.  The menus are bound as:

\begindata{table,539282952}
\cols 121 247
-	-
| ^Menu Name	| ^Proctable Entry	| 
-	-
| "Set Label	| 'pushbuttonview-set-label-text	| 
| "Set Font	| 'pushbuttonview-set-font	| 
| "Set Style	| 'pushbuttonview-set-style	| 
| "Set Color	| 'pushbuttonview-set-color	| 
-	-
\enddata{table,539282952}
\view{spread,539282952,750,0,0}

}
\section{Program Author}

\leftindent{
Michael McInerny, ITC (address mail to mcinerny+@andrew.cmu.edu).}


\section{Related tools}  


Select (highlight) one of the italicized names and choose "Show Help on 
Selected Word" from the pop-up menu to see the help file for:


\leftindent{\italic{\helptopic{insets}

\helptopic{ez}

\helptopic{arbcon}

\helptopic{ness}

}}

\begindata{bp,537558784}
\enddata{bp,537558784}
\view{bpv,537558784,752,0,0}
Copyright 1992 Carnegie Mellon University and IBM.  All rights reserved.

\smaller{\smaller{$Disclaimer: This software is part of version 6.1 of the 

Andrew User Interface System and is 

the property of IBM, Carnegie Mellon University, 

and the other copyright holders.  The source 

code of this version is for the sole use of 

the individual named in ./config/allsys.h.  

This source code is not to be redistributed.  

Binary object code compiled or derived from 

these sources is not to be distributed to non-

members.  Members may have additional 

distribution rights granted by prior written 

permission of Carnegie Mellon University.



IBM, CARNEGIE MELLON UNIVERSITY, 

AND THE OTHER COPYRIGHT HOLDERS

 DISCLAIM ALL WARRANTIES WITH 

REGARD TO THIS SOFTWARE, INCLUDING 

ALL IMPLIED WARRANTIES OF MERCHANT-

ABILITY AND FITNESS. IN 

NO EVENT SHALL  IBM, CARNEGIE 

MELLON UNIVERSITY, OR ANY OTHER 

COPYRIGHT HOLDER BE LIABLE FOR 

ANY SPECIAL, INDIRECT OR CONSE-

QUENTIAL DAMAGES OR ANY DAMAGES 

WHATSOEVER RESULTING FROM LOSS OF

USE, DATA OR PROFITS, WHETHER IN AN

ACTION OF CONTRACT, NEGLIGENCE OR

OTHER TORTIOUS ACTION, ARISING OUT 

OF OR IN CONNECTION WITH THE USE OR

PERFORMANCE OF THIS SOFTWARE.

 $

}}\enddata{text,538478848}
