From 22934fb41a3a4a6599c8ed5f9b37f803e1565bc4 Mon Sep 17 00:00:00 2001 From: pit-ray Date: Tue, 13 Feb 2024 17:24:17 +0900 Subject: [PATCH] add balloon tip method --- demo/demo.cpp | 4 + ...sfluent__tray_1_1_fluent_tray-members.html | 15 +- docs/classfluent__tray_1_1_fluent_tray.html | 43 + docs/fluent__tray_8hpp_source.html | 779 +++++++++--------- docs/functions.html | 1 + docs/functions_func.html | 1 + docs/search/all_e.js | 15 +- docs/search/functions_d.js | 13 +- include/fluent_tray.hpp | 39 + 9 files changed, 518 insertions(+), 392 deletions(-) diff --git a/demo/demo.cpp b/demo/demo.cpp index e831624..d40dd8d 100644 --- a/demo/demo.cpp +++ b/demo/demo.cpp @@ -80,5 +80,9 @@ int main() return 1 ; } + if(!tray.show_balloon_tip("Balloon Tips", "Successfully Exited!")) { + return 1 ; + } + return 0 ; } diff --git a/docs/classfluent__tray_1_1_fluent_tray-members.html b/docs/classfluent__tray_1_1_fluent_tray-members.html index 7707dd0..3cfdc8e 100644 --- a/docs/classfluent__tray_1_1_fluent_tray-members.html +++ b/docs/classfluent__tray_1_1_fluent_tray-members.html @@ -105,13 +105,14 @@ operator=(FluentTray &&)=defaultfluent_tray::FluentTray set_color(const COLORREF &text_color=CLR_INVALID, const COLORREF &back_color=CLR_INVALID, unsigned char color_decay=10)fluent_tray::FluentTrayinline set_font(LONG font_size=0, LONG font_weight=0, const std::string &font_name="")fluent_tray::FluentTrayinline - show_menu_window()fluent_tray::FluentTrayinline - status() const noexceptfluent_tray::FluentTrayinline - stop() noexceptfluent_tray::FluentTrayinline - update()fluent_tray::FluentTrayinline - update_with_loop(std::chrono::milliseconds sleep_time=std::chrono::milliseconds(1))fluent_tray::FluentTrayinline - window_handle() const noexceptfluent_tray::FluentTrayinline - ~FluentTray() noexceptfluent_tray::FluentTrayinlinevirtual + show_balloon_tip(const std::string &title, const std::string &message)fluent_tray::FluentTrayinline + show_menu_window()fluent_tray::FluentTrayinline + status() const noexceptfluent_tray::FluentTrayinline + stop() noexceptfluent_tray::FluentTrayinline + update()fluent_tray::FluentTrayinline + update_with_loop(std::chrono::milliseconds sleep_time=std::chrono::milliseconds(1))fluent_tray::FluentTrayinline + window_handle() const noexceptfluent_tray::FluentTrayinline + ~FluentTray() noexceptfluent_tray::FluentTrayinlinevirtual
diff --git a/docs/classfluent__tray_1_1_fluent_tray.html b/docs/classfluent__tray_1_1_fluent_tray.html index 23cd2dd..0413b26 100644 --- a/docs/classfluent__tray_1_1_fluent_tray.html +++ b/docs/classfluent__tray_1_1_fluent_tray.html @@ -129,6 +129,9 @@ bool hide_menu_window ()  Hide the menu window above the tray icon.
  +bool show_balloon_tip (const std::string &title, const std::string &message) + Shows a balloon tip that is placed in the notification area.
+  TrayStatus status () const noexcept  Get the current status of tray.
  @@ -890,6 +893,46 @@

Returns
Returns true on success, false on failure.

For font_weight, you can use the constant value specified for lfWeght in LOGFONT. The default value used is FW_MEDIUM(500).

+ + + +

◆ show_balloon_tip()

+ +
+
+ + + + + +
+ + + + + + + + + + + +
bool fluent_tray::FluentTray::show_balloon_tip (const std::string & title,
const std::string & message )
+ 		+inline
+
+ +

Shows a balloon tip that is placed in the notification area.

+
Parameters
+ + + +
[in]titleThe UTF-8 string of title.
[in]messageThe UTF-8 string of message.
+
+
+
Returns
Returns true on success, false on failure.
+

Titles longer than 48 characters and messages longer than 200 characters will be trimmed.

+
diff --git a/docs/fluent__tray_8hpp_source.html b/docs/fluent__tray_8hpp_source.html index fe79281..0f4ef1f 100644 --- a/docs/fluent__tray_8hpp_source.html +++ b/docs/fluent__tray_8hpp_source.html @@ -1063,390 +1063,424 @@
1116 }
1117
-
-
1122 TrayStatus status() const noexcept {
-
1123 return status_ ;
-
1124 }
-
-
1125
-
-
1129 void stop() noexcept {
-
1130 status_ = TrayStatus::SHOULD_STOP ;
-
1131 }
-
-
1132
-
-
1137 std::vector<FluentMenu>::iterator begin() noexcept {
-
1138 return menus_.begin() ;
-
1139 }
-
+
+
1125 bool show_balloon_tip(const std::string& title, const std::string& message) {
+
1126 NOTIFYICONDATAW notify_data = {} ;
+
1127 notify_data.cbSize = sizeof(notify_data) ;
+
1128 notify_data.hWnd = hwnd_ ;
+
1129 notify_data.uFlags = NIF_INFO ;
+
1130
+
1131 std::wstring title_wide ;
+
1132 if(!util::string2wstring(title, title_wide)) {
+
1133 return false ;
+
1134 }
+
1135
+
1136 std::wstring message_wide ;
+
1137 if(!util::string2wstring(message, message_wide)) {
+
1138 return false ;
+
1139 }
1140
-
-
1145 std::vector<FluentMenu>::iterator end() noexcept {
-
1146 return menus_.end() ;
-
1147 }
-
-
1148
-
-
1153 std::vector<FluentMenu>::const_iterator cbegin() const noexcept {
-
1154 return menus_.cbegin() ;
+
1141 auto title_len = title_wide.length() > 47 ? 47 : title_wide.length() ;
+
1142 std::wmemcpy(
+
1143 notify_data.szInfoTitle, title_wide.c_str(), title_len) ;
+
1144 notify_data.szInfoTitle[title_len] = L'\0' ;
+
1145
+
1146 auto message_len = message_wide.length() > 199 ? 199 : message_wide.length() ;
+
1147 std::wmemcpy(
+
1148 notify_data.szInfo, message_wide.c_str(), message_len) ;
+
1149 notify_data.szInfo[message_len] = L'\0' ;
+
1150
+
1151 if(!Shell_NotifyIconW(NIM_MODIFY, &notify_data)) {
+
1152 return false ;
+
1153 }
+
1154 return true ;
1155 }
1156
-
1161 std::vector<FluentMenu>::const_iterator cend() const noexcept {
-
1162 return menus_.cend() ;
+
1161 TrayStatus status() const noexcept {
+
1162 return status_ ;
1163 }
1164
-
-
1169 FluentMenu& front() {
-
1170 return menus_.front() ;
-
1171 }
+
+
1168 void stop() noexcept {
+
1169 status_ = TrayStatus::SHOULD_STOP ;
+
1170 }
+
+
1171
+
+
1176 std::vector<FluentMenu>::iterator begin() noexcept {
+
1177 return menus_.begin() ;
+
1178 }
-
1172
-
-
1177 const FluentMenu& front() const {
-
1178 return menus_.front() ;
-
1179 }
+
1179
+
+
1184 std::vector<FluentMenu>::iterator end() noexcept {
+
1185 return menus_.end() ;
+
1186 }
-
1180
-
-
1185 FluentMenu& back() {
-
1186 return menus_.back() ;
-
1187 }
+
1187
+
+
1192 std::vector<FluentMenu>::const_iterator cbegin() const noexcept {
+
1193 return menus_.cbegin() ;
+
1194 }
-
1188
-
-
1193 const FluentMenu& back() const {
-
1194 return menus_.back() ;
-
1195 }
+
1195
+
+
1200 std::vector<FluentMenu>::const_iterator cend() const noexcept {
+
1201 return menus_.cend() ;
+
1202 }
-
1196
-
-
1201 std::size_t count_menus() const noexcept {
-
1202 return menus_.size() ;
-
1203 }
+
1203
+
+
1208 FluentMenu& front() {
+
1209 return menus_.front() ;
+
1210 }
+
+
1211
+
+
1216 const FluentMenu& front() const {
+
1217 return menus_.front() ;
+
1218 }
-
1204
-
-
1213 bool set_font(
-
1214 LONG font_size=0,
-
1215 LONG font_weight=0,
-
1216 const std::string& font_name="") {
-
1217 NONCLIENTMETRICSW metrics ;
-
1218 metrics.cbSize = sizeof(metrics) ;
1219
-
1220 if(!SystemParametersInfoW(
-
1221 SPI_GETNONCLIENTMETRICS,
-
1222 metrics.cbSize, &metrics, 0)) {
-
1223 return false ;
-
1224 }
-
1225
-
1226 auto& logfont = metrics.lfCaptionFont ;
-
1227 if(font_size != 0) {
-
1228 logfont.lfHeight = font_size ;
-
1229 }
-
1230 else {
-
1231 logfont.lfHeight = 20 ;
-
1232 }
-
1233 if(font_weight != 0) {
-
1234 logfont.lfWeight = font_weight ;
-
1235 }
-
1236 else {
-
1237 logfont.lfWeight = FW_MEDIUM ;
-
1238 }
-
1239
-
1240 if(!font_name.empty()) {
-
1241 std::wstring font_name_wide ;
-
1242 if(!util::string2wstring(font_name, font_name_wide)) {
-
1243 return false ;
-
1244 }
-
1245 auto& dst = logfont.lfFaceName ;
-
1246
-
1247 if(font_name_wide.size() < LF_FACESIZE) {
-
1248 std::wmemcpy(
-
1249 dst, font_name_wide.c_str(), font_name_wide.length()) ;
-
1250 dst[font_name_wide.size()] = L'\0' ;
-
1251 }
-
1252 else {
-
1253 std::wmemcpy(
-
1254 dst, font_name_wide.c_str(), LF_FACESIZE - 1) ;
-
1255 dst[LF_FACESIZE - 1] = L'\0' ;
-
1256 }
-
1257 }
+
+
1224 FluentMenu& back() {
+
1225 return menus_.back() ;
+
1226 }
+
+
1227
+
+
1232 const FluentMenu& back() const {
+
1233 return menus_.back() ;
+
1234 }
+
+
1235
+
+
1240 std::size_t count_menus() const noexcept {
+
1241 return menus_.size() ;
+
1242 }
+
+
1243
+
+
1252 bool set_font(
+
1253 LONG font_size=0,
+
1254 LONG font_weight=0,
+
1255 const std::string& font_name="") {
+
1256 NONCLIENTMETRICSW metrics ;
+
1257 metrics.cbSize = sizeof(metrics) ;
1258
-
1259 auto font = CreateFontIndirectW(&logfont) ;
-
1260 if(!font) {
-
1261 return false ;
-
1262 }
-
1263 font_ = font ;
-
1264 menu_font_size_ = std::abs(logfont.lfHeight) ;
-
1265
-
1266 return true;
-
1267 }
+
1259 if(!SystemParametersInfoW(
+
1260 SPI_GETNONCLIENTMETRICS,
+
1261 metrics.cbSize, &metrics, 0)) {
+
1262 return false ;
+
1263 }
+
1264
+
1265 auto& logfont = metrics.lfCaptionFont ;
+
1266 if(font_size != 0) {
+
1267 logfont.lfHeight = font_size ;
+
1268 }
+
1269 else {
+
1270 logfont.lfHeight = 20 ;
+
1271 }
+
1272 if(font_weight != 0) {
+
1273 logfont.lfWeight = font_weight ;
+
1274 }
+
1275 else {
+
1276 logfont.lfWeight = FW_MEDIUM ;
+
1277 }
+
1278
+
1279 if(!font_name.empty()) {
+
1280 std::wstring font_name_wide ;
+
1281 if(!util::string2wstring(font_name, font_name_wide)) {
+
1282 return false ;
+
1283 }
+
1284 auto& dst = logfont.lfFaceName ;
+
1285
+
1286 if(font_name_wide.size() < LF_FACESIZE) {
+
1287 std::wmemcpy(
+
1288 dst, font_name_wide.c_str(), font_name_wide.length()) ;
+
1289 dst[font_name_wide.size()] = L'\0' ;
+
1290 }
+
1291 else {
+
1292 std::wmemcpy(
+
1293 dst, font_name_wide.c_str(), LF_FACESIZE - 1) ;
+
1294 dst[LF_FACESIZE - 1] = L'\0' ;
+
1295 }
+
1296 }
+
1297
+
1298 auto font = CreateFontIndirectW(&logfont) ;
+
1299 if(!font) {
+
1300 return false ;
+
1301 }
+
1302 font_ = font ;
+
1303 menu_font_size_ = std::abs(logfont.lfHeight) ;
+
1304
+
1305 return true;
+
1306 }
-
1268
-
-
1276 bool set_color(
-
1277 const COLORREF& text_color=CLR_INVALID,
-
1278 const COLORREF& back_color=CLR_INVALID,
-
1279 unsigned char color_decay=10) {
-
1280 if(back_color == CLR_INVALID) {
-
1281 // Get Taskbar color
-
1282 APPBARDATA abd ;
-
1283 abd.cbSize = sizeof(abd) ;
-
1284 if(!SHAppBarMessage(ABM_GETTASKBARPOS, &abd)) {
-
1285 return false ;
-
1286 }
-
1287
-
1288 if(auto dc = GetDC(NULL)) {
-
1289 // Get Taskbar color
-
1290 back_color_ = GetPixel(dc, abd.rc.left + 1, abd.rc.top + 1) ;
-
1291 if(back_color_ == CLR_INVALID) {
-
1292 // if failed, use COLOR_WINDOW color.
-
1293 back_color_ = GetSysColor(COLOR_WINDOW) ;
-
1294 }
-
1295 if(!ReleaseDC(NULL, dc)) {
-
1296 return false ;
-
1297 }
-
1298 }
-
1299 }
-
1300 else {
-
1301 back_color_ = back_color ;
-
1302 }
-
1303
-
1304 auto back_gray_color_ = util::rgb2gray(back_color_) ;
-
1305
-
1306 unsigned char ash_value = back_gray_color_ ;
-
1307 if(back_gray_color_ < 128) {
-
1308 ash_value = static_cast<decltype(ash_value)>(
-
1309 (std::min)(ash_value + color_decay, 255)) ;
-
1310 }
-
1311 else {
-
1312 ash_value = static_cast<decltype(ash_value)>(
-
1313 (std::max)(ash_value - color_decay, 0)) ;
-
1314 }
-
1315 ash_color_ = RGB(ash_value, ash_value, ash_value) ;
-
1316
-
1317 if(text_color == CLR_INVALID) {
-
1318 text_color_ = GetSysColor(COLOR_WINDOWTEXT) ;
-
1319 if(back_gray_color_ < 128) {
-
1320 // if dark background, use light text color.
-
1321 text_color_ = 0x00FFFFFF & ~text_color_ ;
-
1322 }
-
1323 }
-
1324 else {
-
1325 text_color_ = text_color ;
-
1326 }
-
1327
-
1328 if(back_brush_) {
-
1329 // Release old handle.
-
1330 if(!DeleteObject(back_brush_)) {
-
1331 return false ;
-
1332 }
-
1333 }
-
1334 back_brush_ = CreateSolidBrush(back_color_) ;
-
1335 if(back_brush_ == NULL) {
-
1336 return false ;
-
1337 }
-
1338
-
1339 if(!SetClassLongPtr(
-
1340 hwnd_, GCLP_HBRBACKGROUND,
-
1341 reinterpret_cast<LONG_PTR>(back_brush_))) {
-
1342 return false ;
-
1343 }
+
1307
+
+
1315 bool set_color(
+
1316 const COLORREF& text_color=CLR_INVALID,
+
1317 const COLORREF& back_color=CLR_INVALID,
+
1318 unsigned char color_decay=10) {
+
1319 if(back_color == CLR_INVALID) {
+
1320 // Get Taskbar color
+
1321 APPBARDATA abd ;
+
1322 abd.cbSize = sizeof(abd) ;
+
1323 if(!SHAppBarMessage(ABM_GETTASKBARPOS, &abd)) {
+
1324 return false ;
+
1325 }
+
1326
+
1327 if(auto dc = GetDC(NULL)) {
+
1328 // Get Taskbar color
+
1329 back_color_ = GetPixel(dc, abd.rc.left + 1, abd.rc.top + 1) ;
+
1330 if(back_color_ == CLR_INVALID) {
+
1331 // if failed, use COLOR_WINDOW color.
+
1332 back_color_ = GetSysColor(COLOR_WINDOW) ;
+
1333 }
+
1334 if(!ReleaseDC(NULL, dc)) {
+
1335 return false ;
+
1336 }
+
1337 }
+
1338 }
+
1339 else {
+
1340 back_color_ = back_color ;
+
1341 }
+
1342
+
1343 auto back_gray_color_ = util::rgb2gray(back_color_) ;
1344
-
1345 return true ;
-
1346 }
+
1345 unsigned char ash_value = back_gray_color_ ;
+
1346 if(back_gray_color_ < 128) {
+
1347 ash_value = static_cast<decltype(ash_value)>(
+
1348 (std::min)(ash_value + color_decay, 255)) ;
+
1349 }
+
1350 else {
+
1351 ash_value = static_cast<decltype(ash_value)>(
+
1352 (std::max)(ash_value - color_decay, 0)) ;
+
1353 }
+
1354 ash_color_ = RGB(ash_value, ash_value, ash_value) ;
+
1355
+
1356 if(text_color == CLR_INVALID) {
+
1357 text_color_ = GetSysColor(COLOR_WINDOWTEXT) ;
+
1358 if(back_gray_color_ < 128) {
+
1359 // if dark background, use light text color.
+
1360 text_color_ = 0x00FFFFFF & ~text_color_ ;
+
1361 }
+
1362 }
+
1363 else {
+
1364 text_color_ = text_color ;
+
1365 }
+
1366
+
1367 if(back_brush_) {
+
1368 // Release old handle.
+
1369 if(!DeleteObject(back_brush_)) {
+
1370 return false ;
+
1371 }
+
1372 }
+
1373 back_brush_ = CreateSolidBrush(back_color_) ;
+
1374 if(back_brush_ == NULL) {
+
1375 return false ;
+
1376 }
+
1377
+
1378 if(!SetClassLongPtr(
+
1379 hwnd_, GCLP_HBRBACKGROUND,
+
1380 reinterpret_cast<LONG_PTR>(back_brush_))) {
+
1381 return false ;
+
1382 }
+
1383
+
1384 return true ;
+
1385 }
-
1347
-
-
1352 bool change_icon(const std::string& icon_path) {
-
1353 if(icon_data_.cbSize > 0) {
-
1354 if(!Shell_NotifyIconW(NIM_DELETE, &icon_data_)) {
-
1355 return false ;
-
1356 }
-
1357 }
-
1358
-
1359 ZeroMemory(&icon_data_, sizeof(icon_data_)) ;
-
1360
-
1361 if(icon_path.empty()) {
-
1362 icon_data_.cbSize = 0 ;
-
1363 return true ;
-
1364 }
-
1365
-
1366 std::wstring icon_path_wide ;
-
1367 if(!util::string2wstring(icon_path, icon_path_wide)) {
-
1368 return false ;
-
1369 }
-
1370
-
1371 if(!util::exists(icon_path_wide)) {
-
1372 return false ;
-
1373 }
-
1374
-
1375 icon_data_.cbSize = sizeof(icon_data_) ;
-
1376 icon_data_.hWnd = hwnd_ ;
-
1377 icon_data_.uFlags = NIF_ICON | NIF_MESSAGE | NIF_TIP ;
-
1378 icon_data_.uCallbackMessage = MESSAGE_ID ;
-
1379 icon_data_.hIcon = static_cast<HICON>(
-
1380 LoadImageW(
-
1381 NULL, icon_path_wide.c_str(),
-
1382 IMAGE_ICON, 0, 0, LR_LOADFROMFILE)) ;
-
1383 wcscpy_s(icon_data_.szTip, app_name_.c_str()) ;
-
1384 icon_data_.dwState = NIS_SHAREDICON ;
-
1385 icon_data_.dwStateMask = NIS_SHAREDICON ;
1386
-
1387 if(!Shell_NotifyIconW(NIM_ADD, &icon_data_)) {
-
1388 return false ;
-
1389 }
-
1390 hide_menu_window() ;
-
1391
-
1392 return true ;
-
1393 }
+
+
1391 bool change_icon(const std::string& icon_path) {
+
1392 if(icon_data_.cbSize > 0) {
+
1393 if(!Shell_NotifyIconW(NIM_DELETE, &icon_data_)) {
+
1394 return false ;
+
1395 }
+
1396 }
+
1397
+
1398 ZeroMemory(&icon_data_, sizeof(icon_data_)) ;
+
1399
+
1400 if(icon_path.empty()) {
+
1401 icon_data_.cbSize = 0 ;
+
1402 return true ;
+
1403 }
+
1404
+
1405 std::wstring icon_path_wide ;
+
1406 if(!util::string2wstring(icon_path, icon_path_wide)) {
+
1407 return false ;
+
1408 }
+
1409
+
1410 if(!util::exists(icon_path_wide)) {
+
1411 return false ;
+
1412 }
+
1413
+
1414 icon_data_.cbSize = sizeof(icon_data_) ;
+
1415 icon_data_.hWnd = hwnd_ ;
+
1416 icon_data_.uFlags = NIF_ICON | NIF_MESSAGE | NIF_TIP ;
+
1417 icon_data_.uCallbackMessage = MESSAGE_ID ;
+
1418 icon_data_.hIcon = static_cast<HICON>(
+
1419 LoadImageW(
+
1420 NULL, icon_path_wide.c_str(),
+
1421 IMAGE_ICON, 0, 0, LR_LOADFROMFILE)) ;
+
1422 wcscpy_s(icon_data_.szTip, app_name_.c_str()) ;
+
1423 icon_data_.dwState = NIS_SHAREDICON ;
+
1424 icon_data_.dwStateMask = NIS_SHAREDICON ;
+
1425
+
1426 if(!Shell_NotifyIconW(NIM_ADD, &icon_data_)) {
+
1427 return false ;
+
1428 }
+
1429 hide_menu_window() ;
+
1430
+
1431 return true ;
+
1432 }
-
1394
-
1395 private:
-
1396 static LRESULT CALLBACK callback(
-
1397 HWND hwnd,
-
1398 UINT msg,
-
1399 WPARAM wparam,
-
1400 LPARAM lparam) {
-
1401 auto get_instance = [hwnd]() -> FluentTray* {
-
1402 auto upper_addr = GetWindowLongW(hwnd, 0) ;
-
1403 if(!upper_addr) {
-
1404 return nullptr ;
-
1405 }
-
1406
-
1407 auto lower_addr = GetWindowLongW(hwnd, sizeof(LONG)) ;
-
1408 if(!lower_addr) {
-
1409 return nullptr ;
-
1410 }
-
1411
-
1412 FluentTray* self ;
-
1413 util::concatenate_bits(upper_addr, lower_addr, self) ;
-
1414 return self ;
-
1415 } ;
-
1416
-
1417 if(msg == WM_DESTROY || msg == WM_QUIT || msg == WM_CLOSE) {
-
1418 if(auto self = get_instance()) {
-
1419 self->stop() ;
-
1420 return 0 ;
-
1421 }
-
1422 }
-
1423 else if(msg == WM_ACTIVATE && wparam == WA_INACTIVE) {
-
1424 if(auto self = get_instance()) {
-
1425 if(!self->hide_menu_window()) {
-
1426 self->fail() ;
-
1427 }
-
1428 return 0 ;
-
1429 }
-
1430 }
-
1431 else if(msg == WM_DRAWITEM) {
-
1432 if(auto self = get_instance()) {
-
1433 auto item = reinterpret_cast<LPDRAWITEMSTRUCT>(lparam) ;
-
1434 auto menu_idx = self->get_menu_index_from_window(item->hwndItem) ;
-
1435 if(menu_idx < 0) {
-
1436 return FALSE ;
-
1437 }
-
1438 auto& menu = self->menus_[menu_idx] ;
-
1439 if(!menu.draw_menu(item, self->font_)) {
-
1440 self->fail() ;
-
1441 return FALSE ;
-
1442 }
-
1443 return TRUE ;
+
1433
+
1434 private:
+
1435 static LRESULT CALLBACK callback(
+
1436 HWND hwnd,
+
1437 UINT msg,
+
1438 WPARAM wparam,
+
1439 LPARAM lparam) {
+
1440 auto get_instance = [hwnd]() -> FluentTray* {
+
1441 auto upper_addr = GetWindowLongW(hwnd, 0) ;
+
1442 if(!upper_addr) {
+
1443 return nullptr ;
1444 }
-
1445 }
-
1446 else if(msg == WM_CTLCOLORBTN) {
-
1447 if(auto self = get_instance()) {
-
1448 auto menu_idx = self->get_menu_index_from_window(reinterpret_cast<HWND>(lparam)) ;
-
1449 if(menu_idx < 0) {
-
1450 return DefWindowProc(hwnd, msg, wparam, lparam) ;
-
1451 }
-
1452 auto& menu = self->menus_[menu_idx] ;
-
1453 return reinterpret_cast<LRESULT>(menu.background_brush()) ;
-
1454 }
-
1455 }
-
1456 else if(msg == WM_COMMAND) {
+
1445
+
1446 auto lower_addr = GetWindowLongW(hwnd, sizeof(LONG)) ;
+
1447 if(!lower_addr) {
+
1448 return nullptr ;
+
1449 }
+
1450
+
1451 FluentTray* self ;
+
1452 util::concatenate_bits(upper_addr, lower_addr, self) ;
+
1453 return self ;
+
1454 } ;
+
1455
+
1456 if(msg == WM_DESTROY || msg == WM_QUIT || msg == WM_CLOSE) {
1457 if(auto self = get_instance()) {
-
1458 auto menu_idx = self->get_menu_index_from_id(LOWORD(wparam)) ;
-
1459 if(menu_idx < 0) {
-
1460 return FALSE ;
-
1461 }
-
1462 auto& menu = self->menus_[menu_idx] ;
-
1463 if(!menu.process_click_event()) {
-
1464 self->stop() ;
-
1465 return FALSE ;
+
1458 self->stop() ;
+
1459 return 0 ;
+
1460 }
+
1461 }
+
1462 else if(msg == WM_ACTIVATE && wparam == WA_INACTIVE) {
+
1463 if(auto self = get_instance()) {
+
1464 if(!self->hide_menu_window()) {
+
1465 self->fail() ;
1466 }
-
1467 if(menu.is_toggleable()) {
-
1468 // Update the toggle menu for checkmark
-
1469 if(!InvalidateRect(menu.window_handle(), NULL, TRUE)) {
-
1470 return false ;
-
1471 }
-
1472 }
-
1473 return TRUE ;
-
1474 }
-
1475 }
-
1476 else if(msg == MESSAGE_ID) { //On NotifyIcon
-
1477 if(auto self = get_instance()) {
-
1478 if(lparam == WM_LBUTTONUP || lparam == WM_RBUTTONUP) {
-
1479 self->show_menu_window() ;
-
1480 return 0 ;
+
1467 return 0 ;
+
1468 }
+
1469 }
+
1470 else if(msg == WM_DRAWITEM) {
+
1471 if(auto self = get_instance()) {
+
1472 auto item = reinterpret_cast<LPDRAWITEMSTRUCT>(lparam) ;
+
1473 auto menu_idx = self->get_menu_index_from_window(item->hwndItem) ;
+
1474 if(menu_idx < 0) {
+
1475 return FALSE ;
+
1476 }
+
1477 auto& menu = self->menus_[menu_idx] ;
+
1478 if(!menu.draw_menu(item, self->font_)) {
+
1479 self->fail() ;
+
1480 return FALSE ;
1481 }
-
1482 }
-
1483 }
-
1484
-
1485 return DefWindowProc(hwnd, msg, wparam, lparam) ;
-
1486 }
-
1487
-
1488 int get_menu_index_from_window(HWND hwnd) {
-
1489 int i = 0 ;
-
1490 for(auto& m : menus_) {
-
1491 if(m.window_handle() == hwnd) {
-
1492 return i ;
+
1482 return TRUE ;
+
1483 }
+
1484 }
+
1485 else if(msg == WM_CTLCOLORBTN) {
+
1486 if(auto self = get_instance()) {
+
1487 auto menu_idx = self->get_menu_index_from_window(reinterpret_cast<HWND>(lparam)) ;
+
1488 if(menu_idx < 0) {
+
1489 return DefWindowProc(hwnd, msg, wparam, lparam) ;
+
1490 }
+
1491 auto& menu = self->menus_[menu_idx] ;
+
1492 return reinterpret_cast<LRESULT>(menu.background_brush()) ;
1493 }
-
1494 i ++ ;
-
1495 }
-
1496 return -1 ;
-
1497 }
-
1498
-
1499 int get_menu_index_from_id(WORD id) {
-
1500 int i = 0 ;
-
1501 for(auto& m : menus_) {
-
1502 if(m.id() == static_cast<std::size_t>(id)) {
-
1503 return i ;
-
1504 }
-
1505 i ++ ;
-
1506 }
-
1507 return -1 ;
-
1508 }
-
1509
-
1510 void get_message(MSG& message) {
-
1511 if(PeekMessage(&message, hwnd_, 0, 0, PM_REMOVE)) {
-
1512 DispatchMessage(&message) ;
-
1513 }
-
1514 }
-
1515
-
1516 void fail() noexcept {
-
1517 status_ = TrayStatus::FAILED ;
-
1518 }
-
1519
-
1520 bool change_menu_back_color(FluentMenu& menu, COLORREF new_color) {
-
1521 if(!menu.set_color(
-
1522 text_color_, new_color, ash_color_)) {
-
1523 return false ;
-
1524 }
-
1525 // Redraw
-
1526 if(!InvalidateRect(menu.window_handle(), NULL, TRUE)) {
-
1527 return false ;
-
1528 }
-
1529 return true ;
-
1530 }
-
1531 } ;
+
1494 }
+
1495 else if(msg == WM_COMMAND) {
+
1496 if(auto self = get_instance()) {
+
1497 auto menu_idx = self->get_menu_index_from_id(LOWORD(wparam)) ;
+
1498 if(menu_idx < 0) {
+
1499 return FALSE ;
+
1500 }
+
1501 auto& menu = self->menus_[menu_idx] ;
+
1502 if(!menu.process_click_event()) {
+
1503 self->stop() ;
+
1504 return FALSE ;
+
1505 }
+
1506 if(menu.is_toggleable()) {
+
1507 // Update the toggle menu for checkmark
+
1508 if(!InvalidateRect(menu.window_handle(), NULL, TRUE)) {
+
1509 return false ;
+
1510 }
+
1511 }
+
1512 return TRUE ;
+
1513 }
+
1514 }
+
1515 else if(msg == MESSAGE_ID) { //On NotifyIcon
+
1516 if(auto self = get_instance()) {
+
1517 if(lparam == WM_LBUTTONUP || lparam == WM_RBUTTONUP) {
+
1518 self->show_menu_window() ;
+
1519 return 0 ;
+
1520 }
+
1521 }
+
1522 }
+
1523
+
1524 return DefWindowProc(hwnd, msg, wparam, lparam) ;
+
1525 }
+
1526
+
1527 int get_menu_index_from_window(HWND hwnd) {
+
1528 int i = 0 ;
+
1529 for(auto& m : menus_) {
+
1530 if(m.window_handle() == hwnd) {
+
1531 return i ;
+
1532 }
+
1533 i ++ ;
+
1534 }
+
1535 return -1 ;
+
1536 }
+
1537
+
1538 int get_menu_index_from_id(WORD id) {
+
1539 int i = 0 ;
+
1540 for(auto& m : menus_) {
+
1541 if(m.id() == static_cast<std::size_t>(id)) {
+
1542 return i ;
+
1543 }
+
1544 i ++ ;
+
1545 }
+
1546 return -1 ;
+
1547 }
+
1548
+
1549 void get_message(MSG& message) {
+
1550 if(PeekMessage(&message, hwnd_, 0, 0, PM_REMOVE)) {
+
1551 DispatchMessage(&message) ;
+
1552 }
+
1553 }
+
1554
+
1555 void fail() noexcept {
+
1556 status_ = TrayStatus::FAILED ;
+
1557 }
+
1558
+
1559 bool change_menu_back_color(FluentMenu& menu, COLORREF new_color) {
+
1560 if(!menu.set_color(
+
1561 text_color_, new_color, ash_color_)) {
+
1562 return false ;
+
1563 }
+
1564 // Redraw
+
1565 if(!InvalidateRect(menu.window_handle(), NULL, TRUE)) {
+
1566 return false ;
+
1567 }
+
1568 return true ;
+
1569 }
+
1570 } ;
-
1532}
-
1533
-
1534#endif
+
1571}
+
1572
+
1573#endif
fluent_tray::FluentMenu
Class with information on each menu.
Definition fluent_tray.hpp:258
fluent_tray::FluentMenu::is_mouse_over
bool is_mouse_over() const
Checks whether the mouse cursor is over the menu or not.
Definition fluent_tray.hpp:403
fluent_tray::FluentMenu::set_color
bool set_color(const COLORREF &text_color=CLR_INVALID, const COLORREF &back_color=CLR_INVALID, const COLORREF &border_color=CLR_INVALID) noexcept
Set the menu color.
Definition fluent_tray.hpp:508
@@ -1472,34 +1506,35 @@
fluent_tray::FluentMenu::check
void check() noexcept
Checks the menu if it is toggleable.
Definition fluent_tray.hpp:419
fluent_tray::FluentMenu::FluentMenu
FluentMenu(const FluentMenu &)=default
fluent_tray::FluentTray
Class with information on the entire tray.
Definition fluent_tray.hpp:680
+
fluent_tray::FluentTray::show_balloon_tip
bool show_balloon_tip(const std::string &title, const std::string &message)
Shows a balloon tip that is placed in the notification area.
Definition fluent_tray.hpp:1125
fluent_tray::FluentTray::~FluentTray
virtual ~FluentTray() noexcept
Definition fluent_tray.hpp:744
-
fluent_tray::FluentTray::end
std::vector< FluentMenu >::iterator end() noexcept
Returns an iterator to the end of menus.
Definition fluent_tray.hpp:1145
+
fluent_tray::FluentTray::end
std::vector< FluentMenu >::iterator end() noexcept
Returns an iterator to the end of menus.
Definition fluent_tray.hpp:1184
fluent_tray::FluentTray::operator=
FluentTray & operator=(const FluentTray &)=delete
fluent_tray::FluentTray::show_menu_window
bool show_menu_window()
Show the menu window above the tray icon.
Definition fluent_tray.hpp:1006
fluent_tray::FluentTray::create_tray
bool create_tray(const std::string &app_name, const std::string &icon_path="", LONG menu_x_margin=5, LONG menu_y_margin=5, LONG menu_x_pad=5, LONG menu_y_pad=5, unsigned char opacity=255, bool round_corner=true)
Initialize tray and create icon on tray.
Definition fluent_tray.hpp:765
-
fluent_tray::FluentTray::stop
void stop() noexcept
Exit the tray successfully.
Definition fluent_tray.hpp:1129
+
fluent_tray::FluentTray::stop
void stop() noexcept
Exit the tray successfully.
Definition fluent_tray.hpp:1168
fluent_tray::FluentTray::operator=
FluentTray & operator=(FluentTray &&)=default
fluent_tray::FluentTray::add_menu
bool add_menu(const std::string &label_text="", const std::string &icon_path="", bool toggleable=false, const std::string &checkmark="✓", const std::function< bool(void)> &callback=[] {return true ;}, const std::function< bool(void)> &unchecked_callback=[] {return true ;})
Add a menu in order from the top.
Definition fluent_tray.hpp:898
-
fluent_tray::FluentTray::set_font
bool set_font(LONG font_size=0, LONG font_weight=0, const std::string &font_name="")
Set font information to draw menus.
Definition fluent_tray.hpp:1213
-
fluent_tray::FluentTray::status
TrayStatus status() const noexcept
Get the current status of tray.
Definition fluent_tray.hpp:1122
-
fluent_tray::FluentTray::back
const FluentMenu & back() const
Returns the const reference to the last of menus.
Definition fluent_tray.hpp:1193
-
fluent_tray::FluentTray::change_icon
bool change_icon(const std::string &icon_path)
Load the image file and change the icon.
Definition fluent_tray.hpp:1352
+
fluent_tray::FluentTray::set_font
bool set_font(LONG font_size=0, LONG font_weight=0, const std::string &font_name="")
Set font information to draw menus.
Definition fluent_tray.hpp:1252
+
fluent_tray::FluentTray::status
TrayStatus status() const noexcept
Get the current status of tray.
Definition fluent_tray.hpp:1161
+
fluent_tray::FluentTray::back
const FluentMenu & back() const
Returns the const reference to the last of menus.
Definition fluent_tray.hpp:1232
+
fluent_tray::FluentTray::change_icon
bool change_icon(const std::string &icon_path)
Load the image file and change the icon.
Definition fluent_tray.hpp:1391
fluent_tray::FluentTray::FluentTray
FluentTray()
Create tray object.
Definition fluent_tray.hpp:714
-
fluent_tray::FluentTray::count_menus
std::size_t count_menus() const noexcept
Returns the number of menus.
Definition fluent_tray.hpp:1201
+
fluent_tray::FluentTray::count_menus
std::size_t count_menus() const noexcept
Returns the number of menus.
Definition fluent_tray.hpp:1240
fluent_tray::FluentTray::update_with_loop
bool update_with_loop(std::chrono::milliseconds sleep_time=std::chrono::milliseconds(1))
Create a message loop to update the tray.
Definition fluent_tray.hpp:976
-
fluent_tray::FluentTray::cbegin
std::vector< FluentMenu >::const_iterator cbegin() const noexcept
Returns a constant iterator to the beginning of menus.
Definition fluent_tray.hpp:1153
-
fluent_tray::FluentTray::cend
std::vector< FluentMenu >::const_iterator cend() const noexcept
Returns a constant iterator to the end of menus.
Definition fluent_tray.hpp:1161
-
fluent_tray::FluentTray::front
const FluentMenu & front() const
Returns the const reference to the beginning of menus.
Definition fluent_tray.hpp:1177
-
fluent_tray::FluentTray::set_color
bool set_color(const COLORREF &text_color=CLR_INVALID, const COLORREF &back_color=CLR_INVALID, unsigned char color_decay=10)
Set colors to draw menus.
Definition fluent_tray.hpp:1276
+
fluent_tray::FluentTray::cbegin
std::vector< FluentMenu >::const_iterator cbegin() const noexcept
Returns a constant iterator to the beginning of menus.
Definition fluent_tray.hpp:1192
+
fluent_tray::FluentTray::cend
std::vector< FluentMenu >::const_iterator cend() const noexcept
Returns a constant iterator to the end of menus.
Definition fluent_tray.hpp:1200
+
fluent_tray::FluentTray::front
const FluentMenu & front() const
Returns the const reference to the beginning of menus.
Definition fluent_tray.hpp:1216
+
fluent_tray::FluentTray::set_color
bool set_color(const COLORREF &text_color=CLR_INVALID, const COLORREF &back_color=CLR_INVALID, unsigned char color_decay=10)
Set colors to draw menus.
Definition fluent_tray.hpp:1315
fluent_tray::FluentTray::add_separator
void add_separator()
Add a separator line under the last menu item added.
Definition fluent_tray.hpp:921
fluent_tray::FluentTray::hide_menu_window
bool hide_menu_window()
Hide the menu window above the tray icon.
Definition fluent_tray.hpp:1111
fluent_tray::FluentTray::FluentTray
FluentTray(const FluentTray &)=delete
-
fluent_tray::FluentTray::front
FluentMenu & front()
Returns the reference to the beginning of menus.
Definition fluent_tray.hpp:1169
+
fluent_tray::FluentTray::front
FluentMenu & front()
Returns the reference to the beginning of menus.
Definition fluent_tray.hpp:1208
fluent_tray::FluentTray::FluentTray
FluentTray(FluentTray &&)=default
fluent_tray::FluentTray::window_handle
HWND window_handle() const noexcept
Refer to the handle of menu window.
Definition fluent_tray.hpp:998
-
fluent_tray::FluentTray::begin
std::vector< FluentMenu >::iterator begin() noexcept
Returns an iterator to the beginning of menus.
Definition fluent_tray.hpp:1137
+
fluent_tray::FluentTray::begin
std::vector< FluentMenu >::iterator begin() noexcept
Returns an iterator to the beginning of menus.
Definition fluent_tray.hpp:1176
fluent_tray::FluentTray::update
bool update()
Get window message and update tray.
Definition fluent_tray.hpp:931
-
fluent_tray::FluentTray::back
FluentMenu & back()
Returns the reference to the last of menus.
Definition fluent_tray.hpp:1185
+
fluent_tray::FluentTray::back
FluentMenu & back()
Returns the reference to the last of menus.
Definition fluent_tray.hpp:1224
FLUENT_TRAY_MESSAGE_ID_OFFSET
#define FLUENT_TRAY_MESSAGE_ID_OFFSET
Unique message identifier.
Definition fluent_tray.hpp:82
fluent_tray::util::exists
bool exists(const std::wstring &path)
Checks if the file exists.
Definition fluent_tray.hpp:231
fluent_tray::util::bit2mask
constexpr std::size_t bit2mask(std::size_t bits) noexcept
Generates a mask with the specified number of lower bits set to 1.
Definition fluent_tray.hpp:168
diff --git a/docs/functions.html b/docs/functions.html index 85216c2..3a1cf8f 100644 --- a/docs/functions.html +++ b/docs/functions.html @@ -155,6 +155,7 @@

- p -

    - s -

    • set_color() : fluent_tray::FluentMenu, fluent_tray::FluentTray
    • set_font() : fluent_tray::FluentTray
      • +
    • show_balloon_tip() : fluent_tray::FluentTray
    • show_menu_window() : fluent_tray::FluentTray
    • show_separator_line() : fluent_tray::FluentMenu
    • status() : fluent_tray::FluentTray
      • diff --git a/docs/functions_func.html b/docs/functions_func.html index 58fb03b..0f6e625 100644 --- a/docs/functions_func.html +++ b/docs/functions_func.html @@ -155,6 +155,7 @@

      - p -

        - s -

        • set_color() : fluent_tray::FluentMenu, fluent_tray::FluentTray
        • set_font() : fluent_tray::FluentTray
          • +
        • show_balloon_tip() : fluent_tray::FluentTray
        • show_menu_window() : fluent_tray::FluentTray
        • show_separator_line() : fluent_tray::FluentMenu
        • status() : fluent_tray::FluentTray
          • diff --git a/docs/search/all_e.js b/docs/search/all_e.js index 2333434..a89a739 100644 --- a/docs/search/all_e.js +++ b/docs/search/all_e.js @@ -3,11 +3,12 @@ var searchData= ['set_5fcolor_0',['set_color',['../classfluent__tray_1_1_fluent_menu.html#a3ac09df2b11379cb9c7bc1ca5e33df44',1,'fluent_tray::FluentMenu::set_color()'],['../classfluent__tray_1_1_fluent_tray.html#ab2c7402a216a5ecfd6e3b886a524418c',1,'fluent_tray::FluentTray::set_color(const COLORREF &text_color=CLR_INVALID, const COLORREF &back_color=CLR_INVALID, unsigned char color_decay=10)']]], ['set_5ffont_1',['set_font',['../classfluent__tray_1_1_fluent_tray.html#a435a8474b6d141044cd324bb45e6d726',1,'fluent_tray::FluentTray']]], ['should_5fstop_2',['SHOULD_STOP',['../namespacefluent__tray.html#aa636c02ce33a7170c008cd007f4831f9aa6e1bf62fac48fd2812be19930b1e369',1,'fluent_tray']]], - ['show_5fmenu_5fwindow_3',['show_menu_window',['../classfluent__tray_1_1_fluent_tray.html#a2287afaa97f4f41c4346c5f2f939857c',1,'fluent_tray::FluentTray']]], - ['show_5fseparator_5fline_4',['show_separator_line',['../classfluent__tray_1_1_fluent_menu.html#a6ff137fc157ad72bdfb83baf81454807',1,'fluent_tray::FluentMenu']]], - ['split_5fbits_5',['split_bits',['../namespacefluent__tray_1_1util.html#acd91a1888d8f303a35f3a56e455dbaf4',1,'fluent_tray::util']]], - ['status_6',['status',['../classfluent__tray_1_1_fluent_tray.html#a599e83a0b01cbbaecf20e8e19c734480',1,'fluent_tray::FluentTray']]], - ['stop_7',['stop',['../classfluent__tray_1_1_fluent_tray.html#a25d65dcfec83f0ea7de8055530000e54',1,'fluent_tray::FluentTray']]], - ['stopped_8',['STOPPED',['../namespacefluent__tray.html#aa636c02ce33a7170c008cd007f4831f9a09d4d696b4e935115b9313e3c412509a',1,'fluent_tray']]], - ['string2wstring_9',['string2wstring',['../namespacefluent__tray_1_1util.html#ab0d843e97ec384341852be5d1dcf3fba',1,'fluent_tray::util']]] + ['show_5fballoon_5ftip_3',['show_balloon_tip',['../classfluent__tray_1_1_fluent_tray.html#a02abceeae16c5342ae88af29f12cd08a',1,'fluent_tray::FluentTray']]], + ['show_5fmenu_5fwindow_4',['show_menu_window',['../classfluent__tray_1_1_fluent_tray.html#a2287afaa97f4f41c4346c5f2f939857c',1,'fluent_tray::FluentTray']]], + ['show_5fseparator_5fline_5',['show_separator_line',['../classfluent__tray_1_1_fluent_menu.html#a6ff137fc157ad72bdfb83baf81454807',1,'fluent_tray::FluentMenu']]], + ['split_5fbits_6',['split_bits',['../namespacefluent__tray_1_1util.html#acd91a1888d8f303a35f3a56e455dbaf4',1,'fluent_tray::util']]], + ['status_7',['status',['../classfluent__tray_1_1_fluent_tray.html#a599e83a0b01cbbaecf20e8e19c734480',1,'fluent_tray::FluentTray']]], + ['stop_8',['stop',['../classfluent__tray_1_1_fluent_tray.html#a25d65dcfec83f0ea7de8055530000e54',1,'fluent_tray::FluentTray']]], + ['stopped_9',['STOPPED',['../namespacefluent__tray.html#aa636c02ce33a7170c008cd007f4831f9a09d4d696b4e935115b9313e3c412509a',1,'fluent_tray']]], + ['string2wstring_10',['string2wstring',['../namespacefluent__tray_1_1util.html#ab0d843e97ec384341852be5d1dcf3fba',1,'fluent_tray::util']]] ]; diff --git a/docs/search/functions_d.js b/docs/search/functions_d.js index 9485721..27aa30e 100644 --- a/docs/search/functions_d.js +++ b/docs/search/functions_d.js @@ -2,10 +2,11 @@ var searchData= [ ['set_5fcolor_0',['set_color',['../classfluent__tray_1_1_fluent_menu.html#a3ac09df2b11379cb9c7bc1ca5e33df44',1,'fluent_tray::FluentMenu::set_color()'],['../classfluent__tray_1_1_fluent_tray.html#ab2c7402a216a5ecfd6e3b886a524418c',1,'fluent_tray::FluentTray::set_color(const COLORREF &text_color=CLR_INVALID, const COLORREF &back_color=CLR_INVALID, unsigned char color_decay=10)']]], ['set_5ffont_1',['set_font',['../classfluent__tray_1_1_fluent_tray.html#a435a8474b6d141044cd324bb45e6d726',1,'fluent_tray::FluentTray']]], - ['show_5fmenu_5fwindow_2',['show_menu_window',['../classfluent__tray_1_1_fluent_tray.html#a2287afaa97f4f41c4346c5f2f939857c',1,'fluent_tray::FluentTray']]], - ['show_5fseparator_5fline_3',['show_separator_line',['../classfluent__tray_1_1_fluent_menu.html#a6ff137fc157ad72bdfb83baf81454807',1,'fluent_tray::FluentMenu']]], - ['split_5fbits_4',['split_bits',['../namespacefluent__tray_1_1util.html#acd91a1888d8f303a35f3a56e455dbaf4',1,'fluent_tray::util']]], - ['status_5',['status',['../classfluent__tray_1_1_fluent_tray.html#a599e83a0b01cbbaecf20e8e19c734480',1,'fluent_tray::FluentTray']]], - ['stop_6',['stop',['../classfluent__tray_1_1_fluent_tray.html#a25d65dcfec83f0ea7de8055530000e54',1,'fluent_tray::FluentTray']]], - ['string2wstring_7',['string2wstring',['../namespacefluent__tray_1_1util.html#ab0d843e97ec384341852be5d1dcf3fba',1,'fluent_tray::util']]] + ['show_5fballoon_5ftip_2',['show_balloon_tip',['../classfluent__tray_1_1_fluent_tray.html#a02abceeae16c5342ae88af29f12cd08a',1,'fluent_tray::FluentTray']]], + ['show_5fmenu_5fwindow_3',['show_menu_window',['../classfluent__tray_1_1_fluent_tray.html#a2287afaa97f4f41c4346c5f2f939857c',1,'fluent_tray::FluentTray']]], + ['show_5fseparator_5fline_4',['show_separator_line',['../classfluent__tray_1_1_fluent_menu.html#a6ff137fc157ad72bdfb83baf81454807',1,'fluent_tray::FluentMenu']]], + ['split_5fbits_5',['split_bits',['../namespacefluent__tray_1_1util.html#acd91a1888d8f303a35f3a56e455dbaf4',1,'fluent_tray::util']]], + ['status_6',['status',['../classfluent__tray_1_1_fluent_tray.html#a599e83a0b01cbbaecf20e8e19c734480',1,'fluent_tray::FluentTray']]], + ['stop_7',['stop',['../classfluent__tray_1_1_fluent_tray.html#a25d65dcfec83f0ea7de8055530000e54',1,'fluent_tray::FluentTray']]], + ['string2wstring_8',['string2wstring',['../namespacefluent__tray_1_1util.html#ab0d843e97ec384341852be5d1dcf3fba',1,'fluent_tray::util']]] ]; diff --git a/include/fluent_tray.hpp b/include/fluent_tray.hpp index 1b1417f..f1c2a61 100644 --- a/include/fluent_tray.hpp +++ b/include/fluent_tray.hpp @@ -1115,6 +1115,45 @@ namespace fluent_tray return true ; } + /** + * @brief Shows a balloon tip that is placed in the notification area. + * @param [in] title The UTF-8 string of title. + * @param [in] message The UTF-8 string of message. + * @return Returns true on success, false on failure. + * @details Titles longer than 48 characters and messages longer than 200 characters will be trimmed. + */ + bool show_balloon_tip(const std::string& title, const std::string& message) { + NOTIFYICONDATAW notify_data = {} ; + notify_data.cbSize = sizeof(notify_data) ; + notify_data.hWnd = hwnd_ ; + notify_data.uFlags = NIF_INFO ; + + std::wstring title_wide ; + if(!util::string2wstring(title, title_wide)) { + return false ; + } + + std::wstring message_wide ; + if(!util::string2wstring(message, message_wide)) { + return false ; + } + + auto title_len = title_wide.length() > 47 ? 47 : title_wide.length() ; + std::wmemcpy( + notify_data.szInfoTitle, title_wide.c_str(), title_len) ; + notify_data.szInfoTitle[title_len] = L'\0' ; + + auto message_len = message_wide.length() > 199 ? 199 : message_wide.length() ; + std::wmemcpy( + notify_data.szInfo, message_wide.c_str(), message_len) ; + notify_data.szInfo[message_len] = L'\0' ; + + if(!Shell_NotifyIconW(NIM_MODIFY, ¬ify_data)) { + return false ; + } + return true ; + } + /** * @brief Get the current status of tray. * @return The status.