Поделиться через

Метод IRichEditOleCallback::GetContextMenu (richole.h)

  • Статья

Запрашивает у приложения контекстное меню для использования в событии щелчка правой кнопкой мыши.

Синтаксис

HRESULT GetContextMenu(
  WORD        seltype,
  LPOLEOBJECT lpoleobj,
  CHARRANGE   *lpchrg,
  HMENU       *lphmenu
);

Параметры

seltype

Тип: WORD

Тип выделения. Значение, указывающее содержимое нового выделенного фрагмента, может быть одним или несколькими из следующих значений.

Значение Значение
SEL_EMPTY
 Выделенный фрагмент пуст.
SEL_TEXT
 Текст.
SEL_OBJECT
 По крайней мере один COM-объект.
SEL_MULTICHAR
 Несколько символов текста.
SEL_MULTIOBJECT
 Более одного COM-объекта.
GCM_RIGHTMOUSEDROP
 Указывает, что необходимо создать контекстное меню для перетаскивания правой кнопкой мыши. Параметр lpoleobj является указателем на интерфейс IDataObject для удаляемого объекта.

lpoleobj

Тип: LPOLEOBJECT

Указатель на интерфейс. Если параметр seltype содержит флаг SEL_OBJECT , lpoleobj является указателем на интерфейс IOleObject для первого выбранного COM-объекта. Если seltype включает флаг GCM_RIGHTMOUSEDROP , lpoleobj является указателем на интерфейс IDataObject . В противном случае lpoleobj имеет значение NULL. Если вы удерживаете указатель интерфейса, необходимо вызвать метод AddRef , чтобы увеличить число ссылок объекта.

lpchrg

Тип: CHARRANGE*

Указатель на структуру CHARRANGE, содержащую текущий выделенный фрагмент.

lphmenu

Тип: HMENU*

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

Возвращаемое значение

Тип: HRESULT

Возвращает S_OK при успешном выполнении. Если метод завершается ошибкой, это может быть следующее значение.

Код возврата Описание
E_INVALIDARG
 Был недопустимый аргумент.

Комментарии

Когда пользователь выбирает элемент в окне контекста, WM_COMMAND сообщение отправляется в родительское окно элемента управления расширенным редактированием.

Требования

Требование Значение
Минимальная версия клиента Windows Vista [только классические приложения]
Минимальная версия сервера Windows Server 2003 [только классические приложения]
Целевая платформа Windows
Header richole.h
DLL Msftedit.dll

См. также раздел

CHARRANGE

GETCONTEXTMENUEX

IRichEditOleCallback

Справочные материалы