Ajouter une méthode IDL MFC

L’Assistant Add IDL MFC Method ajoute une méthode à une interface IDL (Interface Definition Library) définie dans votre projet MFC (Microsoft Framework Class). Si le projet contient une classe associée à l’interface, l’Assistant ajoute également la méthode à la classe.

Pour utiliser cet Assistant, vous devez être dans un projet MFC, un projet ActiveX ou un projet ATL qui prend en charge MFC. Par exemple, si vous avez un projet de contrôle Microsoft ActiveX, vous pouvez utiliser la procédure suivante pour ajouter une méthode à une interface IDL dans la solution.

Cet Assistant diffère de l’Assistant Add Method (qui ajoute une méthode à une interface IDL) de la manière suivante :

• Il est spécifique aux projets MFC, ActiveX ou ATL qui prennent en charge MFC. Pour les projets ATL qui ne prennent pas en charge MFC, seul l’Assistant Ajout de méthode est disponible.

• Il ajoute les entrées suivantes si une carte Dispatch est trouvée dans le projet :

  BEGIN_DISPATCH_MAP(CMFCApplication2Doc, CDocument)
      DISP_FUNCTION_ID(CMFCApplication2Doc, "methodName", dispidmethodName, internalName, VT_EMPTY, VTS_NONE)
  END_DISPATCH_MAP()
  

• Il génère l’implémentation de méthode associée suivante :

  void CMFCApplication2Doc::internalName()
  {
       AFX_MANAGE_STATE(AfxGetAppModuleState());
       // TODO: Add your dispatch handler code here
  }
  

Ajouter une méthode à une interface

1. Dans le menu Affichage, sélectionnez Affichage de classes.

2. Dans Affichage de classes, développez le nœud du projet pour afficher l’interface à laquelle vous souhaitez ajouter la méthode.

3. Cliquez avec le bouton droit sur le nom de l’interface.

4. Dans le menu contextuel, sélectionnez Ajouter , puis Ajouter une méthode.

5. Dans l’Assistant Ajouter une méthode MFC IDL, fournissez des informations sur la méthode.

6. Sélectionnez OK pour ajouter la méthode.

Liste d’éléments d’interface utilisateur

La section suivante décrit l’interface utilisateur de l’Assistant Add IDL MFC Method :

• Nom de la méthode

  Définissez le nom de la méthode. Le tableau suivant décrit les options de nom de méthode en fonction du type d’interface :

  Type d’interface	Nom de la méthode
  Interface double ATL, interface personnalisée et interface personnalisée locale	Fournissez votre propre nom de méthode.
  Dispinterface MFC	Fournissez votre propre nom de méthode ou sélectionnez un nom de méthode dans la liste. Si vous sélectionnez un nom dans la liste, le type de retour approprié apparaît dans le type de retour et ne peut pas être modifié.
  Dispinterface du contrôle ActiveX MFC	Fournissez votre propre nom de méthode ou sélectionnez l’une des méthodes de stock : DoClick ou Refresh. Pour plus d’informations sur les méthodes de stock, consultez contrôles ActiveX MFC : Ajout de méthodes de stock.

• Nom interne

  Disponible uniquement lorsque le type de méthode est personnalisé. Le nom interne est le nom qui sera utilisé dans le mappage de répartition, le fichier d’en-tête (.h) et le fichier d’implémentation (.cpp). Par défaut, ce nom est identique au Nom de la méthode. Il est ajouté à la dispinterface MFC.

  Si vous ajoutez la méthode à un contrôle MFC ou MFC ActiveX dispinterface, vous pouvez modifier le nom de la méthode comme décrit dans le tableau suivant :

  Type d'interface	Nom interne
  Interface double ATL, interface personnalisée et interface personnalisée locale	Non disponible.
  Dispinterface MFC	Définissez le nom de la méthode par défaut. Vous pouvez modifier le nom interne.
  Dispinterface du contrôle ActiveX MFC	Vous pouvez définir le nom interne uniquement pour les méthodes personnalisées. Les méthodes stock n’utilisent pas de nom interne.

• Type de retour

  Type de données retourné par la méthode. Le type de retour standard pour les méthodes d’interface est HRESULT.

  Si l’interface est une interface double ou une interface personnalisée, seul le HRESULT type de retour est autorisé.

  Vous pouvez définir le type de données en fonction du type d’interface auquel la méthode est ajoutée, comme décrit dans le tableau suivant :

  Type d’interface	Type de retour
  Interface double	HRESULT. Non modifiable.
  Interface personnalisée	HRESULT. Non modifiable.
  Interface personnalisée locale	Fournissez votre propre type de retour ou sélectionnez-en un dans la liste.
  Dispinterface	Fournissez votre propre type de retour ou sélectionnez-en un dans la liste.
  Dispinterface du contrôle ActiveX MFC	Si vous implémentez une méthode stock, le type de retour est défini sur la valeur appropriée et n’est pas modifiable. Si vous sélectionnez une méthode dans la liste des noms de méthode, puis sélectionnez Personnalisé sous Type de méthode Select, sélectionnez un type de retour dans la liste.

• Type de méthode

  Disponible uniquement pour les contrôles ActiveX MFC. Non disponible si vous avez fourni un nom de méthode dans nom de méthode plutôt que de sélectionner une méthode dans la liste.

  Si vous sélectionnez l’une des méthodes de la liste des noms de méthode, dans la liste déroulante Type de méthode, sélectionnez l’implémentation stock ou personnalisée . La sélection de la méthode affecte le type de retour et l’implémentation de méthode fourni par l’Assistant, comme décrit dans le tableau suivant :

  Type de méthode	Description
  Boursier	Valeur par défaut. Insère l’implémentation par défaut de la méthode sélectionnée dans la liste des noms de méthode. Le Type de retour n’est pas modifiable si vous sélectionnez Stock.
  Personnalisée	Vous fournissez une implémentation personnalisée pour la méthode sélectionnée dans le nom de la méthode. Vous pouvez fournir votre propre type de retour ou en sélectionner un dans la liste des types de retour.

• Paramètres

  Affiche les paramètres, modificateurs et types de la méthode. L’Assistant met à jour la liste Paramètres lorsque vous ajoutez des paramètres.

• +

  Ajoutez un paramètre. Dans Paramètres, tapez le type de paramètre, le nom et les modificateurs. Par exemple, int x. Ensuite, choisissez OK.

  Si vous ne fournissez pas de nom de paramètre, l’Assistant ignore les sélections de type de paramètre et, pour les projets ATL, les attributs de paramètre sont également ignorés.

• x

  Supprime le paramètre sélectionné de la liste Paramètres.

• Icône de crayon

  Modifiez le paramètre sélectionné.

• id

  Définit l’ID numérique qui identifie la méthode. Pour plus d’informations, consultez id la référence MIDL.

• call_as

  Spécifie le nom de la méthode distante à mapper à cette méthode locale. Pour plus d’informations, consultez call_as la référence MIDL.

• helpcontext

  Spécifie un ID de contexte qui permet à l'utilisateur de voir des informations sur cette méthode dans le fichier d’aide. Pour plus d’informations, consultez helpcontext la référence MIDL.

• helpstring

  Spécifie un texte qui décrit l’élément associé. Par défaut, son nom de méthode. Pour plus d’informations, consultez helpstring dans la référence MIDL.

Voir aussi

Assistant Ajout de méthode
Assistant Ajout d’une méthode IDL
Assistants MFC et boîtes de dialogue