IUIApplication ::OnDestroyUICommand, méthode (uiribbon.h)

Appelé pour chaque commande spécifiée dans le balisage de l’infrastructure du ruban Windows lorsque la fenêtre d’application est détruite.

Syntaxe

HRESULT OnDestroyUICommand(
  [in]           UINT32            commandId,
  [in]           UI_COMMANDTYPE    typeID,
  [in, optional] IUICommandHandler *commandHandler
);

Paramètres

[in] commandId

Type : UINT32

ID de la commande, qui est spécifié dans le fichier de ressources de balisage.

[in] typeID

Type : UI_COMMANDTYPE

Type de commande associé à un contrôle spécifique.

[in, optional] commandHandler

Type : IUICommandHandler*

Pointeur vers un objet IUICommandHandler . Cette valeur peut être NULL.

Valeur retournée

Type : HRESULT

Si cette méthode réussit, elle retourne S_OK. Sinon, elle retourne un code d’erreur HRESULT.

Remarques

Cette notification de rappel est envoyée par l’infrastructure du ruban à l’application hôte pour chaque déclaration De commande dans le fichier de ressources de balisage.

Toutes les ressources de l’application hôte associées à chaque commande sont libérées.

Exemples

L’exemple suivant illustre une implémentation de base de la méthode IUIApplication ::OnDestroyUICommand .

//
//  FUNCTION:    OnDestroyUICommand(UINT, UI_COMMANDTYPE, IUICommandHandler*)
//
//  PURPOSE:    Called for each Command specified in the Ribbon markup 
//                when the Ribbon host application window is destroyed.
//
//  PARAMETERS:    
//                nCmdID - The Command identifier. 
//                typeID - The Command type. 
//                commandHandler - The Command handler. 
//
//  COMMENTS:
//
//
STDMETHODIMP CApplication::OnDestroyUICommand(
    UINT32 nCmdID,
    UI_COMMANDTYPE typeID,
    IUICommandHandler* commandHandler)
{
    return E_NOTIMPL;
}

Configuration requise

Voir aussi

IUIApplication

Exemples d’infrastructure du ruban Windows