Bitflags utilisés par des commandes spécifiques

Le comportement d’un certain nombre de fonctions dans l’API plug-in de contrôle de code source peut être modifié en définissant un ou plusieurs bits dans une seule valeur. Ces valeurs sont appelées flocons de bits. Les différents indicateurs de bits utilisés par l’API plug-in de contrôle de code source sont détaillés ici, regroupés par la fonction qui les utilise.

Indicateur extrait

Cet indicateur peut être défini pour SccAdd ou SccCheckin.

Indicateur	Valeur	Description
SCC_KEEP_CHECKEDOUT	0x1000	Conservez le fichier extrait.

Ajouter des indicateurs

Ces indicateurs sont utilisés par sccAdd.

Indicateur	Valeur	Description
SCC_FILETYPE_AUTO	0x00	Le plug-in de contrôle de code source est censé détecter automatiquement si le fichier est texte ou binaire.
SCC_FILETYPE_TEXT	0x01	Le type de fichier est texte.
SCC_FILETYPE_BINARY	0x04	Le type de fichier est binaire. Remarque : SCC_FILETYPE_TEXT et SCC_FILETYPE_BINARY les indicateurs s’excluent mutuellement. Définissez exactement un ou aucun des deux.
SCC_ADD_STORELATEST	0x02	Stockez la dernière version uniquement (pas de deltas).

Indicateurs de différences

SccDiff utilise ces indicateurs pour définir l’étendue d’une opération de différences. Les SCC_DIFF_QD_xxx indicateurs s’excluent mutuellement. Si l’un d’eux est spécifié, aucun retour visuel n’est à donner. Dans un « diff rapide » (QD), le plug-in ne détermine pas comment le fichier est différent, uniquement s’il est différent. Si aucun de ces indicateurs n’est spécifié, un « diff visuel » est effectué ; les différences de fichier détaillées sont calculées et affichées. Si le QD demandé n’est pas pris en charge, le plug-in passe à la meilleure solution suivante. Par exemple, si l’IDE demande une somme de contrôle et que le plug-in ne le prend pas en charge, le plug-in effectue une vérification complète du contenu (toujours beaucoup plus rapide qu’un affichage visuel).

Indicateur	Valeur	Description
SCC_DIFF_IGNORECASE	0x0002	Ignorez les différences de cas.
SCC_DIFF_IGNORESPACE	0x0004	Ignorez les différences d’espace blanc. Remarque : Les SCC_DIFF_IGNORECASE indicateurs et SCC_DIFF_IGNORESPACE les indicateurs sont des flocons de bits facultatifs.
SCC_DIFF_QD_CONTENTS	0x0010	QD en comparant l’intégralité du contenu du fichier.
SCC_DIFF_QD_CHECKSUM	0x0020	QD par somme de contrôle.
SCC_DIFF_QD_TIME	0x0040	QD par horodatage de date/heure du fichier.
SCC_DIFF_QUICK_DIFF	0x0070	Il s’agit d’un masque utilisé pour vérifier tous les flocons de bits QD. Il ne doit pas être passé dans une fonction ; les trois bitflags QD s’excluent mutuellement. QD signifie toujours qu’aucun affichage de l’interface utilisateur n’est affiché.

Indicateur PopulateList

Cet indicateur est utilisé par sccPopulateList dans le fOptions paramètre.

Indicateur	Valeur	Description
SCC_PL_DIR	0x00000001L	L’IDE passe des répertoires, pas des fichiers.

Indicateurs PopulateDirList

Ces indicateurs sont utilisés par sccPopulateDirList dans le fOptions paramètre.

Valeur d’option	Valeur	Description
SCC_PDL_ONELEVEL	0x0000	Examinez un seul niveau de répertoires pour les répertoires (il s’agit de la valeur par défaut).
SCC_PDL_RECURSIVE	0x0001	Examinez de manière récursive tous les répertoires sous chaque répertoire donné.
SCC_PDL_INCLUDEFILES	0x0002	Incluez les noms de fichiers dans le processus d’examen.

Indicateurs OpenProject

Ces indicateurs sont utilisés par sccOpenProject dans le dwFlags paramètre.

Valeur d’option	Valeur	Description
SCC_OP_CREATEIFNEW	0x00000001L	Si le projet n’existe pas dans le contrôle de code source, créez-le. Si cet indicateur n’est pas défini, invitez l’utilisateur à créer un projet (sauf si SCC_OP_SILENTOPEN l’indicateur est spécifié).
SCC_OP_SILENTOPEN	0x00000002L	N’invitez pas l’utilisateur à créer un projet ; juste retourner SCC_E_UNKNOWNPROJECT.

Obtenir des indicateurs

Ces indicateurs sont utilisés par SccGet et SccCheckout.

Indicateur	Valeur	Description
SCC_GET_ALL	0x00000001L	L’IDE passe des répertoires, et non des fichiers : obtenez tous les fichiers dans ces répertoires.
SCC_GET_RECURSIVE	0x00000002L	L’IDE passe des répertoires : obtenez ces répertoires et tous leurs sous-répertoires.

valeurs nOption

Ces indicateurs sont utilisés par sccSetOption dans le nOption paramètre.

Indicateur	Valeur	Description
SCC_OPT_EVENTQUEUE	0x00000001L	Définissez l’état de la file d’attente d’événements.
SCC_OPT_USERDATA	0x00000002L	Spécifiez les données utilisateur pour SCC_OPT_NAMECHANGEPFN.
SCC_OPT_HASCANCELMODE	0x00000003L	L’IDE peut gérer l’annulation.
SCC_OPT_NAMECHANGEPFN	0x00000004L	Définissez un rappel pour les modifications de nom.
SCC_OPT_SCCCHECKOUTONLY	0x00000005L	Désactivez l’extraction de l’interface utilisateur du plug-in de contrôle de code source et ne définissez pas le répertoire de travail.
SCC_OPT_SHARESUBPROJ	0x0000006L	Ajoutez à partir du système de contrôle de code source pour spécifier un répertoire de travail. Essayez de partager dans le projet associé s’il s’agit d’un descendant direct.

dwVal bitflags

Ces indicateurs sont utilisés par sccSetOption dans le dwVal paramètre.

Indicateur	Valeur	Description	Utilisé par nOption valeur
SCC_OPT_EQ_DISABLE	0x00L	Suspend l’activité de file d’attente d’événements.	SCC_OPT_EVENTQUEUE
SCC_OPT_EQ_ENABLE	0x01L	Active la journalisation des files d’attente d’événements.	SCC_OPT_EVENTQUEUE
SCC_OPT_HCM_NO	0L	(Par défaut) N’a pas de mode d’annulation ; plug-in doit fournir si vous le souhaitez.	SCC_OPT_HASCANCELMODE
SCC_OPT_HCM_YES	1L	L’IDE gère l’annulation.	SCC_OPT_HASCANCELMODE
SCC_OPT_SCO_NO	0L	(Par défaut) OK pour extraire de l’interface utilisateur du plug-in ; Le répertoire de travail est défini.	SCC_OPT_SCCCHECKOUTONLY
SCC_OPT_SCO_YES	1L	Aucune extraction de l’interface utilisateur de plug-in, aucun répertoire de travail.	SCC_OPT_SCCCHECKOUTONLY

Voir aussi

• Plug-ins de contrôle de code source