Ajouter une méthode IDL

L’Assistant Ajouter une méthode IDL ajoute une méthode à une interface IDL (Interface Definition Library), comme dans un projet ATL contenant un fichier IDL. Cet Assistant n’est pas disponible dans les projets qui prennent en charge MFC.

Cet Assistant diffère de l’Assistant Ajout de méthode et de l’Assistant Ajout de méthode MFC IDL sur les plans suivants :

• L’Assistant Ajout de méthode ajoute une méthode à une interface dans votre projet et peut mettre à jour la classe associée à l’interface.
• L’Assistant Ajout de méthode MFC IDL est spécifique aux projets MFC, ActiveX ou ATL qui prennent en charge MFC.

Ajouter une méthode à votre interface IDL

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

2. Dans le volet Affichage de classes, développez le nœud du projet pour afficher l’interface IDL (fichier .idl) à 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>Ajouter une méthode.

5. Dans l’Assistant Ajout de méthode IDL, entrez les informations permettant de créer la méthode.

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

Liste des éléments d’interface utilisateur

La section suivante décrit l’interface de l’Assistant que vous allez utiliser pour ajouter une méthode :

• Nom de la méthode

  Indiquez un nom pour la méthode.

• Type de retour

  Type de données retourné par la méthode. La méthode standard pour retourner des codes d’erreur à partir de méthodes définies dans une interface est avec un HRESULT.

  Le tableau suivant décrit les différents types d’interfaces auxquelles vous pouvez ajouter une méthode et le type de retour autorisé. Pour les interfaces doubles et personnalisées, le type de retour doit être HRESULT et l’Assistant ne vous permet pas de le modifier.

  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-le dans la liste déroulante.
  Dispinterface	Fournissez votre propre type de retour ou sélectionnez-le dans la liste déroulante.

• Paramètres

  Affiche les paramètres, modificateurs et types de la méthode.

• +

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

• x

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

• Déduire les valeurs des paramètres d’entrée/de sortie à partir du type

  Insère l’attribut [in] ou [out] en fonction du type du paramètre.

• Définir le dernier paramètre en tant que valeur &retournée (retval)

  Le dernier paramètre sera traité comme la valeur de retour de la méthode.

• Attributs

  Les attributs suivants sont également décrits dans la référence MIDL.

  • id

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

  • call_as

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

  • 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.

  • helpstring

    Spécifie la chaîne de caractères utilisée pour décrire l’élément auquel elle s’applique. Pour plus d’informations, consultez helpstring.

• Attributs supplémentaires

  • hidden

    Indique que l’élément existe, mais qu’il ne doit pas être affiché dans un navigateur orienté utilisateur. Pour plus d’informations, consultez hidden.

  • local

    Spécifie qu’une interface ou une fonction n’est pas distante. Pour plus d’informations, consultez local.

  • restricted

    Spécifie qu’une bibliothèque ou un membre d’un module, d’une interface ou d’une dispinterface ne peuvent pas être appelés arbitrairement. Pour plus d’informations, consultez restricted.

  • source

    Indique qu’un membre d’un coclass, d’une propriété ou d’une méthode est une source d’événements. Pour un membre d’un coclass, cet attribut signifie que le membre est appelé plutôt qu’implémenté. Pour plus d’informations, consultez source.

Voir aussi

Assistant Ajout de méthode
Assistant Ajout de méthode MFC IDL