ObjectivelyMVC 0.1.0
Object oriented MVC framework for OpenGL, SDL2 and GNU C
Control.h
Go to the documentation of this file.
1/*
2 * ObjectivelyMVC: Object oriented MVC framework for OpenGL, SDL2 and GNU C.
3 * Copyright (C) 2014 Jay Dolan <jay@jaydolan.com>
4 *
5 * This software is provided 'as-is', without any express or implied
6 * warranty. In no event will the authors be held liable for any damages
7 * arising from the use of this software.
8 *
9 * Permission is granted to anyone to use this software for any purpose,
10 * including commercial applications, and to alter it and redistribute it
11 * freely, subject to the following restrictions:
12 *
13 * 1. The origin of this software must not be misrepresented; you must not
14 * claim that you wrote the original software. If you use this software
15 * in a product, an acknowledgment in the product documentation would be
16 * appreciated but is not required.
17 *
18 * 2. Altered source versions must be plainly marked as such, and must not be
19 * misrepresented as being the original software.
20 *
21 * 3. This notice may not be removed or altered from any source distribution.
22 */
23
24#pragma once
25
26#include <Objectively/MutableArray.h>
27
29#include <ObjectivelyMVC/Text.h>
30
44typedef enum {
49
51
55typedef enum {
60
62
66typedef enum {
73
75
76typedef struct ControlInterface ControlInterface;
77
83struct Control {
84
89
94 ControlInterface *interface;
95
100 MutableArray *actions;
101
106
110 unsigned int state;
111
116};
117
121struct ControlInterface {
122
126 ViewInterface viewInterface;
127
135 Array *(*actionsForEvent)(const Control *self, const SDL_Event *event);
136
147 void (*addActionForEventType)(Control *self, SDL_EventType eventType, ActionFunction function, ident sender, ident data);
148
158 _Bool (*captureEvent)(Control *self, const SDL_Event *event);
159
168 Control *(*initWithFrame)(Control *self, const SDL_Rect *frame);
169
176 _Bool (*isDisabled)(const Control *self);
177
184 _Bool (*isFocused)(const Control *self);
185
192 _Bool (*isHighlighted)(const Control *self);
193
200 _Bool (*isSelected)(const Control *self);
201
209 void (*stateDidChange)(Control *self);
210};
211
Actions bind event-driven behavior to Controls.
void(* ActionFunction)(Control *control, const SDL_Event *event, ident sender, ident data)
The ActionFunction callback.
Definition: Action.h:43
static _Bool captureEvent(Control *self, const SDL_Event *event)
Definition: Button.c:76
static void stateDidChange(Control *self)
Definition: Checkbox.c:103
static void addActionForEventType(Control *self, SDL_EventType eventType, ActionFunction function, ident sender, ident data)
Definition: Control.c:264
static _Bool isSelected(const Control *self)
Definition: Control.c:325
static _Bool isDisabled(const Control *self)
Definition: Control.c:301
static _Bool isFocused(const Control *self)
Definition: Control.c:309
static _Bool isHighlighted(const Control *self)
Definition: Control.c:317
ControlBevel
Control bevel styles, for drawing depressed or raised bevels.
Definition: Control.h:44
@ ControlBevelNone
Definition: Control.h:45
@ ControlBevelInset
Definition: Control.h:46
@ ControlBevelOutset
Definition: Control.h:47
ControlSelection
Control selection styles, for Controls that support user selection.
Definition: Control.h:55
@ ControlSelectionMultiple
Definition: Control.h:58
@ ControlSelectionSingle
Definition: Control.h:57
@ ControlSelectionNone
Definition: Control.h:56
OBJECTIVELYMVC_EXPORT const EnumName ControlBevelNames[]
Definition: Control.h:50
OBJECTIVELYMVC_EXPORT const EnumName ControlStateNames[]
Definition: Control.h:74
OBJECTIVELYMVC_EXPORT const EnumName ControlSelectionNames[]
Definition: Control.h:61
ControlState
Control states, which are bit-masked.
Definition: Control.h:66
@ ControlStateDefault
Definition: Control.h:67
@ ControlStateFocused
Definition: Control.h:71
@ ControlStateHighlighted
Definition: Control.h:68
@ ControlStateDisabled
Definition: Control.h:69
@ ControlStateSelected
Definition: Control.h:70
Text rendered with TrueType fonts.
#define OBJECTIVELYMVC_EXPORT
Definition: Types.h:39
Controls are Views which capture events and dispatch Actions.
Definition: Control.h:83
Class * _Control(void)
The Control archetype.
Definition: Control.c:379
unsigned int state
The bit mask of ControlState.
Definition: Control.h:110
ControlBevel bevel
The ControlBevel.
Definition: Control.h:105
ControlInterface * interface
The interface.
Definition: Control.h:94
View view
The superclass.
Definition: Control.h:88
ControlSelection selection
The ControlSelection.
Definition: Control.h:115
Views are the fundamental building blocks of ObjectivelyMVC user interfaces.
Definition: View.h:133