nappgui-sys 0.2.0

Rust raw bindings to NAppGUI
Documentation 
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

/*
 * NAppGUI Cross-platform C SDK
 * 2015-2025 Francisco Garcia Collado
 * MIT Licence
 * https://nappgui.com/en/legal/license.html
 *
 * File: ostooltip.c
 *
 */

/* Tooltips */

#include "ostooltip.inl"
#include "osgui_win.inl"
#include <sewer/cassert.h>
#include <sewer/unicode.h>

#if !defined(__WINDOWS__)
#error This file is only for Windows
#endif

#include <sewer/nowarn.hxx>
#include <Commctrl.h>
#include <sewer/warn.hxx>

/*---------------------------------------------------------------------------*/

static HWND i_create_tooltip(HWND control_hwnd, const char_t *text)
{
    HWND parent_hwnd = NULL;
    HINSTANCE instance = NULL;
    HWND tooltip_hwnd = NULL;
    TOOLINFO ti = {0};
    WCHAR wtext[WCHAR_BUFFER_SIZE];

    parent_hwnd = NULL;
    instance = _osgui_instance();

    tooltip_hwnd = CreateWindowEx(
        0, TOOLTIPS_CLASS, NULL,
        WS_POPUP | TTS_ALWAYSTIP /*| TTS_BALLOON*/,
        CW_USEDEFAULT, CW_USEDEFAULT,
        CW_USEDEFAULT, CW_USEDEFAULT,
        parent_hwnd,
        (HMENU)NULL,
        instance, NULL);

    cassert_no_null(tooltip_hwnd);

    ti.cbSize = sizeof(ti);
    ti.hwnd = parent_hwnd;
    ti.uFlags = TTF_IDISHWND | TTF_SUBCLASS;
    ti.uId = (UINT_PTR)control_hwnd;
    unicode_convers(text, cast(wtext, char_t), ekUTF8, kWINDOWS_UNICODE, sizeof(wtext));
    ti.lpszText = wtext;
    SendMessage(tooltip_hwnd, TTM_ADDTOOL, 0, (LPARAM)&ti);
    return tooltip_hwnd;
}

/*---------------------------------------------------------------------------*/

static void i_update_tooltip(HWND control_hwnd, HWND tooltip_hwnd, const char_t *text)
{
    HWND parent_hwnd = NULL;
    TOOLINFO ti = {0};
    WCHAR wtext[WCHAR_BUFFER_SIZE];
    parent_hwnd = NULL;
    ti.cbSize = sizeof(ti);
    ti.hwnd = parent_hwnd;
    ti.uFlags = TTF_IDISHWND | TTF_SUBCLASS;
    ti.uId = (UINT_PTR)control_hwnd;
    unicode_convers(text, cast(wtext, char_t), ekUTF8, kWINDOWS_UNICODE, sizeof(wtext));
    ti.lpszText = wtext;
    SendMessage(tooltip_hwnd, TTM_UPDATETIPTEXT, 0, (LPARAM)&ti);
}

/*---------------------------------------------------------------------------*/

static void i_destroy_tooltip(HWND *tooltip_hwnd, HWND control_hwnd)
{
    TOOLINFO ti;
    BOOL ret = 0;
    cassert_no_null(tooltip_hwnd);
    ti.cbSize = sizeof(ti);
    ti.uFlags = TTF_IDISHWND;
    ti.hwnd = NULL;
    ti.uId = (UINT_PTR)control_hwnd;
    SendMessage(*tooltip_hwnd, TTM_DELTOOL, 0, (LPARAM)&ti);
    ret = DestroyWindow(*tooltip_hwnd);
    cassert_unref(ret != 0, ret);
    *tooltip_hwnd = NULL;
}

/*---------------------------------------------------------------------------*/

void _ostooltip_set_text(HWND *tooltip_hwnd, HWND control_hwnd, const char_t *text)
{
    cassert_no_null(tooltip_hwnd);
    if (*tooltip_hwnd == NULL && text != NULL)
    {
        *tooltip_hwnd = i_create_tooltip(control_hwnd, text);
    }
    else if (*tooltip_hwnd != NULL && text != NULL)
    {
        i_update_tooltip(control_hwnd, *tooltip_hwnd, text);
    }
    else if (*tooltip_hwnd != NULL && text == NULL)
    {
        i_destroy_tooltip(tooltip_hwnd, control_hwnd);
    }
    else
    {
        cassert(*tooltip_hwnd == NULL && text == NULL);
    }
}

/*---------------------------------------------------------------------------*/

void _ostooltip_destroy_optional(HWND *tooltip_hwnd, HWND control_hwnd)
{
    cassert_no_null(tooltip_hwnd);
    if (*tooltip_hwnd != NULL)
        i_destroy_tooltip(tooltip_hwnd, control_hwnd);
}