IUIApplication::OnCreateUICommand method (uiribbon.h)

Artikel
03/08/2023

Dipanggil untuk setiap Perintah yang ditentukan dalam markup kerangka kerja Pita Windows untuk mengikat Perintah ke IUICommandHandler.

Sintaks

HRESULT OnCreateUICommand(
  [in]  UINT32            commandId,
  [in]  UI_COMMANDTYPE    typeID,
  [out] IUICommandHandler **commandHandler
);

Parameter

[in] commandId

Jenis: UINT32

ID untuk Perintah, yang ditentukan dalam file sumber daya markup.

[in] typeID

Jenis: UI_COMMANDTYPE

Jenis Perintah yang terkait dengan kontrol tertentu.

[out] commandHandler

Jenis: IUICommandHandler**

Ketika metode ini kembali, berisi alamat penunjuk ke objek IUICommandHandler . Objek ini adalah handler Perintah aplikasi host yang terikat ke satu atau beberapa Perintah.

Mengembalikan nilai

Jenis: HRESULT

Jika metode ini berhasil, metode akan mengembalikan S_OK. Jika tidak, kode kesalahan HRESULT akan dikembalikan.

Keterangan

Pemberitahuan panggilan balik ini dikirim oleh kerangka kerja Pita ke aplikasi host untuk setiap deklarasi Perintah yang ditemui saat memproses file sumber daya markup.

Untuk setiap Perintah yang ditentukan dalam markup Pita, kerangka kerja Pita memerlukan penangan Perintah di aplikasi host. Handler baru atau yang sudah ada harus ditetapkan ke setiap Perintah.

Contoh

Contoh berikut menunjukkan implementasi dasar metode IUIApplication::OnCreateUICommand .

//
//  FUNCTION: OnCreateUICommand(UINT, UI_COMMANDTYPE, IUICommandHandler)
//
//  PURPOSE: Called by the Ribbon framework for each command specified in markup to allow
//           the host application to bind a command handler to that command.
//
//  PARAMETERS:    
//                nCmdID - The Command identifier. 
//                typeID - The Command type. 
//                ppCommandHandler - Pointer to the address of the Command handler. 
//
//  COMMENTS:
//
//    For this sample, return the same command handler for all commands
//    specified in the .xml file.
//    
//
STDMETHODIMP CApplication::OnCreateUICommand(
    UINT nCmdID,
    UI_COMMANDTYPE typeID,
    IUICommandHandler** ppCommandHandler)
{
    HRESULT hr = E_NOTIMPL;

    switch(typeID)
    {
        case UI_COMMANDTYPE_DECIMAL:
            {
                _cwprintf(L"IUIApplication::OnCreateUICommand called for Spinner.\r\n");
                hr = _spSpinnerSite->QueryInterface(IID_PPV_ARGS(ppCommandHandler));
                break;
            }
        default:
            {
                _cwprintf(L"IUIApplication::OnCreateUICommand called with CmdID=%u, typeID=%u.\r\n", nCmdID, typeID);
                hr = _spCommandHandler->QueryInterface(IID_PPV_ARGS(ppCommandHandler));
            }
    }    
    return hr;
}

Persyaratan


Klien minimum yang didukung	Windows 7 [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2008 R2 [hanya aplikasi desktop]
Target Platform	Windows
Header	uiribbon.h
DLL	Mshtml.dll

Lihat juga

IUIApplication

Sampel Windows Ribbon Framework

Bagikan melalui