1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
|
/*********************************************************
* Copyright (C) 2008 VMware, Inc. All rights reserved.
*
* This program is free software; you can redistribute it and/or modify it
* under the terms of the GNU Lesser General Public License as published
* by the Free Software Foundation version 2.1 and no later version.
*
* This program is distributed in the hope that it will be useful, but
* WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY
* or FITNESS FOR A PARTICULAR PURPOSE. See the Lesser GNU General Public
* License for more details.
*
* You should have received a copy of the GNU Lesser General Public License
* along with this program; if not, write to the Free Software Foundation, Inc.,
* 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
*
*********************************************************/
/*
* appUtil.h --
*
* Utility functions for guest applications.
*/
#ifndef _APP_UTIL_H_
#define _APP_UTIL_H_
#ifdef __cplusplus
extern "C" {
#endif // __cplusplus
#include "vmware.h"
#include "vmware/guestrpc/capabilities.h"
#ifdef __cplusplus
};
#endif // __cplusplus
#ifdef _WIN32
/* The maximum number of icons that can be retrieved in a single query. */
#define APPUTIL_MAX_NUM_ICONS 16
/* Predefined (N x N pixels) icon sizes */
#define APPUTIL_ICON_SMALL 16
#define APPUTIL_ICON_BIG 32
typedef struct AppUtilIconEntry {
uint32 width; // width of icon in pixels
uint32 height; // height of icon in pixels
uint32 widthBytes; // width of one row in bytes, including padding
uint32 dataLength; // length of bgra data, in bytes
unsigned char *dataBGRA; // pointer to bgra data
} AppUtilIconEntry;
typedef struct AppUtilIconInfo {
uint32 numEntries;
AppUtilIconEntry *iconList;
} AppUtilIconInfo;
typedef enum {
APPUTIL_UPPER_LEFT_DIB = -1, // the origin is the upper-left corner of the bitmap
APPUTIL_LOWER_LEFT_DIB = 1, // the origin is the lower-left corner of the bitmap
} AppUtilBitmapOrigin;
#ifdef __cplusplus
extern "C" {
#endif // __cplusplus
Bool AppUtil_GetIconDataByHandle(HICON hIcon,
AppUtilBitmapOrigin origin,
AppUtilIconEntry *icon);
Bool AppUtil_GetDIBitsAlloc(HDC hdc,
HBITMAP hbmp,
UINT uStartScan,
UINT cScanLines,
LPBITMAPINFO lpbi,
UINT uUsage,
char **bits);
HICON AppUtil_GetWindowIcon(HWND hwnd,
uint32 iconSize);
void AppUtil_BuildGlobalApplicationList(void);
char *AppUtil_ActionURIForCommandLine(const WCHAR *commandLineUtf16);
Bool AppUtil_CommandLineForShellCommandURI(const char *shellCommandURI,
char **executablePath,
char **commandLine);
Bool AppUtil_GetLinkIconData(const TCHAR *path,
AppUtilIconInfo *iconInfo,
AppUtilBitmapOrigin dibOrientation);
Bool AppUtil_GetAppIconData(const TCHAR *path,
AppUtilIconInfo *iconInfo,
AppUtilBitmapOrigin dibOrientation);
Bool AppUtil_LoadIcon(HMODULE module,
LPCWSTR resID,
AppUtilBitmapOrigin origin,
AppUtilIconInfo *icon);
Bool AppUtil_CopyIcon(const AppUtilIconInfo *srcIcon, AppUtilIconInfo *dstIcon);
void AppUtil_DestroyIcon(AppUtilIconInfo *icon);
Bool AppUtil_GetIconIndexAndLocationForShortcut(const TCHAR *shortcut,
int maxLen,
TCHAR *iconFile,
int *iconIndex);
LPSTR AppUtil_ToLowerUtf8(LPCSTR s);
LPWSTR AppUtil_ToLowerUtf16(LPCWSTR s);
#ifdef __cplusplus
};
#endif // __cplusplus
#else // not _WIN32
#include <glib.h>
#ifdef __cplusplus
extern "C" {
#endif // __cplusplus
void AppUtil_Init(void);
GPtrArray *AppUtil_CollectIconArray(const char *iconName,
unsigned long windowID);
void AppUtil_FreeIconArray(GPtrArray *pixbufs);
Bool AppUtil_AppIsSkippable(const char *appName);
char *AppUtil_CanonicalizeAppName(const char *appName,
const char *cwd);
#ifdef __cplusplus
};
#endif // __cplusplus
#endif
/*
* Platform-independent functions.
*/
#ifdef __cplusplus
extern "C" {
#endif // __cplusplus
void AppUtil_SendGuestCaps(const GuestCapabilities *caps,
size_t numCaps,
Bool enabled);
#ifdef __cplusplus
};
#endif // __cplusplus
#endif // _APP_UTIL_H_
|
