Flag di bit usati da comandi specifici
Il comportamento di una serie di funzioni nell'API plug-in del controllo del codice sorgente può essere modificato impostando uno o più bit in un singolo valore. Questi valori sono noti come bitflags. I vari flag di bit usati dall'API plug-in del controllo del codice sorgente sono descritti in dettaglio qui, raggruppati per la funzione che li usa.
Flag estratto
Questo flag può essere impostato per SccAdd o SccCheckin.
| Flag | Valore | Descrizione |
|---|---|---|
SCC_KEEP_CHECKEDOUT |
0x1000 | Mantenere estratto il file. |
Aggiungere flag
Questi flag vengono usati da SccAdd.
| Flag | Valore | Descrizione |
|---|---|---|
SCC_FILETYPE_AUTO |
0x00 | È previsto che il plug-in del controllo del codice sorgente rilevi automaticamente se il file è di testo o binario. |
SCC_FILETYPE_TEXT |
0x01 | Il tipo di file è text. |
SCC_FILETYPE_BINARY |
0x04 | Il tipo di file è binario. Nota:SCC_FILETYPE_TEXT e SCC_FILETYPE_BINARY i flag si escludono a vicenda. Impostare esattamente uno o nessuno dei due. |
SCC_ADD_STORELATEST |
0x02 | Archivia solo la versione più recente (nessun delta). |
Flag diff
SccDiff usa questi flag per definire l'ambito di un'operazione diff. I SCC_DIFF_QD_xxx flag si escludono a vicenda. Se uno di essi viene specificato, non verrà fornito alcun feedback visivo. In una "rapida diff" (QD), il plug-in non determina come il file è diverso, solo se è diverso. Se nessuno di questi flag viene specificato, viene eseguito un "diff visivo" ; vengono calcolate e visualizzate le differenze di file dettagliate. Se il QD richiesto non è supportato, il plug-in passa a quello migliore successivo. Ad esempio, se l'IDE richiede un checksum e il plug-in non lo supporta, il plug-in esegue un controllo full-contents (ancora molto più veloce rispetto a uno schermo visivo).
| Flag | Valore | Descrizione |
|---|---|---|
SCC_DIFF_IGNORECASE |
0x0002 | Ignorare le differenze tra maiuscole e minuscole. |
SCC_DIFF_IGNORESPACE |
0x0004 | Ignorare le differenze di spazio vuoto. Nota: i SCC_DIFF_IGNORECASE flag e SCC_DIFF_IGNORESPACE sono flag facoltativi. |
SCC_DIFF_QD_CONTENTS |
0x0010 | QD confrontando l'intero contenuto del file. |
SCC_DIFF_QD_CHECKSUM |
0x0020 | QD per checksum. |
SCC_DIFF_QD_TIME |
0x0040 | QD per data/ora del file. |
SCC_DIFF_QUICK_DIFF |
0x0070 | Si tratta di una maschera usata per controllare tutti i flag di bit QD. Non deve essere passato a una funzione; i tre bitflag QD si escludono a vicenda. QD indica sempre che non viene visualizzata alcuna interfaccia utente. |
Flag PopulateList
Questo flag viene usato da SccPopulateList nel fOptions parametro .
| Flag | Valore | Descrizione |
|---|---|---|
SCC_PL_DIR |
0x00000001L | L'IDE passa directory, non file. |
Flag PopulateDirList
Questi flag vengono usati da SccPopulateDirList nel fOptions parametro .
| Valore opzione | Valore | Descrizione |
|---|---|---|
| SCC_PDL_ONELEVEL | 0x0000 | Esaminare solo un livello di directory per le directory (impostazione predefinita). |
| SCC_PDL_RECURSIVE | 0x0001 | Esaminare in modo ricorsivo tutte le directory in ogni directory specificata. |
| SCC_PDL_INCLUDEFILES | 0x0002 | Includere i nomi di file nel processo di esame. |
Flag OpenProject
Questi flag vengono usati da SccOpenProject nel dwFlags parametro .
| Valore opzione | Valore | Descrizione |
|---|---|---|
| SCC_OP_CREATEIFNEW | 0x00000001L | Se il progetto non esiste nel controllo del codice sorgente, crearlo. Se questo flag non è impostato, richiedere all'utente di creare il progetto (a meno che non SCC_OP_SILENTOPEN sia specificato il flag). |
| SCC_OP_SILENTOPEN | 0x00000002L | Non chiedere all'utente di creare un progetto; è sufficiente restituire SCC_E_UNKNOWNPROJECT. |
Ottenere i flag
Questi flag vengono usati da SccGet e SccCheckout.
| Flag | Valore | Descrizione |
|---|---|---|
SCC_GET_ALL |
0x00000001L | L'IDE passa directory, non file: recupera tutti i file in queste directory. |
SCC_GET_RECURSIVE |
0x00000002L | L'IDE passa le directory: ottenere queste directory e tutte le relative sottodirectory. |
Valori nOption
Questi flag vengono usati da SccSetOption nel nOption parametro .
| Flag | Valore | Descrizione |
|---|---|---|
SCC_OPT_EVENTQUEUE |
0x00000001L | Impostare lo stato della coda di eventi. |
SCC_OPT_USERDATA |
0x00000002L | Specificare i dati utente per SCC_OPT_NAMECHANGEPFN. |
SCC_OPT_HASCANCELMODE |
0x00000003L | L'IDE può gestire l'annullamento. |
SCC_OPT_NAMECHANGEPFN |
0x00000004L | Impostare un callback per le modifiche al nome. |
SCC_OPT_SCCCHECKOUTONLY |
0x00000005L | Disabilitare il checkout dell'interfaccia utente del controllo del codice sorgente e non impostare la directory di lavoro. |
SCC_OPT_SHARESUBPROJ |
0x00000006L | Aggiungere dal sistema di controllo del codice sorgente per specificare una directory di lavoro. Provare a condividere il progetto associato se è un discendente diretto. |
dwVal bitflags
Questi flag vengono usati da SccSetOption nel dwVal parametro .
| Flag | Valore | Descrizione | Usato dal nOption valore |
|---|---|---|---|
SCC_OPT_EQ_DISABLE |
0x00L | Sospende l'attività della coda di eventi. | SCC_OPT_EVENTQUEUE |
SCC_OPT_EQ_ENABLE |
0x01L | Abilita la registrazione della coda di eventi. | SCC_OPT_EVENTQUEUE |
SCC_OPT_HCM_NO |
0L | (Impostazione predefinita) Non ha alcuna modalità di annullamento; se necessario, il plug-in deve essere fornito. | SCC_OPT_HASCANCELMODE |
SCC_OPT_HCM_YES |
1L | L'IDE gestisce l'annullamento. | SCC_OPT_HASCANCELMODE |
SCC_OPT_SCO_NO |
0L | (Impostazione predefinita) OK per eseguire il check-out dall'interfaccia utente del plug-in; la directory di lavoro è impostata. | SCC_OPT_SCCCHECKOUTONLY |
SCC_OPT_SCO_YES |
1L | Nessun checkout dell'interfaccia utente plug-in, nessuna directory di lavoro. | SCC_OPT_SCCCHECKOUTONLY |