Contrôles ActiveX MFC : Implémentation avancée des propriétés

Cet article décrit les rubriques relatives à l’implémentation de propriétés avancées dans un contrôle ActiveX.

• Propriétés en lecture seule et en écriture seule

• Renvoi de codes d’erreur à partir d’une propriété

Propriétés en lecture seule et en écriture seule

L’Assistant Ajouter une propriété fournit une méthode rapide et facile pour implémenter des propriétés en lecture seule ou en écriture seule pour le contrôle.

Pour implémenter une propriété en lecture seule ou en écriture seule

1. Chargez votre projet de contrôle.

2. Dans l’Affichage de classes, développez le nœud Bibliothèque de votre contrôle.

3. Cliquez avec le bouton droit sur le nœud d’interface de votre contrôle (le deuxième nœud du nœud de bibliothèque) pour ouvrir le menu contextuel.

4. Dans le menu contextuel, cliquez sur Ajouter , puis sur Ajouter une propriété.

   Cette opération ouvre l'Assistant Ajout de propriété.

5. Dans la zone Nom de la propriété, tapez le nom de votre propriété.

6. Pour le type d’implémentation, cliquez sur Get/Set Methods.

7. Dans la zone Type de propriété , sélectionnez le type approprié pour la propriété.

8. Si vous souhaitez une propriété en lecture seule, désactivez le nom de la fonction Set. Si vous souhaitez une propriété en écriture seule, désactivez le nom de la fonction Get.

9. Cliquez sur Terminer.

Lorsque vous procédez ainsi, l'assistant Ajout de propriété insère la fonction SetNotSupported ou GetNotSupported dans l'entrée de table de dispatch à la place d'une fonction Set ou Get normale.

Si vous souhaitez modifier une propriété existante en lecture seule ou en écriture seule, vous pouvez modifier la carte de répartition manuellement et supprimer la fonction Set ou Get inutile de la classe de contrôle.

Si vous souhaitez qu’une propriété soit en lecture seule ou en écriture seule (par exemple, uniquement lorsque votre contrôle fonctionne dans un mode particulier), vous pouvez fournir la fonction Set ou Get, comme d'habitude, et appeler la fonction SetNotSupported ou GetNotSupported le cas échéant. Par exemple:

void CMyAxUICtrl::SetMyProperty(SHORT newVal)
{
   AFX_MANAGE_STATE(AfxGetStaticModuleState());

   if (m_bReadOnlyMode)   //  some control-specific state
   {
      SetNotSupported();
   }
   else
   {
      m_iPropVal = newVal;   //  set property as normal
      SetModifiedFlag();
   }
}

Cet exemple de code appelle SetNotSupported si le membre de données a la m_bReadOnlyModevaleur TRUE. Si la valeur est FALSE, la propriété est définie sur la nouvelle valeur.

Renvoi de codes d'erreur à partir d'une propriété

Pour indiquer qu’une erreur s’est produite lors de la tentative d’obtention ou de définition d’une propriété, utilisez la COleControl::ThrowError fonction, qui prend un SCODE (code d’état) comme paramètre. Vous pouvez utiliser un SCODE prédéfini ou définir l’un de vos propres. Pour obtenir la liste des SCODEs prédéfinis et des instructions pour définir des SCODEs personnalisés, consultez La gestion des erreurs dans votre contrôle ActiveX dans l’article Contrôles ActiveX : Rubriques avancées.

Les fonctions d’assistance existent pour les SCODEs prédéfinis les plus courants, tels que COleControl ::SetNotSupported, COleControl ::GetNotSupported et COleControl ::SetNotPermitted.

Pour plus d’informations sur la création de rapports d’exceptions dans d’autres domaines du code, consultez COleControl ::FireError et la section Gestion des erreurs dans votre contrôle ActiveX dans l’article Contrôles ActiveX : Rubriques avancées.

Voir aussi

Contrôles ActiveX MFC
Contrôles ActiveX MFC : Propriétés
Contrôles ActiveX MFC : méthodes
Classe COleControl