TICKIT_WINDOW_SET_CURSOR_POSITION(3)

💖 TICKIT_WINDOW_SET_CURSOR_POSITION — the cursor glow-up page 💖

okay bestie, so this is a section 3 page from the Library Functions Manual, and it's literally all about making the cursor on a TickitWindow do what you want. three lil functions, one big vibe. let's get into it 🎀

✨ NAME ✨

tickit_window_set_cursor_position, tickit_window_set_cursor_visible, tickit_window_set_cursor_shape — modify the cursor state on a window 🖱️✨

🌸 SYNOPSIS 🌸

#include <tickit.h>

void tickit_window_set_cursor_position(TickitWindow *win, int line, int col);
void tickit_window_set_cursor_visible(TickitWindow *win, bool visible);
void tickit_window_set_cursor_shape(TickitWindow *win, TickitCursorShape shape);

Link with -ltickit.

🦋 DESCRIPTION 🦋

so here's the tea, bestie ☕ — three separate functions, three separate cursor lewks, all on the same window:

• tickit_window_set_cursor_position() sets the position within the given window where the terminal cursor would be displayed — if the window has the focus. it takes line and col, and that's where the cursor would chill. 👑
• tickit_window_set_cursor_visible() sets whether the terminal cursor is visible when the given window has the focus. so like, visible = true and it's showing up to the function, visible = false and it's ghosting everyone. 👻
• tickit_window_set_cursor_shape() sets what shape the terminal cursor will have if the given window has the focus. shape-shifting cursor? it's giving main character energy fr fr. 🌈

⚠️ okay but here's the thing that actually matters, no cap: none of these functions actually affect the input focus directly. they do NOT grab focus, they do NOT steal focus, they simply set what the state of the cursor will be if the given window has the input focus. it's like picking out your outfit for a party you might not even get invited to 💀

and if you actually wanna set the input focus? that's a whole different function, bestie — go see tickit_window_take_focus(3). that one's the one that pulls up. 🔥

⭐ RETURN VALUE ⭐

these functions all return no value. literally nothing. they're void, they do their thing, they don't report back. silent icons. 💅

🫶 SEE ALSO 🫶

• tickit_window_new(3)
• tickit_window_take_focus(3)
• tickit_window(7)
• tickit_rect(7)
• tickit(7)

and that's the whole page, bestie!! this was the TICKIT_WIN...OR_POSITION(3) section 3 entry, from the Library Functions Manual — go forth and make your cursor iconic 💜✨