PHONEBUTTONFUNCTION_ Constants
The PHONEBUTTONFUNCTION_ scalar constants describe the functions commonly assigned to buttons on telephone sets.
-
PHONEBUTTONFUNCTION_UNKNOWN
-
A "dummy" function assignment that indicates that the exact function of the button is unknown or has not been assigned.
-
PHONEBUTTONFUNCTION_CONFERENCE
-
Initiates a conference call or adds a call to a conference call.
-
PHONEBUTTONFUNCTION_TRANSFER
-
Initiates a call transfer or completes the transfer of a call.
-
PHONEBUTTONFUNCTION_DROP
-
Drops the active call.
-
PHONEBUTTONFUNCTION_HOLD
-
Places the active call on hold.
-
PHONEBUTTONFUNCTION_RECALL
-
Unholds a call.
-
PHONEBUTTONFUNCTION_DISCONNECT
-
Disconnects a call, such as after initiating a transfer.
-
PHONEBUTTONFUNCTION_CONNECT
-
Reconnects a call that is on consultation hold.
-
PHONEBUTTONFUNCTION_MSGWAITON
-
Turns on a message waiting lamp.
-
PHONEBUTTONFUNCTION_MSGWAITOFF
-
Turns off a message waiting lamp.
-
PHONEBUTTONFUNCTION_SELECTRING
-
Allows the user to select the ring pattern of the phone.
-
PHONEBUTTONFUNCTION_ABBREVDIAL
-
The number to be dialed will be indicated using a short, abbreviated number consisting of one digit or a few digits.
-
PHONEBUTTONFUNCTION_FORWARD
-
Initiates or changes call forwarding to this phone.
-
PHONEBUTTONFUNCTION_PICKUP
-
Picks up a call ringing on another phone.
-
PHONEBUTTONFUNCTION_RINGAGAIN
-
Initiates a request to be notified if a call cannot be completed normally because of a busy signal or no answer.
-
PHONEBUTTONFUNCTION_PARK
-
Parks the active call on another phone, placing it on hold there.
-
PHONEBUTTONFUNCTION_REJECT
-
Rejects an incoming call before the call has been answered.
-
PHONEBUTTONFUNCTION_REDIRECT
-
Redirects an incoming call to another extension before the call has been answered.
-
PHONEBUTTONFUNCTION_MUTE
-
Mutes the phone's microphone device.
-
PHONEBUTTONFUNCTION_VOLUMEUP
-
Increases the volume of audio through the phone's handset speaker or speakerphone.
-
PHONEBUTTONFUNCTION_VOLUMEDOWN
-
Decreases the volume of audio through the phone's handset speaker or speakerphone.
-
PHONEBUTTONFUNCTION_SPEAKERON
-
Turns the phone's external speaker on.
-
PHONEBUTTONFUNCTION_SPEAKEROFF
-
Turns the phone's external speaker off.
-
PHONEBUTTONFUNCTION_FLASH
-
Generates the equivalent of an onhook/offhook sequence. A flash typically indicates that any digits typed next are to be understood as commands to the switch. On many switches, places an active call on consultation hold.
-
PHONEBUTTONFUNCTION_DATAON
-
Indicates that the next call is a data call.
-
PHONEBUTTONFUNCTION_DATAOFF
-
Indicates that the next call is not a data call.
-
PHONEBUTTONFUNCTION_DONOTDISTURB
-
Places the phone in "do not disturb" mode; incoming calls receive a busy signal or are forwarded to an operator or voice mail system.
-
PHONEBUTTONFUNCTION_INTERCOM
-
Connects to the intercom to broadcast a page.
-
PHONEBUTTONFUNCTION_BRIDGEDAPP
-
Selects a particular appearance of a bridged address.
-
PHONEBUTTONFUNCTION_BUSY
-
Makes the phone appear "busy" to incoming calls.
-
PHONEBUTTONFUNCTION_CALLAPP
-
Selects a particular call appearance.
-
PHONEBUTTONFUNCTION_DATETIME
-
Causes the phone to display current date and time; this information would be sent by the switch.
-
PHONEBUTTONFUNCTION_DIRECTORY
-
Calls up directory service from the switch.
-
PHONEBUTTONFUNCTION_COVER
-
Forwards all calls destined for this phone to another phone used for coverage.
-
PHONEBUTTONFUNCTION_CALLID
-
Requests display of caller ID on the phone's display.
-
PHONEBUTTONFUNCTION_LASTNUM
-
Redials last number dialed.
-
PHONEBUTTONFUNCTION_NIGHTSRV
-
Places the phone in the mode it is configured for during night hours.
-
PHONEBUTTONFUNCTION_SENDCALLS
-
Sends all calls to another phone used for coverage; same as PHONEBUTTONFUNCTION_COVER.
-
PHONEBUTTONFUNCTION_MSGINDICATOR
-
Controls the message indicator lamp.
-
PHONEBUTTONFUNCTION_REPDIAL
-
Repertory dialing—the number to be dialed is provided as a shorthand following pressing of this button.
-
PHONEBUTTONFUNCTION_SETREPDIAL
-
Programs the shorthand-to-phone number mappings accessible by means of repertory dialing (the "REPDIAL" button).
-
PHONEBUTTONFUNCTION_SYSTEMSPEED
-
The number to be dialed is provided as a shorthand following pressing of this button. The mappings for system speed dialing are configured inside the switch.
-
PHONEBUTTONFUNCTION_STATIONSPEED
-
The number to be dialed is provided as a shorthand following pressing of this button. The mappings for station speed dialing are specific to this station (phone).
-
PHONEBUTTONFUNCTION_CAMPON
-
Camps-on an extension that returns a busy indication. When the remote station returns to idle, the phone will be rung with a distinctive patterns. Picking up the local phone reinitiates the call.
-
PHONEBUTTONFUNCTION_SAVEREPEAT
-
When pressed while a call or call attempt is active, it will remember that call's number or command. When pressed while no call is active (such as during dial tone), it repeats the most saved command.
-
PHONEBUTTONFUNCTION_QUEUECALL
-
Queues a call to an outside number after it encounters a trunk-busy indication. When a trunk becomes later available, the phone will be rung with a distinctive pattern. Picking up the local phone reinitiates the call.
-
PHONEBUTTONFUNCTION_NONE
-
A "dummy" function assignment that indicates that the button does not have a function.
Values in the range 0x80000000 to 0xFFFFFFFF can be assigned for device-specific extensions; values in the range 0x00000000 to 0x7FFFFFFF are reserved.
The PHONEBUTTONFUNCTION_ constants have values commonly found on current telephone sets. These button functions can be used to invoke the corresponding function from the switch using lineDevSpecificFeature. Note that TAPI does not define the semantics of the button functions; it only provides access to the corresponding function. The behavior associated with each of the function values above is generic and can vary based on the telephony environment.