UndoContext.Open(String, Boolean) Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Inicia uma nova operação de desfazer.
void Open(std::wstring const & Name, bool Strict = false);
[System.Runtime.InteropServices.DispId(3)]
public void Open (string Name, bool Strict = false);
[<System.Runtime.InteropServices.DispId(3)>]
abstract member Open : string * bool -> unit
Public Sub Open (Name As String, Optional Strict As Boolean = false)
Parâmetros
- Name
- String
Obrigatórios. Representa o nome do procedimento para o qual fornecer um contexto de desfazer.
- Strict
- Boolean
Opcional. Indica se o vínculo da pilha de desfazer é estrito. O valor padrão é False.
- Atributos
Exemplos
Sub OpenExample()
' Before running, select text in an open document.
Dim txtSel As TextSelection
Dim strTS As String, boolWasOpen As Boolean
txtSel = DTE.ActiveDocument.Selection
strTS = txtSel.Text
' Check to see if UndoContext object is already open.
If DTE.UndoContext.IsOpen = True Then
boolWasOpen = True
Else
' Open the UndoContext object to track changes.
DTE.UndoContext.Open("RemoveNewLines", False)
End If
' Perform search for newline characters and remove them.
If strTS <> "" Then
txtSel.Delete()
strTS = Replace(strTS, vbNewLine, "", Compare:=vbTextCompare)
txtSel.Insert(strTS)
End If
' If UndoContext was already open, don't close it.
If boolWasOpen = False Then
' Close the UndoContext object to commit the changes.
DTE.UndoContext.Close()
End If
End Sub
Comentários
Se o UndoContext objeto já estiver aberto quando o Open método for executado, ele produzirá um erro.
Se a vinculação de pilha de desfazer for estrita, todas as pilhas irmãs de desfazer vinculadas deverão ser desfeitas juntas ou não. Uma operação de desfazer vinculada estrita geralmente é necessária para alterações de texto simultâneas em vários arquivos, como um arquivo de cabeçalho e um arquivo de Visual C++. Isso, na verdade, é o modelo usado no Visual Studio. Para obter mais informações sobre a vinculação de pilha de desfazer, consulte o OpenLinkedUndo método.