如何判断活动文档是否为文本文档?
How to tell if the active document is a text document?
我正在开发一个 Visual Studio 扩展,其中只有当活动文档是文本文档(例如 Visual Studio 的 "Toggle Bookmark" 确实如此)。问题是我不知道如何判断什么时候是这种情况。
现在我有一个半工作的解决方案。在包的 Initialize
方法中,我订阅了 DTE 的 WindowActivated
事件,然后每当 window 被激活时,我检查是否 window DocumentData
属性类型为 TextDocument
:
protected override void Initialize()
{
base.Initialize();
var dte = Package.GetGlobalService(typeof(EnvDTE.DTE)) as EnvDTE.DTE;
dte.Events.WindowEvents.WindowActivated += WindowEventsOnWindowActivated;
//More initialization here...
}
//This is checked from command's BeforeQueryStatus
public bool ActiveDocumentIsText { get; private set; } = false;
private void WindowEventsOnWindowActivated(Window gotFocus, Window lostFocus)
{
if (gotFocus.Kind != "Document")
return; //It's not a document (e.g. it's a tool window)
TextDocument textDoc = gotFocus.DocumentData as TextDocument;
ActiveDocumentIsText = textDoc != null;
}
这种方法的问题在于 1) Window.DocumentData is documented as ".NET Framework internal use only",以及 2) 当文档同时具有代码视图和设计视图(例如 .visxmanifest
文件)时,这会产生误报) 在设计模式下打开。
我也尝试过使用 IVsTextManager.GetActiveView,但这会返回打开的 last 活动文本视图 - 所以如果我打开一个 .txt 文件,然后.png 文件,它 returns .txt 文件的数据,即使它不再是活动文档。
那么,如何检查活动文档是文本文档,还是可以具有设计器的文档的代码视图...如果可能,不使用 "undocumented" classes/members?
更新: 我找到了一个稍微好一点的解决方案。在 window 激活的处理程序中:
ActiveDocumentIsText = gotFocus.Document.Object("TextDocument") != null;
至少this one is properly documented,但我还是和设计师有误报的问题
我终于明白了。这有点棘手,但它有效并且是 100% "legal"。这是食谱:
1- 使包 class 实现 IVsRunningDocTableEvents。使所有方法只是 return VSConstants.S_OK;
2-在包中添加如下字段和以下辅助方法class:
private IVsRunningDocumentTable runningDocumentTable;
private bool DocIsOpenInLogicalView(string path, Guid logicalView, out IVsWindowFrame windowFrame)
{
return VsShellUtilities.IsDocumentOpen(
this,
path,
VSConstants.LOGVIEWID_TextView,
out var dummyHierarchy2, out var dummyItemId2,
out windowFrame);
}
3-在包class的Initialize
方法中添加如下内容:
runningDocumentTable = GetService(typeof(SVsRunningDocumentTable)) as IVsRunningDocumentTable;
runningDocumentTable.AdviseRunningDocTableEvents(this, out var dummyCookie);
4- 别眨眼,魔法来了!实现IVsRunningDocTableEvents.OnBeforeDocumentWindowShow
方法如下:
public int OnBeforeDocumentWindowShow(uint docCookie, int fFirstShow, IVsWindowFrame pFrame)
{
runningDocumentTable.GetDocumentInfo(docCookie,
out var dummyFlags, out var dummyReadLocks, out var dummyEditLocks,
out string path,
out var dummyHierarchy, out var dummyItemId, out var dummyData);
IVsWindowFrame windowFrameForTextView;
var docIsOpenInTextView =
DocIsOpenInLogicalView(path, VSConstants.LOGVIEWID_Code, out windowFrameForTextView) ||
DocIsOpenInLogicalView(path, VSConstants.LOGVIEWID_TextView, out windowFrameForTextView);
//Is the document open in the code/text view,
//AND the window for that view is the one that has been just activated?
ActiveDocumentIsText = docIsOpenInTextView && pFrame == logicalViewWindowFrame;
return VSConstants.S_OK;
}
我正在开发一个 Visual Studio 扩展,其中只有当活动文档是文本文档(例如 Visual Studio 的 "Toggle Bookmark" 确实如此)。问题是我不知道如何判断什么时候是这种情况。
现在我有一个半工作的解决方案。在包的 Initialize
方法中,我订阅了 DTE 的 WindowActivated
事件,然后每当 window 被激活时,我检查是否 window DocumentData
属性类型为 TextDocument
:
protected override void Initialize()
{
base.Initialize();
var dte = Package.GetGlobalService(typeof(EnvDTE.DTE)) as EnvDTE.DTE;
dte.Events.WindowEvents.WindowActivated += WindowEventsOnWindowActivated;
//More initialization here...
}
//This is checked from command's BeforeQueryStatus
public bool ActiveDocumentIsText { get; private set; } = false;
private void WindowEventsOnWindowActivated(Window gotFocus, Window lostFocus)
{
if (gotFocus.Kind != "Document")
return; //It's not a document (e.g. it's a tool window)
TextDocument textDoc = gotFocus.DocumentData as TextDocument;
ActiveDocumentIsText = textDoc != null;
}
这种方法的问题在于 1) Window.DocumentData is documented as ".NET Framework internal use only",以及 2) 当文档同时具有代码视图和设计视图(例如 .visxmanifest
文件)时,这会产生误报) 在设计模式下打开。
我也尝试过使用 IVsTextManager.GetActiveView,但这会返回打开的 last 活动文本视图 - 所以如果我打开一个 .txt 文件,然后.png 文件,它 returns .txt 文件的数据,即使它不再是活动文档。
那么,如何检查活动文档是文本文档,还是可以具有设计器的文档的代码视图...如果可能,不使用 "undocumented" classes/members?
更新: 我找到了一个稍微好一点的解决方案。在 window 激活的处理程序中:
ActiveDocumentIsText = gotFocus.Document.Object("TextDocument") != null;
至少this one is properly documented,但我还是和设计师有误报的问题
我终于明白了。这有点棘手,但它有效并且是 100% "legal"。这是食谱:
1- 使包 class 实现 IVsRunningDocTableEvents。使所有方法只是 return VSConstants.S_OK;
2-在包中添加如下字段和以下辅助方法class:
private IVsRunningDocumentTable runningDocumentTable;
private bool DocIsOpenInLogicalView(string path, Guid logicalView, out IVsWindowFrame windowFrame)
{
return VsShellUtilities.IsDocumentOpen(
this,
path,
VSConstants.LOGVIEWID_TextView,
out var dummyHierarchy2, out var dummyItemId2,
out windowFrame);
}
3-在包class的Initialize
方法中添加如下内容:
runningDocumentTable = GetService(typeof(SVsRunningDocumentTable)) as IVsRunningDocumentTable;
runningDocumentTable.AdviseRunningDocTableEvents(this, out var dummyCookie);
4- 别眨眼,魔法来了!实现IVsRunningDocTableEvents.OnBeforeDocumentWindowShow
方法如下:
public int OnBeforeDocumentWindowShow(uint docCookie, int fFirstShow, IVsWindowFrame pFrame)
{
runningDocumentTable.GetDocumentInfo(docCookie,
out var dummyFlags, out var dummyReadLocks, out var dummyEditLocks,
out string path,
out var dummyHierarchy, out var dummyItemId, out var dummyData);
IVsWindowFrame windowFrameForTextView;
var docIsOpenInTextView =
DocIsOpenInLogicalView(path, VSConstants.LOGVIEWID_Code, out windowFrameForTextView) ||
DocIsOpenInLogicalView(path, VSConstants.LOGVIEWID_TextView, out windowFrameForTextView);
//Is the document open in the code/text view,
//AND the window for that view is the one that has been just activated?
ActiveDocumentIsText = docIsOpenInTextView && pFrame == logicalViewWindowFrame;
return VSConstants.S_OK;
}