42 lines
1.4 KiB
C
42 lines
1.4 KiB
C
#pragma once
|
|
|
|
/// \file text_property.h
|
|
/// \author Folling <folling@ikarus.world>
|
|
|
|
#include <ikarus/macros.h>
|
|
|
|
/// \addtogroup properties Properties
|
|
/// \brief Text properties store an arbitrary piece of text. (e.g. "Firstname" or "Description")
|
|
/// @{
|
|
|
|
IKARUS_BEGIN_HEADER
|
|
|
|
struct IkarusTextProperty;
|
|
|
|
IKA_API IkarusTextProperty * ikarus_text_property_create(
|
|
struct IkarusProject * project, char const * name, struct IkarusPropertySource * property_source
|
|
);
|
|
|
|
/// \brief Sets the default value for a text property.
|
|
/// \param property The text property.
|
|
/// \pre \li Must not be null.
|
|
/// \pre \li Must exist.
|
|
/// \remark The settings take ownership of the value, the caller must not free it.
|
|
IKA_API struct IkarusTextValue * ikarus_text_property_get_default_value(struct IkarusTextProperty * property);
|
|
|
|
/// \brief Sets the default value for a text property.
|
|
/// \param property The text property.
|
|
/// \pre \li Must not be null.
|
|
/// \pre \li Must exist.
|
|
/// \param default_value The default value.
|
|
/// \pre \li Must not be null.
|
|
/// \pre \li Must be a valid value for the property.
|
|
/// \remark Please see \ref property.h "the property documentation" for more information on the interplay between default values
|
|
/// and other settings.
|
|
IKA_API void ikarus_text_property_set_default_value(
|
|
struct IkarusTextProperty * property, struct IkarusTextValue * default_value
|
|
);
|
|
|
|
IKARUS_END_HEADER
|
|
|
|
/// @}
|