dsound: Add COM aggregation to DirectSound for internal use.
[wine/multimedia.git] / programs / winecfg / winecfg.h
blobe8289ea5ea9e8cd3ba38090f0244815753636908
1 /*
2 * WineCfg configuration management
4 * Copyright 2002 Jaco Greeff
5 * Copyright 2003 Dimitrie O. Paun
6 * Copyright 2004 Mike Hearn
8 * This library is free software; you can redistribute it and/or
9 * modify it under the terms of the GNU Lesser General Public
10 * License as published by the Free Software Foundation; either
11 * version 2.1 of the License, or (at your option) any later version.
13 * This library is distributed in the hope that it will be useful,
14 * but WITHOUT ANY WARRANTY; without even the implied warranty of
15 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
16 * Lesser General Public License for more details.
18 * You should have received a copy of the GNU Lesser General Public
19 * License along with this library; if not, write to the Free Software
20 * Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301, USA
24 #ifndef WINE_CFG_H
25 #define WINE_CFG_H
27 #include <stdarg.h>
29 #include "windef.h"
30 #include "winbase.h"
31 #include "wingdi.h"
32 #include "winuser.h"
33 #include "winnls.h"
34 #include "commctrl.h"
36 #define IS_OPTION_TRUE(ch) \
37 ((ch) == 'y' || (ch) == 'Y' || (ch) == 't' || (ch) == 'T' || (ch) == '1')
38 #define IS_OPTION_FALSE(ch) \
39 ((ch) == 'n' || (ch) == 'N' || (ch) == 'f' || (ch) == 'F' || (ch) == '0')
41 extern WCHAR* current_app; /* NULL means editing global settings */
43 /* Use get_reg_key and set_reg_key to alter registry settings. The changes made through
44 set_reg_key won't be committed to the registry until process_all_settings is called,
45 however get_reg_key will still return accurate information.
47 The root HKEY has to be non-ambiguous. So only the registry roots (HKCU, HKLM, ...) or
48 the global config_key are allowed here.
50 You are expected to HeapFree the result of get_reg_key. The parameters to set_reg_key will
51 be copied, so free them too when necessary.
54 void set_reg_keyW(HKEY root, const WCHAR *path, const WCHAR *name, const WCHAR *value);
55 void set_reg_key_dwordW(HKEY root, const WCHAR *path, const WCHAR *name, DWORD value);
56 WCHAR *get_reg_keyW(HKEY root, const WCHAR *path, const WCHAR *name, const WCHAR *def);
58 void set_reg_key(HKEY root, const char *path, const char *name, const char *value);
59 void set_reg_key_dword(HKEY root, const char *path, const char *name, DWORD value);
60 char *get_reg_key(HKEY root, const char *path, const char *name, const char *def);
61 BOOL reg_key_exists(HKEY root, const char *path, const char *name);
62 void apply(void);
63 char **enumerate_values(HKEY root, char *path);
65 /* Load a string from the resources. Allocated with HeapAlloc (GetProcessHeap()) */
66 WCHAR* load_string (UINT id);
68 /* returns a string of the form "AppDefaults\\appname.exe\\section", or just "section" if
69 the user is editing the global settings.
71 no explicit free is needed of the string returned by this function
73 char *keypath(const char *section);
74 WCHAR *keypathW(const WCHAR *section);
76 int initialize(HINSTANCE hInstance);
77 extern HKEY config_key;
79 /* hack for the property sheet control */
80 void set_window_title(HWND dialog);
82 /* Window procedures */
83 INT_PTR CALLBACK GraphDlgProc (HWND hDlg, UINT uMsg, WPARAM wParam, LPARAM lParam);
84 INT_PTR CALLBACK DriveDlgProc (HWND hDlg, UINT uMsg, WPARAM wParam, LPARAM lParam);
85 INT_PTR CALLBACK DriveEditDlgProc (HWND hDlg, UINT uMsg, WPARAM wParam, LPARAM lParam);
86 INT_PTR CALLBACK AppDlgProc (HWND hDlg, UINT uMsg, WPARAM wParam, LPARAM lParam);
87 INT_PTR CALLBACK LibrariesDlgProc (HWND hDlg, UINT uMsg, WPARAM wParam, LPARAM lParam);
88 INT_PTR CALLBACK AudioDlgProc (HWND hDlg, UINT uMsg, WPARAM wParam, LPARAM lParam);
89 INT_PTR CALLBACK ThemeDlgProc (HWND hDlg, UINT uMsg, WPARAM wParam, LPARAM lParam);
90 INT_PTR CALLBACK AboutDlgProc (HWND hDlg, UINT uMsg, WPARAM wParam, LPARAM lParam);
92 /* Drive management */
93 BOOL load_drives(void);
94 int autodetect_drives(void);
96 struct drive
98 char letter;
99 char *unixpath;
100 char *device;
101 WCHAR *label;
102 DWORD serial;
103 DWORD type; /* one of the DRIVE_ constants from winbase.h */
105 BOOL in_use;
106 BOOL modified;
109 #define DRIVE_MASK_BIT(B) (1 << (toupper(B) - 'A'))
111 ULONG drive_available_mask(char letter);
112 BOOL add_drive(char letter, const char *targetpath, const char *device,
113 const WCHAR *label, DWORD serial, DWORD type);
114 void delete_drive(struct drive *pDrive);
115 void apply_drive_changes(void);
116 BOOL browse_for_unix_folder(HWND dialog, WCHAR *pszPath);
117 extern struct drive drives[26]; /* one for each drive letter */
119 extern BOOL gui_mode;
121 /* Some basic utilities to make win32 suck less */
122 #define disable(id) EnableWindow(GetDlgItem(dialog, id), 0);
123 #define enable(id) EnableWindow(GetDlgItem(dialog, id), 1);
124 void PRINTERROR(void); /* WINE_TRACE() the plaintext error message from GetLastError() */
126 /* returns a string in the win32 heap */
127 static inline char *strdupA(const char *s)
129 char *r = HeapAlloc(GetProcessHeap(), 0, strlen(s)+1);
130 return strcpy(r, s);
133 static inline WCHAR *strdupW(const WCHAR *s)
135 WCHAR *r = HeapAlloc(GetProcessHeap(), 0, (lstrlenW(s)+1)*sizeof(WCHAR));
136 return lstrcpyW(r, s);
139 /* create a unicode string from a string in Unix locale */
140 static inline WCHAR *strdupU2W(const char *unix_str)
142 WCHAR *unicode_str;
143 int lenW;
145 lenW = MultiByteToWideChar(CP_UNIXCP, 0, unix_str, -1, NULL, 0);
146 unicode_str = HeapAlloc(GetProcessHeap(), 0, lenW * sizeof(WCHAR));
147 if (unicode_str)
148 MultiByteToWideChar(CP_UNIXCP, 0, unix_str, -1, unicode_str, lenW);
149 return unicode_str;
152 static inline char *get_text(HWND dialog, WORD id)
154 HWND item = GetDlgItem(dialog, id);
155 int len = GetWindowTextLengthA(item) + 1;
156 char *result = len ? HeapAlloc(GetProcessHeap(), 0, len) : NULL;
157 if (!result || GetWindowTextA(item, result, len) == 0) return NULL;
158 return result;
161 static inline WCHAR *get_textW(HWND dialog, WORD id)
163 HWND item = GetDlgItem(dialog, id);
164 int len = GetWindowTextLengthW(item) + 1;
165 WCHAR *result = len ? HeapAlloc(GetProcessHeap(), 0, len * sizeof(WCHAR)) : NULL;
166 if (!result || GetWindowTextW(item, result, len) == 0) return NULL;
167 return result;
170 static inline void set_text(HWND dialog, WORD id, const char *text)
172 SetWindowTextA(GetDlgItem(dialog, id), text);
175 static inline void set_textW(HWND dialog, WORD id, const WCHAR *text)
177 SetWindowTextW(GetDlgItem(dialog, id), text);
180 #define WINE_KEY_ROOT "Software\\Wine"
181 #define MAXBUFLEN 256
183 extern HMENU hPopupMenus;
185 #endif