Bitflags usados por comandos específicos

  • Artigo

O comportamento de várias funções na API de plug-in de controle de origem pode ser modificado definindo um ou mais bits em um único valor. Esses valores são conhecidos como bitflags. Os vários bitflags usados pela API do plug-in de controle do código-fonte são detalhados aqui, agrupados pela função que os usa.

Sinalizador com 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 é de texto ou binário.
SCC_FILETYPE_TEXT 0x01 Tipo de arquivo é texto.
SCC_FILETYPE_BINARY 0x04 O tipo de arquivo é binário. Nota:SCC_FILETYPE_TEXT e SCC_FILETYPE_BINARY as bandeiras são mutuamente exclusivas. Defina exatamente um ou nenhum dos dois.
SCC_ADD_STORELATEST 0x02 Armazene 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, então nenhum feedback visual deve ser dado. Em um "quick 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 passa para o próximo melhor. Por exemplo, se o IDE solicitar uma soma de verificação e o plug-in não oferecer suporte a ela, 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 Ignorar as diferenças de maiúsculas e minúsculas.
SCC_DIFF_IGNORESPACE 0x0004 Ignore as diferenças de espaço em branco. Nota: 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 checksum.
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 da 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 determinado.
SCC_PDL_INCLUDEFILES 0x0002 Inclua nomes de arquivos no processo de exame.

Sinalizadores 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 a criação do projeto (a menos que SCC_OP_SILENTOPEN o sinalizador seja especificado).
SCC_OP_SILENTOPEN 0x00000002L Não solicitar que o usuário crie um projeto; é só voltar SCC_E_UNKNOWNPROJECT.

Obter bandeiras

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.

Valores nOption

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 lidar com 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 Adicione do sistema de controle do código-fonte para especificar um diretório de trabalho. Tente compartilhar no projeto associado se ele for um descendente direto.

dwVal bitflags

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; plug-in deve fornecer, se desejado. SCC_OPT_HASCANCELMODE
SCC_OPT_HCM_YES 1L O IDE lida com 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

Confira também