Condividi tramite


TN020: Convenzioni di denominazione e di numerazione ID.

Questa nota vengono descritte le convenzioni di denominazione e di numerazione dell'ID di MFC 2,0 utilizza per le risorse, i controlli, le stringhe, i controlli e le finestre figlio.

MFC convenzioni di denominazione e di numerazione di ID deve per soddisfare i requisiti seguenti:

  • Fornire uno standard ID-denominante coerente utilizzato oltre la libreria MFC e le applicazioni MFC supportate dall'editor di risorse di Visual C++.Ciò rende più semplice l'individuazione il programmatore interpreti il tipo e l'origine di risorsa daID.

  • Evidenziare la stretta relazione 1 a 1 tra determinati tipi di ID.

  • Conformar agli standard già ampiamente utilizzate per denominare gli ID di windows.

  • Partizione dello spazio di ID-numerazione.I numeri ID possono essere assegnati dal programmatore, da MFC, da windows e dalle risorse visive di C++-edited.Suddividere appropriato consentirà di evitare la duplicazione dei numeri ID.

La convenzione di denominazione del prefisso ID.

Diversi tipi di ID possono verificarsi in un'applicazione.La convenzione ID-denominante MFC definisce i prefissi diversi per i tipi di risorsa diversi.

MFC utilizza il prefisso “IDR_„ per indicare un ID della risorsa che si applica ai tipi di risorsa più.Ad esempio, per una finestra cornice specificata, MFC utilizzerà lo stesso prefisso “di IDR_„ per indicare una risorsa del menu, tasto di scelta rapida, della stringa e l'icona.Nella tabella seguente sono illustrati i vari prefissi e il relativo utilizzo:

Prefisso

Utilizzare

IDR_

Per i tipi di risorsa più (soprattutto utilizzati per i menu, i tasti di scelta rapida e le barre multifunzione).

IDD_

Per le risorse modello di finestra di dialogo, ad esempio IDD_DIALOG1).

IDC_

Per le risorse cursore.

IDI_

Per le risorse icona.

IDB_

Per le risorse bitmap.

IDS_

Per le risorse di tipo stringa.

All'interno di una risorsa finestra di dialogo, MFC seguenti convenzioni:

Prefisso o etichetta

Utilizzare

IDOK, IDCANCEL

Per il pulsante di comando standard ID.

IDC_

Per altri controlli della finestra di dialogo.

Il prefisso “di IDC_„ viene utilizzato anche per i cursori.Questo conflitto di denominazione non è in genere un problema perché un'applicazione tipica disporrà di cursori e molti comandi della finestra di dialogo.

All'interno di una risorsa menu, MFC seguenti convenzioni:

Prefisso

Utilizzare

IDM_

Per le voci di menu che non utilizzano l'architettura dei comandi di MFC.

ID_

Per i comandi di menu che utilizzano l'architettura dei comandi di MFC.

I controlli che seguono l'architettura dei comandi di MFC devono disporre di un gestore comando di ON_COMMAND e possono disporre di un gestore di ON_UPDATE_COMMAND_UI .Se questi gestori comandi seguono l'architettura dei comandi di MFC, funzionano correttamente se vengono associati a un comando di menu, a un pulsante della barra degli strumenti, o a un pulsante della barra della finestra di dialogo.Lo stesso prefisso “di ID_„ viene utilizzato anche per una stringa di richiesta di menu visualizzato nella barra dei messaggi del programma.La maggior parte delle voci di menu nell'applicazione devono seguire convenzioni dei comandi MFC.Tutti gli ID di comando standard (ad esempio, ID_FILE_NEW) seguono questa convenzione.

MFC utilizza anche “IDP_„ come un tipo specializzato di stringhe (anziché “IDS_„).Le stringhe con il prefisso “di IDP_„ sono richieste, ovvero, stringhe utilizzate nelle finestre di messaggio. Le stringhe di IDP_„ possono contenere “%1 " e “%2 " come segnaposto delle stringhe sono determinate dal programma. Le stringhe di IDP_„ hanno in genere argomenti della Guida associati e stringhe “di IDS_„ no. Le stringhe di IDP_„ localizzate sempre e stringhe “di IDS_„ potrebbero non essere localizzate.

La libreria MFC utilizza il prefisso “di IDW_„ come un tipo specializzato di ID del controllo (anziché “IDC_„).Ali ID assegnati alle finestre figlio come visualizzazioni e contenitori di separatori da classi del framework.L'implementazione ID MFC è preceduto da “AFX_„.

La convenzione di ID-Numerazione

Nella tabella seguente sono elencati gli intervalli validi per gli ID dei tipi specifici.Alcuni dei limiti sono limiti tecnici di implementazione e altre convenzioni sono progettate per impedire gli ID da provocare conflitti con gli ID predefiniti windows o le implementazioni predefinite di MFC.

È consigliabile definire tutti gli ID negli intervalli consigliati.Il limite inferiore di questi intervalli è 1 perché 0 non viene utilizzato.Si consiglia di utilizzare la convenzione e utilizzi comuni 100 o 101 come prima ID.

Prefisso

Tipo di risorsa

Intervallo valido

IDR_

più

1 0x6FFF diretto

IDD_

modelli della finestra di dialogo

1 0x6FFF diretto

IDC_, IDI_, IDB_

cursori, icone, bitmap

1 0x6FFF diretto

IDS_, IDP_

stringhe generali

1 0x7FFF diretto

ID_

comandi

0x8000 con 0xDFFF

IDC_

Controlli

8 0xDFFF diretti

I motivi per questi elementi variano limiti:

  • Per convenzione, il valore ID di 0 non viene utilizzato.

  • Le limitazioni di implementazione delle finestre limitano la risorsa true ID per essere minore o uguale a 0x7FFF.

  • Le implementazioni interne del framework MFC riserva due intervalli: 0x7000 con 0x7FFF e 0xE000 con 0xEFFF.

  • Diversi controlli del sistema Windows utilizzano l'intervallo di 0xF000 con 0xFFFF.

  • Il controllo gli ID di 1 a 7 sono riservati per i controlli standard come IDOK e IDCANCEL.

  • L'intervallo di 0x8000 con 0xFFFF per le stringhe è riservato per le richieste del menu per i controlli.

Vedere anche

Altre risorse

Note tecniche del numero

Note tecniche per categoria