ITAutomatedPhoneControl ::p ut_AutoKeypadTones, méthode (tapi3if.h)

Article
03/04/2024

La méthode put_AutoKeypadTones définit la propriété AutoKeypadTones pour ce téléphone. Lorsque cette fonctionnalité est activée, un ton numérique est automatiquement lu chaque fois qu’un bouton de clavier est enfoncé.

Syntaxe

HRESULT put_AutoKeypadTones(
  [in] VARIANT_BOOL fEnabled
);

Paramètres

[in] fEnabled

Si VARIANT_TRUE, la génération automatique de tonalité du clavier du téléphone est activée. Si VARIANT_FALSE, la génération de tonalité du clavier est désactivée. La valeur par défaut est VARIANT_TRUE.

Valeur retournée

Si la méthode réussit, retourne S_OK. Sinon, il retourne une valeur d’erreur.

Remarques

Si l’appareil téléphonique signale qu’un bouton appuie sur PBS_DOWN, le ton est lu jusqu’à ce que l’appareil signale un événement PBS_UP ou jusqu’à ce que la durée minimale ait expiré, selon la plus longue des deux. (La durée minimale est déterminée par la propriété AutoKeypadTonesMinimumDuration .)

La génération de tonalité du clavier se produit uniquement lorsque le téléphone est désactivé. Si une autre tonalité, telle que la sonnerie, est en cours de lecture, la tonalité du clavier interrompt cette tonalité et la restaure automatiquement une fois la tonalité du pavé numérique terminée.

La propriété AutoKeypadTones fonctionne uniquement lorsque la valeur de la propriété PhoneHandlingEnabled est VARIANT_TRUE. Vous pouvez définir la propriété AutoKeypadTones à tout moment. La reconfiguration prend effet la prochaine fois que le bouton du clavier du téléphone est enfoncé.