Version
menu_open
Wwise SDK 2023.1.5
ISourceControlDialogBase.h
Go to the documentation of this file.
1 /*******************************************************************************
2 The content of this file includes portions of the AUDIOKINETIC Wwise Technology
3 released in source code form as part of the SDK installer package.
4 
5 Commercial License Usage
6 
7 Licensees holding valid commercial licenses to the AUDIOKINETIC Wwise Technology
8 may use this file in accordance with the end user license agreement provided
9 with the software or, alternatively, in accordance with the terms contained in a
10 written agreement between you and Audiokinetic Inc.
11 
12 Apache License Usage
13 
14 Alternatively, this file may be used under the Apache License, Version 2.0 (the
15 "Apache License"); you may not use this file except in compliance with the
16 Apache License. You may obtain a copy of the Apache License at
17 http://www.apache.org/licenses/LICENSE-2.0.
18 
19 Unless required by applicable law or agreed to in writing, software distributed
20 under the Apache License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES
21 OR CONDITIONS OF ANY KIND, either express or implied. See the Apache License for
22 the specific language governing permissions and limitations under the License.
23 
24  Copyright (c) 2024 Audiokinetic Inc.
25 *******************************************************************************/
26 
27 /// \file
28 /// Wwise source control plug-in dialog interface, used to implement custom dialogs that have the Wwise look and feel.
29 
30 #ifndef _AK_WWISE_ISOURCECONTROLDIALOGBASE_H
31 #define _AK_WWISE_ISOURCECONTROLDIALOGBASE_H
32 
34 
35 // Audiokinetic namespace
36 namespace AK
37 {
38  // Audiokinetic Wwise namespace
39  namespace Wwise
40  {
41  /// Wwise dialog base interface. This must be implemented for each dialog that
42  /// needs to be displayed with the Wwise look and feel.
43  /// \akwarning
44  /// The functions in this interface are not thread-safe, unless stated otherwise.
45  /// \endakwarning
46  /// \sa
47  /// - \ref source_control_dll_creation_dialog_implement
49  {
50  public:
51 
52  /// This function is called by Wwise to get the HINSTANCE used for loading resources.
53  /// \return The HINSTANCE of the plug-in DLL resource.
54  virtual HINSTANCE GetResourceHandle() const = 0;
55 
56  /// This function is called by Wwise to get the plug-in dialog's ID.
57  virtual void GetDialog(
58  UINT & out_uiDialogID ///< The returned resource ID of the dialog
59  ) const = 0;
60 
61  /// Asks the dialog if it has Help associated with it.
62  /// \return True if the '?' Help button should be shown on the dialog, False otherwise
63  virtual bool HasHelp() const = 0;
64 
65  /// Called when the user clicks the '?' Help icon.
66  /// \return True if the plug-in handled the Help request, False otherwise
67  virtual bool Help(
68  HWND in_hWnd ///< The window handle of the dialog
69  ) const = 0;
70 
71  /// Window message handler for the dialog. This is very similar to a standard WIN32 window procedure.
72  /// \return True if the message has been processed by the plug-in, False otherwise
73  virtual bool WindowProc(
74  HWND in_hWnd, ///< The window handle of the dialog
75  UINT in_message, ///< The incoming message. This is a standard Windows message ID (e.g. WM_PAINT)
76  WPARAM in_wParam, ///< The WPARAM of the message (see MSDN)
77  LPARAM in_lParam, ///< The LPARAM of the message (see MSDN)
78  LRESULT & out_lResult ///< The returned value if the message has been processed. It is only considered if the method also returns True
79  ) = 0;
80  };
81  }
82 }
83 
84 #endif // _AK_WWISE_ISOURCECONTROLDIALOGBASE_H
Audiokinetic namespace.
virtual HINSTANCE GetResourceHandle() const =0
virtual bool HasHelp() const =0
virtual bool WindowProc(HWND in_hWnd, UINT in_message, WPARAM in_wParam, LPARAM in_lParam, LRESULT &out_lResult)=0
virtual bool Help(HWND in_hWnd) const =0
virtual void GetDialog(UINT &out_uiDialogID) const =0
This function is called by Wwise to get the plug-in dialog's ID.

Was this page helpful?

Need Support?

Questions? Problems? Need more info? Contact us, and we can help!

Visit our Support page

Tell us about your project. We're here to help.

Register your project and we'll help you get started with no strings attached!

Get started with Wwise