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
En el menú Ver, seleccione Vista de clases.
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.
En el menú contextual, seleccione Agregar>Agregar propiedad.
En el asistente para Agregar propiedad IDL MFC, proporcione la información para crear la propiedad.
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
On
NombreDePropiedadChanged
. 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
esGet
NombreDePropiedad. 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
esSet
NombreDePropiedad. 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 propiedadesCaption
,hWnd
oText
.Get/Set (métodos) Especifica que la propiedad se agrega como las funciones Get
NombreDePropiedad ySet
NombreDePropiedad, 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 funcionesGet
ySet
.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
property
Nombre 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
Comentarios
https://aka.ms/ContentUserFeedback.
Próximamente: A lo largo de 2024 iremos eliminando gradualmente GitHub Issues como mecanismo de comentarios sobre el contenido y lo sustituiremos por un nuevo sistema de comentarios. Para más información, vea:Enviar y ver comentarios de