Asistente para agregar métodos
Actualización: noviembre 2007
Este asistente se utiliza para agregar un método a una interfaz. En función del tipo de proyecto o de interfaz al que se esté agregando el método, el asistente mostrará opciones distintas.
Nombres
Tipo de valor devuelto
El tipo de datos devuelto por el método. Se recomienda HRESULT para todos los tipos de interfaz, ya que proporciona una manera estándar de devolver errores.Tipo de interfaz
Descripción
Interfaz dual
HRESULT. No se puede cambiar.
Interfaz personalizada
HRESULT. No se puede cambiar.
Interfaz personalizada local
Especifique su propio tipo de valor devuelto o selecciónelo de la lista.
Dispinterface
Especifique su propio tipo de valor devuelto o selecciónelo de la lista.
Dispinterface de controles ActiveX de MFC
Si implementa un método estándar, el tipo de valor devuelto utilizará el valor apropiado y no se podrá cambiar. Si selecciona un método de la lista Nombre de método y, después de activar Seleccione el tipo de método, hace clic en Personalizado, seleccionará un tipo de valor devuelto de la lista.
Nombre de método
Permite establecer el nombre del método.Tipo de interfaz
Descripción
Interfaz dual ATL, interfaz personalizada e interfaz personalizada local
Especifique su propio nombre de método.
Dispinterface de MFC
Especifique su propio nombre de método o seleccione uno de los nombres de método sugeridos en la lista. Si selecciona un nombre de la lista, el valor apropiado aparecerá en el cuadro Tipo de valor devuelto y no se podrá cambiar.
Dispinterface de controles ActiveX de MFC
Especifique el suyo propio o seleccione cualquiera de los métodos estándar DoClick o Refresh. Vea Controles ActiveX de MFC: agregar métodos estándar para obtener más información.
Tipo de método
Esta opción sólo estará disponible para controles ActiveX de MFC. Si, en lugar de seleccionar un método de la lista, se especifica un nombre de método en el cuadro Nombre de método, este cuadro no estará disponible.Si selecciona uno de los métodos de la lista Nombre de método, elija entre una implementación estándar o una implementación personalizada.
Tipo de método
Descripción
Estándar
Es la opción predeterminada. Inserta la implementación estándar del método seleccionado en la lista Nombre de método. Si selecciona Estándar, no podrá cambiar Tipo de valor devuelto.
Personalizada
Inserta una implementación de código auxiliar del método seleccionado en la lista Nombre de método. Con los tipos de métodos personalizados, podrá especificar su propio tipo de valor devuelto o seleccionar uno de la lista Tipo de valor devuelto.
Nombre interno
Disponible únicamente para métodos personalizados agregados a una interfaz dispinterface de MFC. Permite definir el nombre utilizado en el mapa de envíos, el archivo de encabezado (.h) y el archivo de implementación (.ccp). De forma predeterminada, este nombre coincidirá con el Nombre de método. El nombre de método podrá cambiarse si se está trabajando con una interfaz dispinterface de MFC o si se está agregando un método personalizado a una interfaz dispinterface de controles ActiveX de MFC.Tipo de interfaz
Descripción
Interfaz dual ATL, interfaz personalizada e interfaz personalizada local
No está disponible
Dispinterface de MFC
De forma predeterminada, se utilizará el nombre de método. El nombre interno podrá editarse.
Dispinterface de controles ActiveX de MFC
El nombre interno sólo podrá definirse con métodos personalizados. Los métodos estándar no utilizan nombre interno.
Atributos del parámetro
Permite definir atributos adicionales para el parámetro especificado en Nombre de parámetro.Atributo de parámetro
Descripción
Combinaciones permitidas
In
Indica que el parámetro se pasa del procedimiento de llamada al procedimiento llamado.
Sólo in
in y out
Out
Indica que el parámetro de puntero se devuelve desde el procedimiento llamado al procedimiento de llamada (del servidor al cliente).
Sólo out
in y out
out y retval
Retval
Indica que el parámetro recibe el valor devuelto del miembro.
retval y out
Tipo de parámetro
Permite definir el tipo de datos del parámetro. Selecciónelo en la lista.Nombre de parámetro
Establece el nombre de un parámetro que se va a pasar al método. Después de escribir el nombre, se debe hacer clic en Agregar para agregarlo a la lista de parámetros que se pasarán al método. Si no se especifica un nombre de parámetro, el asistente omitirá las selecciones de atributos de parámetro (sólo ATL) y de Tipo de parámetro efectuadas.Después de hacer clic en Agregar, el nombre de parámetro aparece en la Lista de parámetros.
Nota Si especifica un nombre de parámetro y hace clic en Finalizar antes de hacer clic en Agregar, el parámetro no se agrega al método. Deberá buscar el método e insertar el parámetro de forma manual.
Agregar
Agrega el parámetro especificado en Nombre de parámetro, así como su tipo y sus atributos de parámetro, a la Lista de parámetros. Debe hacer clic en Agregar para agregar un parámetro a la lista.Quitar
Quita de la lista el parámetro seleccionado en Lista de parámetros.Lista de parámetros
Muestra todos los parámetros y sus modificadores y tipos agregados actualmente al método. A medida que se agregan parámetros, el asistente actualiza la Lista de parámetros para mostrar cada parámetro con su modificador y tipo.