Bitflags usados por comandos específicos
O comportamento de várias funções na API do plug-in de controle do código-fonte pode ser modificado definindo um ou mais bits em um único valor. Esses valores são conhecidos como bitflags. Os vários sinalizadores de bits usados pela API do Plug-in de Controle do Código-Fonte são detalhados aqui, agrupados pela função que os usa.
Sinalizador de check-out
Esse sinalizador pode ser definido para SccAdd ou SccCheckin.
| Sinalizador | Valor | Descrição |
|---|---|---|
SCC_KEEP_CHECKEDOUT |
0x1000 | Mantenha o arquivo com check-out. |
Adicionar sinalizadores
Esses sinalizadores são usados pelo SccAdd.
| Sinalizador | Valor | Descrição |
|---|---|---|
SCC_FILETYPE_AUTO |
0x00 | Espera-se que o plug-in de controle do código-fonte detecte automaticamente se o arquivo é texto ou binário. |
SCC_FILETYPE_TEXT |
0x01 | O tipo de arquivo é texto. |
SCC_FILETYPE_BINARY |
0x04 | O tipo de arquivo é binário. Nota: SCC_FILETYPE_TEXT e SCC_FILETYPE_BINARY os sinalizadores são mutuamente exclusivos. Defina exatamente um ou nenhum. |
SCC_ADD_STORELATEST |
0x02 | Armazenar apenas a versão mais recente (sem deltas). |
Sinalizadores de comparação
O SccDiff usa esses sinalizadores para definir o escopo de uma operação de comparação. As SCC_DIFF_QD_xxx bandeiras são mutuamente exclusivas. Se qualquer um deles for especificado, nenhum feedback visual deve ser dado. Em um "fast diff" (QD), o plug-in não determina como o arquivo é diferente, apenas se for diferente. Se nenhum desses sinalizadores for especificado, um "diff visual" será feito; As diferenças detalhadas de arquivo são calculadas e exibidas. Se o QD solicitado não for suportado, o plug-in passará para o próximo melhor. Por exemplo, se o IDE solicitar uma soma de verificação e o plug-in não a suportar, o plug-in fará uma verificação de conteúdo completo (ainda muito mais rápido do que uma exibição visual).
| Sinalizador | Valor | Descrição |
|---|---|---|
SCC_DIFF_IGNORECASE |
0x0002 | Ignore as diferenças de maiúsculas e minúsculas. |
SCC_DIFF_IGNORESPACE |
0x0004 | Ignore as diferenças de espaço em branco. Observação: os SCC_DIFF_IGNORECASE sinalizadores e SCC_DIFF_IGNORESPACE são bitflags opcionais. |
SCC_DIFF_QD_CONTENTS |
0x0010 | QD comparando todo o conteúdo do arquivo. |
SCC_DIFF_QD_CHECKSUM |
0x0020 | QD por soma de verificação. |
SCC_DIFF_QD_TIME |
0x0040 | QD por carimbo de data/hora do arquivo. |
SCC_DIFF_QUICK_DIFF |
0x0070 | Esta é uma máscara usada para verificar todos os bitflags QD. Não deve ser passado para uma função; os três bitflags QD são mutuamente exclusivos. QD sempre significa que não há exibição de interface do usuário. |
Sinalizador PopulateList
Esse sinalizador é usado pelo SccPopulateList no fOptions parâmetro.
| Sinalizador | Valor | Descrição |
|---|---|---|
SCC_PL_DIR |
0x00000001L | O IDE está passando diretórios, não arquivos. |
Sinalizadores PopulateDirList
Esses sinalizadores são usados pelo SccPopulateDirList no fOptions parâmetro.
| Valor de Opção | Valor | Descrição |
|---|---|---|
| SCC_PDL_ONELEVEL | 0x0000 | Examine apenas um nível de diretórios para diretórios (esse é o padrão). |
| SCC_PDL_RECURSIVE | 0x0001 | Examine recursivamente todos os diretórios em cada diretório fornecido. |
| SCC_PDL_INCLUDEFILES | 0x0002 | Inclua nomes de arquivos no processo de exame. |
Sinalizadores do OpenProject
Esses sinalizadores são usados pelo SccOpenProject no dwFlags parâmetro.
| Valor de Opção | Valor | Descrição |
|---|---|---|
| SCC_OP_CREATEIFNEW | 0x00000001L | Se o projeto não existir no controle do código-fonte, crie-o. Se esse sinalizador não estiver definido, solicite ao usuário que o projeto crie (a menos que SCC_OP_SILENTOPEN o sinalizador seja especificado). |
| SCC_OP_SILENTOPEN | 0x00000002L | Não solicite que o usuário crie um projeto; basta voltar SCC_E_UNKNOWNPROJECT. |
Obter sinalizadores
Esses sinalizadores são usados pelo SccGet e pelo SccCheckout.
| Sinalizador | Valor | Descrição |
|---|---|---|
SCC_GET_ALL |
0x00000001L | O IDE está passando diretórios, não arquivos: Obtenha todos os arquivos nesses diretórios. |
SCC_GET_RECURSIVE |
0x00000002L | O IDE está passando diretórios: Obtenha esses diretórios e todos os seus subdiretórios. |
nValores de opção
Esses sinalizadores são usados pelo SccSetOption no nOption parâmetro.
| Sinalizador | Valor | Descrição |
|---|---|---|
SCC_OPT_EVENTQUEUE |
0x00000001L | Defina o status da fila de eventos. |
SCC_OPT_USERDATA |
0x00000002L | Especifique os dados do usuário para SCC_OPT_NAMECHANGEPFNo . |
SCC_OPT_HASCANCELMODE |
0x00000003L | O IDE pode manipular o cancelamento. |
SCC_OPT_NAMECHANGEPFN |
0x00000004L | Defina um retorno de chamada para alterações de nome. |
SCC_OPT_SCCCHECKOUTONLY |
0x00000005L | Desative o check-out da interface do usuário do plug-in de controle do código-fonte e não defina o diretório de trabalho. |
SCC_OPT_SHARESUBPROJ |
0x00000006L | Adicionar do sistema de controle do código-fonte para especificar um diretório de trabalho. Tente compartilhar no projeto associado se for um descendente direto. |
bitflags dwVal
Esses sinalizadores são usados pelo SccSetOption no dwVal parâmetro.
| Sinalizador | Valor | Descrição | Usado por nOption valor |
|---|---|---|---|
SCC_OPT_EQ_DISABLE |
0x00L | Suspende a atividade da fila de eventos. | SCC_OPT_EVENTQUEUE |
SCC_OPT_EQ_ENABLE |
0x01L | Habilita o log da fila de eventos. | SCC_OPT_EVENTQUEUE |
SCC_OPT_HCM_NO |
0L | (Padrão) Não tem modo de cancelamento; O plug-in deve ser fornecido, se desejado. | SCC_OPT_HASCANCELMODE |
SCC_OPT_HCM_YES |
1L | O IDE identifica o cancelamento. | SCC_OPT_HASCANCELMODE |
SCC_OPT_SCO_NO |
0L | (Padrão) OK para fazer check-out da interface do usuário do plug-in; diretório de trabalho está definido. | SCC_OPT_SCCCHECKOUTONLY |
SCC_OPT_SCO_YES |
1L | Sem check-out da interface do usuário do plug-in, sem diretório de trabalho. | SCC_OPT_SCCCHECKOUTONLY |