tip/ui/win32/win32.h

/*
 * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS HEADER.
 *
 * Copyright 2025 Olaf Wintermann. All rights reserved.
 *
 * Redistribution and use in source and binary forms, with or without
 * modification, are permitted provided that the following conditions are met:
 *
 *   1. Redistributions of source code must retain the above copyright
 *      notice, this list of conditions and the following disclaimer.
 *
 *   2. Redistributions in binary form must reproduce the above copyright
 *      notice, this list of conditions and the following disclaimer in the
 *      documentation and/or other materials provided with the distribution.
 *
 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
 * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
 * ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE
 * LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
 * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
 * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
 * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
 * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
 * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
 * POSSIBILITY OF SUCH DAMAGE.
 */

#ifndef UI_TK_WIN32_H
#define UI_TK_WIN32_H

#include "../ui/win32.h"

#ifdef	__cplusplus
extern "C" {
#endif

/*
 * Creates a standard W32Widget object for an HWND handle and stores the widget object as
 * GWLP_USERDATA in the window.
 */
W32Widget* w32_widget_new(W32WidgetClass *wclass, HWND hwnd);

/*
 * Same as w32_widget_new, but uses obj_size for allocation, allowing to create objects
 * derived from W32Widget.
 */
void* w32_widget_create(W32WidgetClass *wclass, HWND hwnd, size_t obj_size);

W32Size w32_widget_get_preferred_size(W32Widget *w);

void w32_widget_default_destroy(W32Widget *w);
void w32_widget_default_show(W32Widget *w, BOOLEAN show);
void w32_widget_default_enable(W32Widget *w, BOOLEAN enable);
W32Size w32_widget_default_get_preferred_size(W32Widget *widget);

#ifdef __cplusplus
}
#endif

#endif //UI_TK_WIN32_H