Função OleUIAddVerbMenuA (oledlg.h)

Adiciona o menu Verbo do objeto especificado ao menu especificado.

Sintaxe

BOOL OleUIAddVerbMenuA(
  [in, optional] LPOLEOBJECT lpOleObj,
  [in, optional] LPCSTR      lpszShortType,
  [in]           HMENU       hMenu,
  [in]           UINT        uPos,
  [in]           UINT        uIDVerbMin,
  [in]           UINT        uIDVerbMax,
  [in]           BOOL        bAddConvert,
  [in]           UINT        idConvert,
  [out]          HMENU       *lphMenu
);

Parâmetros

[in, optional] lpOleObj

Ponteiro para a interface IOleObject no objeto selecionado. Se for NULL, um item de menu padrão desabilitado será criado.

[in, optional] lpszShortType

Ponteiro para o nome curto definido no registro (AuxName==2) para o objeto identificado com lpOleObj. Se a cadeia de caracteres não for conhecida, NULL poderá ser passado. Se NULL for passado, IOleObject::GetUserType será chamado para recuperá-lo. Se o chamador tiver acesso fácil à cadeia de caracteres, será mais rápido passá-la.

[in] hMenu

Manipule para o menu no qual fazer modificações.

[in] uPos

Posição do item de menu.

[in] uIDVerbMin

O valor do identificador no qual iniciar os verbos.

[in] uIDVerbMax

O valor máximo do identificador a ser usado para verbos de objeto. Se uIDVerbMax for 0, nenhum valor máximo do identificador será usado.

[in] bAddConvert

Indica se um item Converter deve ser adicionado à parte inferior do menu (precedido por um separador).

[in] idConvert

O valor do identificador a ser usado para o item de menu Converter , se bAddConvert for TRUE.

[out] lphMenu

Um ponteiro HMENU para o menu de verbo em cascata se ele for criado. Se houver apenas um verbo, ele será preenchido com NULL.

Retornar valor

Essa função retornará TRUE se lpOleObj for válido e pelo menos um verbo tiver sido adicionado ao menu. Um retorno FALSE indica que lpOleObj era NULL e um item de menu padrão desabilitado foi criado.

Comentários

Se o objeto tiver um verbo, o verbo será adicionado diretamente ao menu fornecido.

Observação

O cabeçalho oledlg.h define OleUIAddVerbMenu como um alias que seleciona automaticamente a versão ANSI ou Unicode dessa função com base na definição da constante de pré-processador UNICODE. Misturar o uso do alias neutro de codificação com código que não seja neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Convenções para protótipos de função.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows 2000 Professional [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows 2000 Server [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	oledlg.h
Biblioteca	OleDlg.lib
DLL	OleDlg.dll