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:

• 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