TN020: Convenciones de nomenclatura y de numeración id.
Esta nota describe las convenciones de nomenclatura y de numeración ID que MFC 2,0 utiliza para los recursos, los comandos, cadenas, los controles, las ventanas secundarias.
Diseñan a las convenciones de nomenclatura y de numeración del identificador de MFC para cumplir los requisitos siguientes:
Proporcione un estándar Identificador-que llama coherente al uso de bibliotecas y aplicaciones MFC MFC admitidas por el editor de recursos de Visual C++.Esto permite al programador interpreta el tipo y el origen de un recurso de su identificador
Dé énfasis a la relación 1 a 1 sólida entre ciertos tipos de id.
Ajústese estándares ya utilizadas para llamar a id. en Windows.
Dividir el espacio de la Identificador-numeración.Los números de identificación se pueden asignar el programador, recursos de MFC, Windows, y Visual C++-edited.La creación de particiones adecuado ayudará a evitar la duplicación de números de identificación.
La convención de nomenclatura de prefijo del identificador
Varios tipos de id. pueden aparecer en una aplicación.MFC Identificador-que llama la convención define distintos prefijos para diferentes tipos de recursos.
MFC utiliza el prefijo “IDR_” para indicar un Id. de recurso que se aplica a los tipos de recursos.Por ejemplo, para una ventana determinada de cuadro, MFC utiliza el mismo prefijo “IDR_” para indicar un menú, un acelerador, una cadena y un recurso de icono.La tabla siguiente muestra los diferentes prefijos y su uso:
Prefijo |
Utilice |
|---|---|
IDR_ |
Para los tipos de recursos varias (se utiliza principalmente para los menús, los aceleradores, y las cintas de opciones). |
IDD_ |
Para los recursos de plantilla de cuadro de diálogo (por ejemplo, IDD_DIALOG1). |
IDC_ |
Para los recursos del cursor. |
IDI_ |
Para los recursos de icono. |
IDB_ |
Para los recursos bitmap. |
IDS_ |
Para los recursos de cadena. |
Dentro de un recurso de DIÁLOGO, MFC sigue a estas convenciones:
Prefijo o etiqueta |
Utilice |
|---|---|
IDOK, IDCANCEL |
Para los identificadores. estándar del botón de comando. |
IDC_ |
Para otros controles del cuadro de diálogo. |
El prefijo “IDC_” también se utiliza para los cursores.Este conflicto que llama no suele ser un problema porque una aplicación típica tendrá pocos cursores y muchos controles de cuadro de diálogo.
Dentro de un recurso de menú, MFC sigue a estas convenciones:
Prefijo |
Utilice |
|---|---|
IDM_ |
Para los elementos de menú que no utilizan la arquitectura de comando de MFC. |
ID_ |
Para los comandos de menú que utilizan la arquitectura de comando de MFC. |
Los comandos siguientes a la arquitectura de comando de MFC deben tener un controlador de comandos de ON_COMMAND y pueden tener un controlador de ON_UPDATE_COMMAND_UI .Si estos controladores de comandos siguen la arquitectura de comando de MFC, funcionarán correctamente si se enlazan a un comando de menú, un botón de la barra de herramientas, o un botón de la barra de cuadro de diálogo.El mismo prefijo “ID_” también se utiliza para una cadena de solicitud de menú que se muestra en la barra de mensajes del programa.La mayoría de los elementos de menú en una aplicación deben seguir las convenciones de comando de MFC.Todos los id. de comando estándar (por ejemplo, ID_FILE_NEW) esta convención.
MFC también utiliza “IDP_” como una forma de cadenas (en lugar de “IDS_”).Las cadenas con el prefijo “IDP_” son marcadores, es decir, cadenas utilizadas en cuadros de mensaje. "Cadenas de IDP_ las” pueden contener “%1 " y “%2 " como marcadores de cadenas determinadas por el programa. "Cadenas de IDP_ las” normalmente tienen temas de Ayuda asociado a ellos, y “cadenas de IDS_ las” no. "Cadenas de IDP_ las” se encuentran siempre, y “cadenas de IDS_ las” no pueden localizarse.
La biblioteca MFC también utiliza el prefijo “IDW_” como una forma de id. del control (en lugar de “IDC_”).Estos id. se asignan a las ventanas secundarias como vistas y divisores por las clases del marco.Los id. de la implementación de MFC llevan “AFX_”.
La convención de la Identificador-Numeración
La tabla siguiente se enumeran los intervalos válidos para los id. de tipos específicos.Algunos de los límites son límites técnicos de implementación, y otras son convenciones que están diseñadas para evitar que su id. choquen con Windows predefinieron id. o las implementaciones predeterminadas de MFC.
Se recomienda encarecidamente define todos los id. dentro de los intervalos recomendados.El límite inferior de estos intervalos es 1 porque 0 no se utiliza.Recomendamos utilizar la convención y uso comunes 100 o 101 como la primera identificación
Prefijo |
Tipo de recurso |
Intervalo válido |
|---|---|---|
IDR_ |
varios |
1 0x6FFF directo |
IDD_ |
plantillas de cuadro de diálogo |
1 0x6FFF directo |
IDC_, IDI_, IDB_ |
cursores, iconos, mapas de bits |
1 0x6FFF directo |
IDS_, IDP_ |
cadenas generales |
1 0x7FFF directo |
ID_ |
comandos |
0x8000 con 0xDFFF |
IDC_ |
Controles |
8 0xDFFF directos |
Las razones de estos se extienden los límites:
Por convención, el valor de identificador de 0 no se utiliza.
Las limitaciones de Windows limitan id. true de recursos para ser menor o igual que 0x7FFF.
Las implementaciones internas de MFC reservados dos intervalos: 0x7000 con 0x7FFF y 0xE000 con 0xEFFF.
Varios comandos del sistema de Windows utilizan el intervalo de 0xF000 con 0xFFFF.
Los id. de Control de 1 a 7 están reservados para los controles estándar como IDOK e IDCANCEL.
El intervalo de 0x8000 con 0xFFFF para las cadenas se reserva para marcadores de menú para los comandos.