POPLISTFUNC
Questo callback è fornito Funzione SccPopulateList dall'IDE e utilizzato dal plug-in controllo del codice sorgente per aggiornare un elenco di file o di directory (anche forniti a SccPopulateList la funzione.
Quando un utente sceglie il comando di ottenere IDE, l'ide visualizza una casella di riepilogo di tutti i file che l'utente può ottenere. Sfortunatamente, l'ide non conosce l'elenco esatto di tutti i file che l'utente possa ottenere; solo il plug-in ha questo elenco. Se altri utenti hanno aggiunto i file al controllo del codice sorgente progetto, questi file devono trovarsi nell'elenco, ma l'ide non sa su di essi. L'ide compila un elenco dei file che prevede che l'utente possa ottenere. Prima di visualizzare questo elenco all'utente, chiama Funzione SccPopulateList, che fornisce il plug-in controllo del codice sorgente una probabilità aggiungere ed eliminare i file dall'elenco.
Signature
Il plug-in controllo del codice sorgente modifica l'elenco chiamando una funzione Ido-implementata con il prototipo indicato di seguito:
typedef BOOL (*POPLISTFUNC) (
LPVOID pvCallerData,
BOOL fAddRemove,
LONG nStatus,
LPSTR lpFileName
);
Parametri
pvCallerData
Il parametro di pvCallerData passato dal chiamante (IDE) di Funzione SccPopulateList. Il plug-in controllo del codice sorgente non deve presupporre non sul contenuto di questo parametro.fAddRemove
Se TRUE, lpFileName è un file che devono essere aggiunti all'elenco dei file. Se FALSE, lpFileName è un file da eliminare dall'elenco dei file.nStatus
Lo stato di lpFileName (una combinazione di bit di SCC_STATUS ; vedere Enumeratore del codice dello stato del file per informazioni dettagliate).lpFileName
Percorso completo della directory del nome file da aggiungere o eliminare dall'elenco.
Valore restituito
Valore |
Descrizione |
|---|---|
TRUE |
il plug-in può continuare a chiamare questa funzione. |
FALSE |
Vi è stato un problema sul lato dell'IDE (ad esempio una situazione memoria insufficiente). Il plug-in deve interrompere l'operazione. |
Note
Per ogni file a cui il plug-in controllo del codice sorgente desidera aggiungere o eliminare dall'elenco dei file, chiama questa funzione, passando in lpFileName. Il flag di fAddRemove indica un nuovo file da aggiungere all'elenco o in un file obsoleti per l'eliminazione. Il parametro di nStatus fornisce lo stato del file. Quando il plug-in di SCC è stata completata l'aggiunta e l'eliminazione dei file, Funzione SccPopulateList viene restituito dalla chiamata.
Nota
Il bit di possibilità di SCC_CAP_POPULATELIST è obbligatoria per Visual Studio.
Vedere anche
Riferimenti
Enumeratore del codice dello stato del file