On-line справка по Win32 API

БЕСПЛАТНАЯ ежедневная online лотерея! Выигрывай каждый день БЕСПЛАТНО!

A-B-C-D-E-F-G-H-I-J-K-L-M-N-O-P-Q-R-S-T-U-V-W-X-Y-Z | Скачать

IContextMenu Interface

An application implements a context menu handler interface, IContextMenu, to add menu items to the context menu for a file object. The shell displays the object's context menu when the user clicks the object with mouse button 2. The menu items can be either class-specific (that is, applicable to all files of a particular type) or instance-specific (that is, applicable to an individual file).

When the user clicks a file object by using mouse button 2, the system passes the address of the object's context menu to the context menu handler, which should use the handle only to add items to the menu. The handler should not delete or modify existing menu items, because other handlers may add items either before or after it does. In addition, the shell adds items to the menu after all context menu handlers have been called.
Context menu handlers are entered in the registry under the shellex key within an application's information area. The ContextMenuHandlers key lists the names of subkeys that contain the CLSID of each context menu handler. An example showing the ContextMenuHandlers key follows.

ContextMenuHandlers
{00000000-1111-2222-3333-00000000000001}

You can register multiple context menu handlers for a file type.
In addition to the standard IUnknown member functions, the context menu handler interface uses the QueryContextMenu, InvokeCommand, and GetCommandString member functions.
When the user selects one of the menu items added by a context menu handler, the shell calls the handler's IContextMenu::InvokeCommand member function to let the handler process the command. If multiple context menu handlers are registered for a file type, the value of the ContextMenuHandlers key determines the order of the commands.

When the system is about to display a context menu (or the File menu on the menu bar) for a file object, the system calls the context menu handler's QueryContextMenu member function. The context menu handler inserts menu items by position (MF_POSITION) directly into the context menu by calling the InsertMenu function. The following example shows that menu items must be string items (MF_STRING).

STDMETHODIMP CShellExt::QueryContextMenu(HMENU hMenu,
UINT indexMenu, UINT idCmdFirst, UINT idCmdLast, UINT uFlags)
{
UINT idCmd = idCmdFirst;
char szMenuText[64];
char szMenuText2[64];
char szMenuText3[64];
char szMenuText4[64];
BOOL bAppendItems=TRUE;

if ((uFlags & 0x000F) == CMF_NORMAL) {
lstrcpy(szMenuText, "&New .GAK menu 1, Normal File");
lstrcpy(szMenuText2, "&New .GAK menu 2, Normal File");

lstrcpy(szMenuText3, "&New .GAK menu 3, Normal File");
lstrcpy(szMenuText4, "&New .GAK menu 4, Normal File");
} else if (uFlags & CMF_VERBSONLY) {
lstrcpy(szMenuText, "&New .GAK menu 1, Shortcut File");
lstrcpy(szMenuText2, "N&ew .GAK menu 2, Shortcut File");
lstrcpy(szMenuText3, "&New .GAK menu 3, Shortcut File");
lstrcpy(szMenuText4, "&New .GAK menu 4, Shortcut File");
} else if (uFlags & CMF_EXPLORE) {

lstrcpy(szMenuText, "&New .GAK menu 1,
Normal File right click in Explorer");
lstrcpy(szMenuText2, "N&ew .GAK menu 2,
Normal File right click in Explorer");
lstrcpy(szMenuText3, "&New .GAK menu 3,
Normal File right click in Explorer");
lstrcpy(szMenuText4, "&New .GAK menu 4,
Normal File right click in Explorer");
} else if (uFlags & CMF_DEFAULTONLY) {
bAppendItems = FALSE;

} else {
char szTemp[32];
bAppendItems = FALSE;
}

if (bAppendItems) {
InsertMenu(hMenu, indexMenu++, MF_SEPARATOR | MF_BYPOSITION,
0, NULL);
InsertMenu(hMenu, indexMenu++, MF_STRING | MF_BYPOSITION,
idCmd++, szMenuText);
InsertMenu(hMenu, indexMenu++, MF_SEPARATOR | MF_BYPOSITION,
0, NULL);
InsertMenu(hMenu, indexMenu++, MF_STRING | MF_BYPOSITION,
idCmd++, szMenuText2);

InsertMenu(hMenu, indexMenu++, MF_SEPARATOR | MF_BYPOSITION,
0, NULL);
InsertMenu(hMenu, indexMenu++, MF_STRING | MF_BYPOSITION,
idCmd++, szMenuText3);
InsertMenu(hMenu, indexMenu++, MF_STRING | MF_BYPOSITION,
idCmd++, szMenuText4);

// Must return the number of menu items added.
return ResultFromShort(idCmd-idCmdFirst);
}
return NOERROR;
}

The system calls the InvokeCommand member function when the user selects a menu item that the context menu handler added to the context menu. The InvokeCommand function in the following example handles the commands associated with the menu items added by the previous example.

STDMETHODIMP CShellExt::InvokeCommand(LPCMINVOKECOMMANDINFO lpcmi)
{
HRESULT hr = E_INVALIDARG;

// If the high-order word of lpcmi->lpVerb is not NULL, this
// function was called by an application and lpVerb is a command
// that should be activated. Otherwise, the shell has called this
// function, and the low-order word of lpcmi->lpVerb is the
// identifier of the menu item that the user selected.
if (!HIWORD(lpcmi->lpVerb)) {

UINT idCmd = LOWORD(lpcmi->lpVerb);

switch (idCmd) {
case 0:
hr = DoGAKMenu1(lpcmi->hwnd, lpcmi->lpDirectory,
lpcmi->lpVerb, lpcmi->lpParameters, lpcmi->nShow);
break;

case 1:
hr = DoGAKMenu2(lpcmi->hwnd, lpcmi->lpDirectory,
lpcmi->lpVerb, lpcmi->lpParameters, lpcmi->nShow);
break;

case 2:

hr = DoGAKMenu3(lpcmi->hwnd, lpcmi->lpDirectory,
lpcmi->lpVerb, lpcmi->lpParameters, lpcmi->nShow);
break;

case 3:
hr = DoGAKMenu4(lpcmi->hwnd, lpcmi->lpDirectory,
lpcmi->lpVerb, lpcmi->lpParameters, lpcmi->nShow);
break;
}
}
return hr;
}

Windows calls the GetCommandString member function to get a language-independent command string or the help text for a context menu item.

Пригласи друзей и счет твоего мобильника всегда будет положительным!

Пригласи друзей и счет твоего мобильника всегда будет положительным!

ИНТЕРФЕЙС IContextMenu

Приложение осуществляет интерфейс вручителя контекстного меню, IContextMenu, чтобы добавлять пункты меню к контекстному меню для файлового объекта. Оболочка отображает объектное контекстное меню когда пользователь щелкает объект с кнопкой мыши 2. Пункты меню могут быть или класс-специфический (то есть, применительный ко всем файлам конкретного типа) или пример-специфический (то есть, применительный к индивидуальному файлу).

Когда пользователь щелкает файловый объект используя кнопку мыши 2, система передает адрес объектного контекстного меню контекстному вручителю меню, которое должно использовать ручку только, чтобы добавлять пункты к меню. Вручитель не должен удалять или модифицировать пункты меню существовать, поскольку другие вручители могут добавить пункты или перед или после того, как он сделает. Кроме того, оболочка добавляет пункты к в конце концов контекстному меню вручителей меню назван.
Контекстные вручители меню введены в регистрацию под клавишей shellex в пределах прикладной информационной области. Клавиша ContextMenuHandlers включает имена подключей, которые содержат CLSID каждый контекстный вручитель меню. Пример, показывающий, что клавиша ContextMenuHandlers следует.

ContextMenuHandlers
{00000000-1111-2222-3333-00000000000001}

Вы можете зарегистрировать многочисленных контекстных вручителей меню для файлового типа.
Дополнительно к стандартным функциям элемента IUnknown, интерфейс вручителя контекстного меню использует QueryContextMenu, InvokeCommand, и функции элемента GetCommandString.
Когда пользователь выбирается одного из пунктов меню добавленных контекстным вручителем меню, оболочка называет вручителя IContextMenu::функция элемента InvokeCommand, чтобы позволять, чтобы вручитель обрабатывает команду. Если многочисленные контекстные вручители меню зарегистрированы для файлового типа, величина клавиши ContextMenuHandlers определяет порядок команд.

Когда система собирается отображать контекстное меню (или меню Файла в зоне меню) для файлового объекта, система называет контекстного вручителя функции элемента меню QueryContextMenu. Контекстный вручитель меню включает пункты меню позицией (MF_POSITION) непосредственно в контекстное меню вызывая функцию InsertMenu. Следующий пример показывает, что пункты меню должны быть пункты строки (MF_STRING).

STDMETHODIMP CShellExt::QueryContextMenu(HMENU hMenu, UINT indexMenu, UINT idCmdFirst, UINT idCmdLast, UINT uFlags)
{
UINT idCmd = idCmdFirst;
символ szMenuText[64];
символ szMenuText2[64];
символ szMenuText3[64];
символ szMenuText4[64];
BOOL bAppendItems=TRUE;

если ((uFlags & 0x000F) == CMF_NORMAL) { lstrcpy(szMenuText, "&меню New .GAK 1, Нормальный Файл");
lstrcpy(szMenuText2, "&меню New .GAK 2, Нормальный Файл");

lstrcpy(szMenuText3, "&меню New .GAK 3, Нормальный Файл");
lstrcpy(szMenuText4, "&меню New .GAK 4, Нормальный Файл");
} еще если (uFlags & CMF_VERBSONLY) { lstrcpy(szMenuText, "&меню New .GAK 1, Сокращенный Файл");
lstrcpy(szMenuText2, "меню N&ew .GAK 2, Сокращенный Файл");
lstrcpy(szMenuText3, "&меню New .GAK 3, Сокращенный Файл");
lstrcpy(szMenuText4, "&меню New .GAK 4, Сокращенный Файл");
} еще если (uFlags & CMF_EXPLORE) {

lstrcpy(szMenuText, "&меню New .GAK 1, щелчок права Нормального Файла в Explorer");
lstrcpy(szMenuText2, "меню N&ew .GAK 2, щелчок права Нормального Файла в Explorer");
lstrcpy(szMenuText3, "&меню New .GAK 3, щелчок права Нормального Файла в Explorer");
lstrcpy(szMenuText4, "&Новый.МЕНЮ GAK 4,
Щелчок права Нормального Файла в Explorer");
} еще если (uFlags & CMF_DEFAULTONLY) { bAppendItems = ЛОЖЬ;

} еще { символ szTemp[32];
bAppendItems = ЛОЖЬ;
}

если (bAppendItems) {
InsertMenu(hMenu, indexMenu++, MF_SEPARATOR | MF_BYPOSITION, 0, НЕДЕЙСТВИТЕЛЬНЫЙ);
InsertMenu(hMenu, indexMenu++, MF_STRING | MF_BYPOSITION, idCmd++, szMenuText);
InsertMenu(hMenu, indexMenu++, MF_SEPARATOR | MF_BYPOSITION, 0, НЕДЕЙСТВИТЕЛЬНЫЙ);
InsertMenu(hMenu, indexMenu++, MF_STRING | MF_BYPOSITION, idCmd++, szMenuText2);

InsertMenu(hMenu, indexMenu++, MF_SEPARATOR | MF_BYPOSITION, 0, НЕДЕЙСТВИТЕЛЬНЫЙ);
InsertMenu(hMenu, indexMenu++, MF_STRING | MF_BYPOSITION, idCmd++, szMenuText3);
InsertMenu(hMenu, indexMenu++, MF_STRING | MF_BYPOSITION, idCmd++, szMenuText4);

// Должно возвращать номер дополнительных пунктов меню.
возвращайте ResultFromShort(idCmd-idCmdFirst);
}
возвращайте NOERROR;
}

Система называет функцию элемента InvokeCommand когда пользователь выбирается пункт меню, что контекстный вручитель меню добавлял к контекстному меню. Функция InvokeCommand в следующем примере оперирует команды связанные пунктами меню добавленными предшествующим примером.

STDMETHODIMP CShellExt::InvokeCommand(LPCMINVOKECOMMANDINFO lpcmi)
{
HRESULT hr = E_INVALIDARG;

// Если старшее слово lpcmi->lpVerb не НЕДЕЙСТВИТЕЛЬНО, это // функция была названа приложением и lpVerb - команда //, которая должна быть активизирована. В противном случае, оболочка была названа это // функция, и младшее слово lpcmi->lpVerb является // идентификатором пункта меню, что пользователь выбирался.
если (!HIWORD(lpcmi->lpVerb)) {

UINT idCmd = LOWORD(lpcmi->lpVerb);

ключ (idCmd) { случай 0:
hr = DoGAKMenu1(lpcmi->hwnd, lpcmi->lpDirectory, lpcmi->lpVerb, lpcmi->lpParameters, lpcmi->nShow);
прерывание;

случай 1:
hr = DoGAKMenu2(lpcmi->hwnd, lpcmi->lpDirectory, lpcmi->lpVerb, lpcmi->lpParameters, lpcmi->nShow);
прерывание;

случай 2:

hr = DoGAKMenu3(lpcmi->hwnd, lpcmi->lpDirectory, lpcmi->lpVerb, lpcmi->lpParameters, lpcmi->nShow);
прерывание;

случай 3:
hr = DoGAKMenu4(lpcmi->hwnd, lpcmi->lpDirectory, lpcmi->lpVerb, lpcmi->lpParameters, lpcmi->nShow);
прерывание;
}
}
возврат hr;
}

Windows называет функцию элемента GetCommandString, чтобы получать языковую-независимую командную строку или текст подсказки для контекстного пункта меню.

Используются технологии uCoz