Função OleUIAddVerbMenuA (oledlg.h)

Artigo
11/20/2024

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 isso 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 passada. 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 na 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 VERDADEIRO.

[out] lphMenu

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

Valor de retorno

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 foi NULL e um item de menu padrão desabilitado foi criado.

Observações

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

Nota

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 do pré-processador UNICODE. A combinação do uso do alias neutro de codificação com código que não é neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Conventions for Function Prototypes.

Requisitos

Requisito	Valor
de cliente com suporte mínimo	Windows 2000 Professional [somente aplicativos da área de trabalho]
servidor com suporte mínimo	Windows 2000 Server [somente aplicativos da área de trabalho]
da Plataforma de Destino	Windows
cabeçalho	oledlg.h
biblioteca	OleDlg.lib
de DLL	OleDlg.dll

Compartilhar via