Отображение подсказки в строке состояния

Следующий метод IContextMenu, который может быть вызван, это GetCommandString(). Если пользователь щелкает правой кнопкой на текстовом файле в окне проводника (в правом окне, если режим двухоконный), или укажет текстовый файл, а затем щелкнет на пункте меню File, то в строке состояния появится подсказка. Наша GetCommandString() возвратит строку, отображаемую в подсказке.

Прототип GetCommandString():

HRESULT IContextMenu::GetCommandString ( UINT idCmd, UINT uFlags, UINT *pwReserved, LPSTR pszName, UINT cchMax );

где idCmd - начинающийся с 0 счетчик, который указывает, какой пункт меню отмечен. Поскольку у нас только один пункт меню, idCmd всегда будет =0. Но если у нас есть изначально, скажем, 3 пункта меню, то idCmd может быть равен 0, 1 или 2. uFlags - другая группа флагов, которую я опишу позже. pwReserved можно проигнорировать. pszName - указатель на собственный буфер оболочки, где мы сохраним строку подсказки, которая будет высвечиваться. cchMax - это размер буфера. Возвращаемое функцией значение - одна из обычных констант HRESULT - S_OK или E_FAIL.

GetCommandString() также может быть вызвана, чтобы получить "действие" ("verb") от пункта меню. "Действие" - независимая от языка строка, которая идентифицирует операцию, производимую с файлом. Документы по ShellExecute() расскажут об объекте "действие" больше и это тема для другой статьи, но сокращенная версия такова: "действия" могут быть внесены в список в реестре ("open", "print") или могут быть созданы расширением динамически . Это позволяет вызывать расширение при выполнении ShellExecute().

Во всяком случае, причина по которой я обо всем этом упомянул состоит в том, что нам нужно определить, для чего вызывается GetCommandString(). Если проводник требует строку подсказки, мы дадим ее. Если проводник потребует "действие" мы проигнорируем его запрос. Это как раз тот момент, когда параметр uFlags становится значимым. Если в параметре uFlags установлен бит GCS_HELPTEXT то проводник запрашивает подсказку. Если установлен бит GCS_UNICODE , мы должны возвратить строку в UNICODE.

Код нашей GetCommandString() выглядит так:

#include <atlconv.h> // for ATL string conversion macros HRESULT CSimpleShlExt::GetCommandString ( UINT idCmd, UINT uFlags, UINT* pwReserved, LPSTR pszName, UINT cchMax ) { USES_CONVERSION; // Check idCmd, it must be 0 since we have only one menu item. if ( 0 != idCmd ) return E_INVALIDARG; // If Explorer is asking for a help string, copy our string into the // supplied buffer. if ( uFlags & GCS_HELPTEXT ) { LPCTSTR szText = _T("This is the simple shell extension's help"); if ( uFlags & GCS_UNICODE ) { // We need to cast pszName to a Unicode string, and then use the // Unicode string copy API. lstrcpynW ( (LPWSTR) pszName, T2CW(szText), cchMax ); } else { // Use the ANSI string copy API to return the help string. lstrcpynA ( pszName, T2CA(szText), cchMax ); } return S_OK; } return E_INVALIDARG; }

Здесь нет ничего фантастического. Я просто преобразовываю строку в подходящий набор символов. Если вы никогда не использовали ATL макросов конвертирования, вы определенно должны прочитать о них, т.к. они намного облегчают жизнь, когда необходимо передать строку UNICODE COM-методам и OLE-функциям. Я использую T2CW и T2CA в коде, приведенном выше, чтобы преобразовать строку в UNICODE и ANSI соответственно. Макрос USES_CONVERSION в начале функции объявляет локальную переменную, которая используется в конверсионных макросах.

Заметим одну важную вещь: lstrcpyn() гарантирует, что строка назначения будет завершена нулем. В этом ее отличие от CRT-функции strncpy(), которая не добавляет завершающий 0, если длина исходной строки больше или равна cchMax. Я предлагаю всегда использовать lstrcpyn(), и вам не нужно будет проверять конец строки после каждого вызова strncpy(), чтобы убедиться, что она закрыта нулем.