Compartir a través de


Adición de un método IDL

El Asistente para agregar un método IDL agrega un método a una interfaz de biblioteca de definiciones de interfaz (IDL), como en un proyecto ATL que contiene un archivo IDL. Este asistente no está disponible en proyectos que admiten MFC.

Este asistente difiere del Asistente para agregar métodos y del Asistente para agregar método IDL MFC en los siguientes aspectos:

  • El Asistente para agregar método agrega un método a una interfaz del proyecto y puede actualizar la clase asociada a la interfaz.
  • El Asistente para agregar método IDL MFC es específico de los proyectos MFC, ActiveX o ATL que admiten MFC.

Adición de un método a la interfaz IDL

  1. En el menú Ver, seleccione Vista de clases.

  2. En el panel Vista de clases, expanda el nodo del proyecto para mostrar la interfaz IDL (archivo .idl) a la que quiere agregar el método.

  3. Haga clic con el botón derecho en el nombre de la interfaz.

  4. En el menú contextual, seleccione Agregar>Agregar método.

  5. En el Asistente para agregar un método IDL, proporcione la información para crear el método.

  6. Seleccione Aceptar para agregar el método.

Lista de elementos de la interfaz de usuario

En la sección siguiente se describe la interfaz del asistente que usará para agregar un método:

Screenshot of adding a method using the wizard. Shows two parameters: [ in ] int i and [ in ] float f. Return type is HRESULT. Infer in out parameter values from type is selected.

  • Nombre del método

    Proporcione un nombre para el método.

  • Tipo de valor devuelto

    El tipo de datos devuelto por el método. La manera estándar de devolver códigos de error de los métodos definidos en una interfaz es con un HRESULT.

    En la tabla siguiente se describen los diferentes tipos de interfaces a los que puede agregar un método y el tipo de valor devuelto permitido. Para las interfaces duales y personalizadas, el tipo de valor devuelto debe ser HRESULT, y el asistente no le permitirá cambiarlo.

    Tipo de interfaz Tipo de valor devuelto
    Interfaz dual HRESULT. No se puede cambiar.
    Interfaz personalizada HRESULT. No se puede cambiar.
    Interfaz personalizada local Proporcione un tipo de valor devuelto propio o selecciónelo en la lista desplegable.
    Interfaz dispinterface Proporcione un tipo de valor devuelto propio o selecciónelo en la lista desplegable.
  • Parámetros

    Muestra los parámetros, modificadores y tipos del método.

  • +

    Agregue un parámetro. En Parámetros, escriba el tipo de parámetro, el nombre y los modificadores. Por ejemplo, [in] int i, y seleccione Aceptar.

  • x

    Quita el parámetro seleccionado de la lista Parámetros.

  • Inferir valores de parámetros de entrada/salida de los tipos

    Inserta el atributo [in] o [out] en función del tipo de parámetro.

  • Establecer el último parámetro como valor devuelto (retval)

    El último parámetro se tratará como el valor devuelto del método.

  • Atributos

    Los atributos siguientes también se describen en la Referencia de MIDL.

    • id

      Establece el id. numérico que identifica el método. Para obtener más información, vea id.

    • call_as

      Especifica el nombre del método remoto al que asignar este método local. Para obtener más información, vea call_as.

    • helpcontext

      Especifica un id. contextual que permite al usuario ver información sobre este método en el archivo de ayuda. Para obtener más información, vea helpcontext.

    • helpstring

      Especifica la cadena de caracteres que se usa para describir el elemento al que se aplica. Para obtener más información, vea helpstring.

  • Atributos adicionales

    • hidden

      Indica que el elemento existe, pero que no se debe mostrar en un explorador orientado al usuario. Para obtener más información, vea hidden.

    • local

      Especifica que una interfaz o función no es remota. Para más información, consulte local.

    • restricted

      Especifica que no se puede llamar arbitrariamente a una biblioteca o miembro de un módulo, interfaz o dispinterface. Para obtener más información, vea restricted.

    • source

      Indica que un miembro de un coclass, una propiedad o un método es un origen de eventos. Para un miembro de coclass, este atributo indica que se llama al miembro en lugar de implementarlo. Para obtener más información, vea source.

Vea también

Asistente para agregar un método
Asistente para agregar método IDL MFC