Agregar una propiedad IDL MFC

El Asistente para agregar propiedades MFC de IDL agrega una propiedad a una interfaz de biblioteca de definiciones de interfaz (IDL) definida en el proyecto de clase de Microsoft Framework (MFC).

Para usar este asistente, debe estar en un proyecto de MFC, un proyecto ActiveX o un proyecto ATL que admita MFC. Por ejemplo, si tiene un proyecto de control Microsoft ActiveX, puede usar el procedimiento siguiente para agregar una propiedad a una interfaz IDL en la solución.

Adición de una propiedad IDL MFC a la interfaz

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

2. En el panel de Vista de clases, haga clic con el botón derecho en la interfaz a la que quiera agregar la propiedad.

   Nota:

   También puede agregar propiedades a interfaces dispinterface que, a menos que el proyecto tenga atributos, se anidan bajo el nodo de biblioteca.

3. En el menú contextual, seleccione Agregar>Agregar propiedad.

4. En el asistente para Agregar propiedad IDL MFC, proporcione la información para crear la propiedad.

5. Seleccione Aceptar para agregar la propiedad.

Para interfaces dispinterface de MFC:

• Si selecciona Variable miembro como el tipo de implementación, se agregan un método y una variable a la clase que lo implementa.
• Si selecciona Métodos Get/Set como el tipo de implementación, se agregan dos métodos a la clase que lo implementa.

Lista de elementos de la interfaz de usuario

En la sección siguiente se describe el Asistente para Agregar propiedades MFC de IDL:

• Nombre de propiedad

  Establece el nombre de la propiedad.

  Para las interfaces dispinterface de MFC asociadas a controles ActiveX, puede proporcionar un nombre propio o seleccionar un nombre de propiedad estándar en la lista predefinida. Si proporciona un nombre de propiedad propio, el tipo de implementación Estándar no está disponible.

  Para obtener más información sobre una descripción de las propiedades de existencias en la lista, consulte propiedades de existencias.

  Tipo de interfaz	Opciones de nombre de propiedad
  Interfaz dual de ATL, interfaz personalizada e interfaz personalizada local	Se proporciona un nombre de propiedad.
  Interfaz dispinterface de MFC, interfaz dispinterface de control ActiveX MFC	Se proporciona un nombre de propiedad o se selecciona una propiedad estándar de la lista. Si se selecciona una propiedad de la lista, el valor apropiado aparecerá en el cuadro Tipo de propiedad. Este tipo se puede cambiar, según la selección en Tipo de implementación.

• Tipo de propiedad

  Establece el tipo de propiedad que se va a agregar.

  Para las interfaces dispinterface de MFC, proporcione un tipo propio o seleccione en la lista predefinida. Si se proporciona una implementación estándar de una propiedad, Tipo de propiedad se establece en el tipo estándar y no está se puede modificar.

• Nombre de variable

  Establece el nombre de la variable miembro con el que se asocia la propiedad.

  De forma predeterminada, el nombre de la variable es m_PropertyName. Este nombre se puede modificar.

  Este campo solo es visible para los dispinterfaces de MFC y si especifica variable miembro en Tipo de implementación.

• Función de notificación

  Establece el nombre de la función de notificación que se llama si cambia la propiedad.

  De forma predeterminada, el nombre de la función de notificación es OnNombreDePropiedadChanged. Este nombre se puede modificar.

  Este campo solo es visible para los dispinterfaces de MFC y si especifica variable miembro en Tipo de implementación.

• Get (función)

  Establece el nombre de la función para obtener la propiedad.

  De forma predeterminada, el nombre de la función Get es GetNombreDePropiedad. Este nombre se puede modificar.

  Si se elimina el nombre, la función GetNotSupported se inserta en el mapa de envíos de interfaz.

  Este campo solo es visible para los dispinterfaces de MFC y si especifica métodos Get/Set en Tipo de implementación.

• Set (función)

  Establece el nombre de la función para establecer la propiedad.

  De forma predeterminada, el nombre de la función Set es SetNombreDePropiedad. Este nombre se puede modificar.

  Si se elimina el nombre, la función SetNotSupported se inserta en el mapa de envíos de interfaz.

  Este campo solo es visible para los dispinterfaces de MFC y si especifica métodos Get/Set en Tipo de implementación.

• Tipo de implementación

  Especifica cómo implementar la propiedad que se va a agregar.

  Solo disponible para interfaces dispinterface de MFC.

  Tipo de implementación	Descripción
  Estándar	Especifica una implementación por defecto para la propiedad seleccionada en Nombre de la propiedad. Para obtener más información, vea Propiedades estándar. Si especifica Estándar, aparecen atenuados Tipo de propiedad, Tipo de parámetro y Nombre de parámetro.
  Variable miembro	Agrega la propiedad como una variable miembro. Se pueden agregar propiedades personalizadas o la mayoría de las propiedades estándar como variables miembro. Proporciona nombres predeterminados bajo Nombre de variable y Función de notificación. Este nombre se puede modificar. No puede especificar Variable miembro para las propiedades Caption, hWnd o Text.
  Get/Set (métodos)	Especifica que la propiedad se agrega como las funciones GetNombreDePropiedad y SetNombreDePropiedad, de forma predeterminada. Estos nombres aparecen en Get (función) y Set (función). Puede cambiar el valor predeterminado Tipo de propiedad, que pasa un valor para la función Get. Puede especificar parámetros para las funciones Get y Set.

• Propiedad predeterminada

  Establece la propiedad como el valor predeterminado de la interfaz.

  Una interfaz solo puede tener una propiedad predeterminados.

  Una vez especificada la propiedad predeterminada, esta casilla no está disponible para cualquier otra propiedad que agregue a la interfaz. Solo disponible para interfaces dispinterface de MFC.

• Parámetros

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

• +

  Agrega un parámetro. En Parámetros, escriba el tipo de parámetro y el nombre y selección Aceptar. Por ejemplo: int x

• x

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

• Icono de lápiz

  Edita el parámetro seleccionado.

• id

  Establece el id. numérico que identifica la propiedad.

  Esta opción no está disponible para las propiedades de interfaces personalizadas. Para obtener más información, vea id en la Referencia de MIDL.

• helpcontext

  Especifica un id. de contexto que permite al usuario ver información sobre esta propiedad en el archivo de ayuda.

  Para obtener más información, vea helpcontext en la Referencia de MIDL.

• helpstring

  Especifica una cadena de caracteres que se usa para describir el elemento al que se aplica. De forma predeterminada, es propertyNombre de propiedad.

  Para obtener más información, vea helpstring en la Referencia de MIDL.

Propiedades estándar

Si va a agregar una propiedad a un dispinterface de MFC, puede elegir una de las siguientes propiedades de stock en la lista desplegable Nombre de propiedad:

Nombre de propiedad	Descripción
Appearance	Devuelve o establece un valor que determina la apariencia del control. La propiedad Appearance del control puede incluir u omitir efectos de presentación tridimensionales. Se trata de una propiedad ambiente de lectura y escritura.
BackColor	Devuelve o establece la propiedad BackColor de ambiente del control en un color de paleta (RGB) o un color del sistema predefinido. De forma predeterminada, su valor se corresponde al color de primer plano del contenedor del control. Se trata de una propiedad ambiente de lectura y escritura.
BorderStyle	Devuelve o establece el estilo de borde para un control. Se trata de una propiedad de lectura y escritura.
Caption	Devuelve o establece la propiedad Caption del control. El título es el título de la ventana. Caption no tiene ningún tipo de implementación Variable miembro.
Enabled	Devuelve o establece la propiedad Enabled del control. Un control habilitado puede responder a eventos generados por el usuario.
Font	Devuelve o establece la fuente de ambiente del control. Null si el control no tiene ninguna fuente.
ForeColor	Devuelve o establece la propiedad ForeColor de ambiente del control.
hWnd	Devuelve o establece la propiedad hWnd del control. No tiene ningún tipo de implementación Variable miembro.
ReadyState	Devuelve o establece la propiedad ReadyState del control. Un control puede estar no inicializado, inicializado, cargando, interactivo o completo. Para obtener más información, vea READYSTATE en el SDK de Internet.
Text	Devuelve o establece el texto contenido en un control. No tiene ningún tipo de implementación Variable miembro.

Consulte también

Agregar propiedad

Agregar una propiedad IDL