Partager via


IVsLinkedUndoTransactionManager.OpenLinkedUndo, méthode

Ouvre une unité liée de parent de transaction de phase de restauration.

Espace de noms :  Microsoft.VisualStudio.TextManager.Interop
Assembly :  Microsoft.VisualStudio.TextManager.Interop (dans Microsoft.VisualStudio.TextManager.Interop.dll)

Syntaxe

'Déclaration
Function OpenLinkedUndo ( _
    dwFlags As UInteger, _
    pszDescription As String _
) As Integer
int OpenLinkedUndo(
    uint dwFlags,
    string pszDescription
)
int OpenLinkedUndo(
    [InAttribute] unsigned int dwFlags, 
    [InAttribute] String^ pszDescription
)
abstract OpenLinkedUndo : 
        dwFlags:uint32 * 
        pszDescription:string -> int
function OpenLinkedUndo(
    dwFlags : uint, 
    pszDescription : String
) : int

Paramètres

  • dwFlags
    Type : UInt32

    [in] évaluez pris de l'énumération d'LinkedTransactionFlags. mdtDefault spécifie la transaction pour être un nonstrict, qui est comportement par défaut. Les autres valeurs enums possibles sont mdtStrict qui spécifie le comportement de liaison de phase de restauration aussi strict, et mdtGlobal, qui spécifie le comportement de liaison de phase de restauration comme global. Pour plus d'informations, consultez la section « Notes » plus loin dans cette rubrique.

  • pszDescription
    Type : String

    [in] chaîne localisée qui décrit cette action ; apparaît dans les menus déroulants de phase de restauration/phase de restauration par progression. Cette valeur peut ne pas être nullune référence null (Nothing en Visual Basic).

Valeur de retour

Type : Int32
Si la méthode réussit, elle retourne S_OK.En cas d'échec, un code d'erreur est retourné.

Notes

De textmgr.idl :

HRESULT IVsLinkedUndoTransactionManager::OpenLinkedUndo(

[in] DWORD dwFlags,

[in] const WCHAR *pszDescription

);

  • Nonstrict a lié le comportement de phase de restauration mdtDefault () signifie que certains des documents avec les frères liés de phase de restauration peuvent fermer et encore laisser les autres frères liés de phase de restauration sur leurs piles. Un exemple du comportement de phase de restauration de nonstrict est recherché dans la suite de Microsoft® Office®. Microsoft Word permet un fichier à la fin pendant une opération de glisser-déplacer de telle manière qu'un fichier perde les informations.

  • Une opération d'annulation liée stricte spécifie que toutes les piles de frères d'annulation liée doivent être annulées ensemble ou pas à tout. Une opération d'annulation liée stricte (mdtStrict) est généralement nécessaire dans les modifications rédactionnelles qui constituent les modifications simultanées de texte au delà de plusieurs fichiers programme, tels qu'un fichier d'en-tête et un fichier de Visual C++. C'est, en fait, le modèle utilisé dans Visual Studio.

  • Une opération d'annulation globale (mdtGlobal) est un comportement strict de phase de restauration également, la seule différence étant que les documents affectés n'ont pas besoin d'être ouverts dans Visual Studio IDE pour avoir leurs modifications inversées. Un exemple de faire si vous devez annuler une opération de refactorisation de changement de nom sur un nom de variable dans un projet. La phase de restauration revient les modifications de renommer de tous les documents affectés du projet, qu'ils sont actuellement ouverts dans l'IDE.

    Toute mémoire tampon qui est ouverte (mais pas nécessairement changée) pendant une transaction de phase de restauration d'mdtGlobal est marquée d'un indicateur comme mémoire tampon qui participe à l'opération d'annulation de mémoire tampon globale. Les piles à annuler de ces mémoires tampon (documents) sont conservées si les mémoires tampon sont fermées et rouvertes ensuite de nouveau dans la même session d'IDE.

Pour activer la phase de restauration globale en créant votre propre implémentation d'IVsPersistDocData2 - à VsTextBuffer comme mémoire tampon pour votre implémentation de DocData - veillez à localiser le DocData correctement en appelant SetSite avec un fournisseur de services valide. En outre, vous devez appeler l'OnRegisterDocData sur votre VsTextBuffer.

Sécurité .NET Framework

Voir aussi

Référence

IVsLinkedUndoTransactionManager Interface

Microsoft.VisualStudio.TextManager.Interop, espace de noms