rmacmenu.pas

Delphi源码REAlRMSDK.rar

unit RmaCMenu;

interface

uses
  PnTypes, PnWinTyp;

//***************************************************************************
//
//  $Id: rmacmenu.h,v 1.3 1999/01/29 18:32:11 hboone Exp $
//
//  Copyright (C) 1995-1999 RealNetworks, Inc. All rights reserved.
//
//  http://www.real.com/devzone
//
//  This program contains proprietary information of RealNetworks, Inc,
//  and is licensed subject to restrictions on use and distribution.
//
//
//  RealMedia Architecture Context Menu Interfaces.
//
//

//***************************************************************************
//
//  Interface:
//
//	IRMAContextMenuResponse
//
//  Purpose:
//
//	Interface implemented by renderers that use the context menut.
//	Is called to inform the renderer that a particular menu item was
//	chosen.
//
//  IRMAContextMenuResponse:
//
//	{00001f01-0901-11d1-8B06-00A024406D59}
//
//

const
  IID_IRMAContextMenuResponse: TGUID = '{00001f01-0901-11d1-8B06-00A024406D59}';
  {$EXTERNALSYM IID_IRMAContextMenuResponse}

type
  IRMAContextMenuResponse = interface (IUnknown)
  ['{00001f01-0901-11d1-8B06-00A024406D59}']

    //***********************************************************************
    //	Method:
    //	    IRMAContextMenuResponse::OnCommand
    //	Purpose:
    //	    Called to inform the renderer that a command was chosen from
    //	    the context menu.
    //

    function OnCommand(commandID: UINT16): HRESULT; stdcall;

    //***********************************************************************
    //	Method:
    //	    IRMAContextMenuResponse::OnCanceled
    //	Purpose:
    //	    Called to inform the renderer that the context menu was closed
    //	    without a command being chosen from the renders set of commands.
    //

    function OnCanceled: HRESULT; stdcall;

  end;
  {$EXTERNALSYM IRMAContextMenuResponse}

//***************************************************************************
//
//  Interface:
//
//	IRMAContextMenu
//
//  Purpose:
//
//	Interface implemented by top level clients and provided to renderers.
//	Allows the renderer to show a context menu and the top level client
//	to add client specitic commands unknown to the renderer to that menu.
//
//  IID_IRMAContextMenu:
//
//	{00001f00-0901-11d1-8B06-00A024406D59}
//
//

const
  IID_IRMAContextMenu: TGUID = '{00001f00-0901-11d1-8B06-00A024406D59}';
  {$EXTERNALSYM IID_IRMAContextMenu}

type
  IRMAContextMenu = interface (IUnknown)
  ['{00001f00-0901-11d1-8B06-00A024406D59}']

    //***********************************************************************
    //	Method:
    //	    IRMAContextMenu::InitContextMenu
    //	Purpose:
    //	    Initializes the context menu to a blank menu, and sets the name
    //	    of the "sub menu" for the renderer if appropriate. This will
    //	    clear any previously added menu items and sub menus.
    //

    function InitContextMenu(pMenuText: PChar): HRESULT; stdcall;

    //***********************************************************************
    //	Method:
    //	    IRMAContextMenu::AddMenuItem
    //	Purpose:
    //	    Returns information vital to the instantiation of rendering
    //	    plugins.
    //

    function AddMenuItem(commandID: UINT16; pMenuItemText: PChar; bChecked,
      bRadioOn, bDisabled: BOOL): HRESULT; stdcall;

    //***********************************************************************
    //	Method:
    //	    IRMAContextMenu::AddMenuItem
    //	Purpose:
    //	    Returns information vital to the instantiation of rendering
    //	    plugins.
    //

    function AddSeparator: HRESULT; stdcall;

    //***********************************************************************
    //	Method:
    //	    IRMAContextMenu::AddChildMenu
    //	Purpose:
    //	    Returns information vital to the instantiation of rendering
    //	    plugins.
    //

    function AddChildMenu(pMenuText: PChar): HRESULT; stdcall;

    //***********************************************************************
    //	Method:
    //	    IRMAContextMenu::EndChildMenu
    //	Purpose:
    //	    Returns information vital to the instantiation of rendering
    //	    plugins.
    //

    function EndChildMenu: HRESULT; stdcall;

    //***********************************************************************
    //	Method:
    //	    IRMAContextMenu::ChangeMenuItem
    //	Purpose:
    //	    Returns information vital to the instantiation of rendering
    //	    plugins.
    //

    function ChangeMenuItem(commandID: UINT16; pMenuItemText: PChar; bChecked,
      bRadioOn, bDisabled: BOOL): HRESULT; stdcall;

    //***********************************************************************
    //	Method:
    //	    IRMAContextMenu::ShowMenu
    //	Purpose:
    //	    Shows the setup context menu at the specified point.
    //

    function ShowMenu(pResonse: IRMAContextMenuResponse; ptPopup: PNxPoint): HRESULT; stdcall;

  end;
  {$EXTERNALSYM IRMAContextMenu}

implementation

end.