Files
test2/source/blender/blenkernel/BKE_text_suggestions.h
2024-09-25 19:24:20 +10:00

63 lines
1.4 KiB
C

/* SPDX-FileCopyrightText: 2008 Blender Authors
*
* SPDX-License-Identifier: GPL-2.0-or-later */
#pragma once
/** \file
* \ingroup bke
*/
#ifdef __cplusplus
extern "C" {
#endif
struct Text;
typedef struct SuggItem {
struct SuggItem *prev, *next;
char type;
char name[0];
} SuggItem;
/**
* Suggestions should be added in sorted order although a linear sorting method is implemented.
* The list is then divided up based on the prefix provided by update_suggestions:
*
* Example:
* Prefix: `ab`
* `aaa` <- #SuggList::first
* `aab`
* `aba` <- #SuggList::firstmatch
* `abb` <- #SuggList::lastmatch
* `baa`
* `bab` <- #SuggList::last
*/
typedef struct SuggList {
SuggItem *first, *last;
SuggItem *firstmatch, *lastmatch;
SuggItem *selected;
int top;
} SuggList;
/* Free all text tool memory */
void free_texttools(void);
/* Used to identify which Text object the current tools should appear against */
void texttool_text_set_active(struct Text *text);
void texttool_text_clear(void);
short texttool_text_is_active(struct Text *text);
/* Suggestions */
void texttool_suggest_add(const char *name, char type);
void texttool_suggest_prefix(const char *prefix, int prefix_len);
void texttool_suggest_clear(void);
SuggItem *texttool_suggest_first(void);
SuggItem *texttool_suggest_last(void);
void texttool_suggest_select(SuggItem *sel);
SuggItem *texttool_suggest_selected(void);
int *texttool_suggest_top(void);
#ifdef __cplusplus
}
#endif