Сообщений 5    Оценка 140        Оценить

Add-in для подключения MSDN .NET к Visual C++ 6.0

Автор: Grigory Grubsky

Опубликовано: 30.01.2003
Исправлено: 15.04.2009
Версия текста: 1.0

Пролог

Предлагаемый add-in есть не что иное, как макрос Игоря Соловьёва, самым тупым образом перенесённый на C++. В своё время, после прочтения статьи, установки макроса в VC++ и испробования его в деле, мне пришла в голову мысль оформить этот код в виде add-in’а. Формальным поводом послужили отсутствие автоматического встраивания в IDE и некоторая неспешность отклика. На самом деле, конечно основным мотивом было желание «побаловаться» с add-in’остроеним. Написать тривиальный add-in для обработки горячей клавиши в Visual C++ 6 не составляет особого труда, ибо писать ничего и не придётся (кроме непосредственно кода обработчика, естественно). Ниже представлено пошаговое описание процесса создания такого ad-in’а на примере add-in’а для подключения MSDN .NET к Visual C++ 6.

Описание

Визард

Первым делом надо создать новый проект, выбрав тип проекта «DevStudio Add-in Wizard». Заполнить единственную форму визарда (для таких простых случаев, как рассматриваемый, можно снять флаги «Provides a toolbar» и «Responds to Developer Studio events»). Нажать кнопку «Finish», и всё - add-in готов. Осталось только добавить функциональность.

Обработчик команды

Визард сгенерировал класс CCommands, поддерживающий интерфейс ICommands с единственным методом DotNetMsdnCommandMethod (в случае проекта с именем DotNetMsdn). Впрочем, имя метода можно изменить вручную, что я и сделал. Теперь это ShowDotNetHelp. Теперь достаточно открыть Commands.cpp найти реализацию метода и вставить туда нужный Вам код. Смеха для можете сравнить этот код с оригинальным кодом макроса. #import – это сила. ;)

	IDispatch* pdispActDocPtr = NULL;
	VERIFY_OK(m_pApplication->get_ActiveDocument(&pdispActDocPtr));
	if (pdispActDocPtr == NULL)
		return S_OK; // not document

	try {

		DSTextEditor::ITextDocumentPtr ActDocPtr(pdispActDocPtr);
		pdispActDocPtr->Release();

		DSTextEditor::ITextSelectionPtr SelPtr((IDispatch*)ActDocPtr->Selection);

		_bstr_t bsSel = SelPtr->Text;

		if ( bsSel.length() == 0 ) {
			long lLine = SelPtr->CurrentLine;
			long lColumn = SelPtr->CurrentColumn;

			SelPtr->WordRight((long)DSTextEditor::dsMove);
			SelPtr->WordLeft((long)DSTextEditor::dsExtend);

			bsSel = SelPtr->Text;

			SelPtr->MoveTo(lLine, lColumn, (long)dsMove);
		}

		CString sStr((const char*)bsSel);
		sStr.TrimRight();
		bsSel = (const char*)sStr;

		if ( m_HelpPtr == NULL ) {
			if ( FAILED(m_HelpPtr.CreateInstance("DExplore.AppObj")) ) {
				AfxMessageBox(IDS_DONT_CREATE_HELP_OBJECT, MB_OK | MB_ICONSTOP);
				return S_OK;
			}

//			m_HelpPtr->SetCollection(L"ms-help://MS.VSCC", L"Visual C++ and Related");
			m_HelpPtr->SetCollection(L"ms-help://MS.VSCC", L"");
			m_HelpPtr->Index();
		}
  
		try {
			m_HelpPtr->DisplayTopicFromF1Keyword(bsSel);
		} catch (...) {}

		SHost::IWshShell2Ptr ShellPtr(L"WScript.Shell");
		ShellPtr->AppActivate(&_variant_t(L"Visual Studio .NET Combined Collection"));

	} catch (_com_error& e) {
		AfxMessageBox(e.Description(), MB_OK | MB_ICONSTOP);
	} catch (...) {
	}

	return S_OK;

Назначение быстрой клавиши

	CComBSTR bszKey(L"Ctrl+F1");
	CComBSTR bszEditor(L"Text");
	VERIFY_OK(pApplication->AddKeyBinding(bszKey, bszCmdName, bszEditor));

Я не нашёл ничего умнее, чем вставить этот вызов в CDSAddIn::OnConnection – метод кокласса add-in’а (не перепутайте с коклассом команд CCommands) – что, конечно, далеко не самое удачное решение, так как в этом случае назначение «Ctrl+F1» происходит при каждом старте Visual Studio, невзирая на то, что пользователь, возможно, уже переназначил выполнение команды на другую, более удобную для себя клавишу. Если кто-нибудь найдёт изящное решение этой проблемы, пожалуйста, поделитесь со мной.

Добавление кода для саморегистрации

В файле DotNetMsdn.cpp (в случае проекта с именем DotNetMsdn) находится небезызвестная функция DllRegisterServer. Она идеально подходит для добавления кода, необходимого для регистрации add-in’а.

STDAPI DllRegisterServer(void)
{	// ... код, сгенерированный визардом
	lRes = key.Open(HKEY_CURRENT_USER, _T("SOFTWARE\\Microsoft\\DevStudio\\6.0\\AddIns"));
	if (lRes == ERROR_SUCCESS)	{
		lRes = key.Create(key, _T("DotNetMsdn.DSAddIn.1"));
		key.SetValue(_T("1"));
		CString strValue;
		strValue.LoadString(IDS_DOTNETMSDN_DESCRIPTION);
		key.SetValue(strValue, _T("Description"));
		strValue.LoadString(IDS_DOTNETMSDN_LONGNAME);
		key.SetValue(strValue, _T("DisplayName"));

		TCHAR szName[MAX_PATH];
		GetModuleFileName(GetModuleHandle(_T("DotNetMsdn.dll")), szName, MAX_PATH);
		key.SetValue(szName, _T("FileName"));
	}

	if (lRes != ERROR_SUCCESS) {
		hRes = HRESULT_FROM_WIN32(lRes);
	}

	return hRes;
}

Конечно, отсутствие в DllUnregisterServer удаления ключа реестра, отвечающего за регистрацию add-in’а, есть следствие непростительного раздолбайства (каюсь, грешен), но ведь и исходники доступны – исправляйте, я потом с удовольствием скачаю обезглюченную версию. ;)

Инструкция по установке

Программа установки сделана с помощью популярного NSIS от NullSoft’а. Для инсталляции add-in’а достаточно её запустить и несколько раз нажать ENTER.

Сообщений 5    Оценка 140        Оценить