View.h File Reference

Views are the fundamental building blocks of ObjectivelyMVC user interfaces. More...

#include <Objectively/Data.h>
#include <Objectively/Enum.h>
#include <Objectively/Dictionary.h>
#include <Objectively/Array.h>
#include <Objectively/Set.h>
#include <Objectively/Resource.h>
#include <ObjectivelyMVC/Colors.h>
#include <ObjectivelyMVC/Renderer.h>
#include <ObjectivelyMVC/Theme.h>
#include <ObjectivelyMVC/View+JSON.h>
#include <ObjectivelyMVC/Warning.h>

Go to the source code of this file.

Data Structures
struct	View
	Views are the fundamental building blocks of ObjectivelyMVC user interfaces. More...
struct	ViewPadding
	Spacing applied to the inside of a View's frame. More...

Macros
#define	AddPadding(a, b)    MakePadding(a.top + b.top, a.right + b.right, a.bottom + b.bottom, a.left + b.left)
#define	MakePadding(top, right, bottom, left)    (ViewPadding) { (top), (right), (bottom), (left) }
	Creates a ViewPadding with the given dimensions.
#define	ViewAlignmentMaskBottom   0x4
#define	ViewAlignmentMaskCenter   0x10
#define	ViewAlignmentMaskHorizontal    (ViewAlignmentMaskLeft | ViewAlignmentMaskCenter | ViewAlignmentMaskRight)
#define	ViewAlignmentMaskInternal   0x100
#define	ViewAlignmentMaskLeft   0x8
#define	ViewAlignmentMaskMiddle   0x2
#define	ViewAlignmentMaskRight   0x20
#define	ViewAlignmentMaskTop   0x1
#define	ViewAlignmentMaskVertical    (ViewAlignmentMaskTop | ViewAlignmentMaskMiddle | ViewAlignmentMaskBottom)

Enumerations
enum	ViewAlignment {   ViewAlignmentNone , ViewAlignmentTop = ViewAlignmentMaskTop , ViewAlignmentMiddle = ViewAlignmentMaskMiddle , ViewAlignmentBottom = ViewAlignmentMaskBottom ,   ViewAlignmentLeft = ViewAlignmentMaskLeft , ViewAlignmentCenter = ViewAlignmentMaskCenter , ViewAlignmentRight = ViewAlignmentMaskRight , ViewAlignmentTopLeft = (ViewAlignmentMaskTop | ViewAlignmentMaskLeft) ,   ViewAlignmentTopCenter = (ViewAlignmentMaskTop | ViewAlignmentMaskCenter) , ViewAlignmentTopRight = (ViewAlignmentMaskTop | ViewAlignmentMaskRight) , ViewAlignmentMiddleLeft = (ViewAlignmentMaskMiddle | ViewAlignmentMaskLeft) , ViewAlignmentMiddleCenter = (ViewAlignmentMaskMiddle | ViewAlignmentMaskCenter) ,   ViewAlignmentMiddleRight = (ViewAlignmentMaskMiddle | ViewAlignmentMaskRight) , ViewAlignmentBottomLeft = (ViewAlignmentMaskBottom | ViewAlignmentMaskLeft) , ViewAlignmentBottomCenter = (ViewAlignmentMaskBottom | ViewAlignmentMaskCenter) , ViewAlignmentBottomRight = (ViewAlignmentMaskBottom | ViewAlignmentMaskRight) ,   ViewAlignmentInternal = ViewAlignmentMaskInternal }
	Alignment constants, used to align a View within its superview. More...
enum	ViewAutoresizing {   ViewAutoresizingNone = 0 , ViewAutoresizingWidth = 0x1 , ViewAutoresizingHeight = 0x2 , ViewAutoresizingFill = 0x3 ,   ViewAutoresizingFit = 0x4 , ViewAutoresizingContain = 0x8 }
	Auto-resizing constants, which are bitmasked. More...
enum	ViewPosition { ViewPositionBefore = -1 , ViewPositionAfter = 1 }
	Relative positioning of subviews within their superview. More...

Functions
OBJECTIVELYMVC_EXPORT Class *	_View (void)

Variables
OBJECTIVELYMVC_EXPORT const EnumName	ViewAlignmentNames []
OBJECTIVELYMVC_EXPORT const EnumName	ViewAutoresizingNames []

Detailed Description

Views are the fundamental building blocks of ObjectivelyMVC user interfaces.

Definition in file View.h.

Macro Definition Documentation

AddPadding

#define AddPadding	(		a,
			b
	)		MakePadding(a.top + b.top, a.right + b.right, a.bottom + b.bottom, a.left + b.left)

Returns

A ViewPadding that is the sum of a and b.

Definition at line 113 of file View.h.

             {
  ViewPositionBefore = -1,
  ViewPositionAfter = 1
} ViewPosition;
 
typedef struct ViewInterface ViewInterface;
 
struct View {
 
  Object object;
 
  ViewInterface *interface;
 
  ViewAlignment alignment;
 
  int autoresizingMask;
 
  SDL_Color backgroundColor;
 
  SDL_Color borderColor;
 
  int borderWidth;
 
  Set *classNames;
 
  bool clipsSubviews;
 
  Style *computedStyle;
 
  SDL_Rect frame;
 
  bool hidden;
 
  char *identifier;
 
  SDL_Size maxSize;
 
  SDL_Size minSize;
 
  bool needsApplyTheme;
 
  bool needsLayout;
 
  View *nextResponder;
 
  ViewPadding padding;
 
  Style *style;
 
  Stylesheet *stylesheet;
 
  Array *subviews;
 
  View *superview;
 
  ViewController *viewController;
 
  Array *warnings;
 
  SDL_Window *window;
};
 
struct ViewInterface {
 
  ObjectInterface parentInterface;
 
  bool (*acceptsKeyResponder)(const View *self);
 
  bool (*acceptsTouchResponder)(const View *self);
 
  void (*addClassName)(View *self, const char *className);
 
  void (*addSubview)(View *self, View *subview);
 
  void (*addSubviewRelativeTo)(View *self, View *subview, View *other, ViewPosition position);
 
  View *(*ancestorWithIdentifier)(const View *self, const char *identifier);
 
  void (*applyStyle)(View *self, const Style *style);
 
  void (*applyTheme)(View *self, const Theme *theme);
 
  void (*applyThemeIfNeeded)(View *self, const Theme *theme);
 
  void (*attachStylesheet)(View *self, SDL_Window *window);
 
  void (*awakeWithCharacters)(View *self, const char *chars);
 
  void (*awakeWithData)(View *self, const Data *data);
 
  void (*awakeWithDictionary)(View *self, const Dictionary *dictionary);
 
  void (*awakeWithResource)(View *self, const Resource *resource);
 
  void (*awakeWithResourceName)(View *self, const char *name);
 
  void (*becomeKeyResponder)(View *self);
 
  void (*becomeTouchResponder)(View *self);
 
  bool (*bind)(View *self, const Inlet *inlets, const Dictionary *dictionary);
 
  SDL_Rect (*bounds)(const View *self);
 
  void (*bringSubviewToFront)(View *self, View *subview);
 
  void (*clearWarnings)(const View *self, WarningType level);
 
  SDL_Rect (*clippingFrame)(const View *self);
 
  bool (*containsPoint)(const View *self, const SDL_Point *point);
 
  int (*depth)(const View *self);
 
  View *(*descendantWithIdentifier)(const View *self, const char *identifier);
 
  void (*detachStylesheet)(View *self, SDL_Window *window);
 
  void (*didMoveToWindow)(View *self, SDL_Window *window);
 
  bool (*didReceiveEvent)(const View *self, const SDL_Event *event);
 
  void (*draw)(View *self, Renderer *renderer);
 
  void (*emitViewEvent)(View *self, ViewEvent code, ident data);
 
  void (*enumerate)(View *self, ViewEnumerator enumerator, ident data);
 
  void (*enumerateAdjacent)(const View *self, ViewEnumerator enumerator, ident data);
 
  void (*enumerateAncestors)(const View *self, ViewEnumerator enumerator, ident data);
 
  void (*enumerateDescendants)(const View *self, ViewEnumerator enumerator, ident data);
 
  void (*enumerateSelection)(View *self, const char *rule, ViewEnumerator enumerator, ident data);
 
  void (*enumerateSiblings)(const View *self, ViewEnumerator enumerator, ident data);
 
  void (*enumerateSubviews)(const View *self, ViewEnumerator enumerator, ident data);
 
  void (*enumerateSuperview)(const View *self, ViewEnumerator enumerator, ident data);
 
  void (*enumerateVisible)(View *self, ViewEnumerator enumerator, ident data);
 
  bool (*hasClassName)(const View *self, const char *className);
 
  bool (*hasOverflow)(const View *self);
 
  View *(*hitTest)(const View *self, const SDL_Point *point);
 
  View *(*init)(View *self);
 
  View *(*initWithFrame)(View *self, const SDL_Rect *frame);
 
  void (*invalidateStyle)(View *self);
 
  bool (*isContainer)(const View *self);
 
  bool (*isDescendantOfView)(const View *self, const View *view);
 
  bool (*isKeyResponder)(const View *self);
 
  bool (*isTouchResponder)(const View *self);
 
  bool (*isVisible)(const View *self);
 
  void (*layoutIfNeeded)(View *self);
 
  void (*layoutSubviews)(View *self);
 
  bool (*matchesSelector)(const View *self, const SimpleSelector *simpleSelector);
 
  void (*moveToWindow)(View *self, SDL_Window *window);
 
  String *(*path)(const View *self);
 
  void (*removeAllClassNames)(View *self);
 
  void (*removeAllSubviews)(View *self);
 
  void (*removeClassName)(View *self, const char *className);
 
  void (*removeFromSuperview)(View *self);
 
  void (*removeSubview)(View *self, View *subview);
 
  void (*render)(View *self, Renderer *renderer);
 
  void (*renderDeviceDidReset)(View *self);
 
  void (*renderDeviceWillReset)(View *self);
 
  SDL_Rect (*renderFrame)(const View *self);
 
  void (*replaceSubview)(View *self, View *subview, View *replacement);
 
  void (*resignKeyResponder)(View *self);
 
  void (*resignTouchResponder)(View *self);
 
  void (*resize)(View *self, const SDL_Size *size);
 
  void (*resolve)(View *self, Outlet *outlets);
 
  void (*respondToEvent)(View *self, const SDL_Event *event);
 
  Set *(*select)(View *self, const char *rule);
 
  View *(*selectFirst)(View *self, const char *rule);
 
  SDL_Size (*size)(const View *self);
 
  SDL_Size (*sizeThatContains)(const View *self);
 
  SDL_Size (*sizeThatFits)(const View *self);
 
  SDL_Size (*sizeThatFills)(const View *self);
 
  void (*sizeToContain)(View *self);
 
  void (*sizeToFill)(View *self);
 
  void (*sizeToFit)(View *self);
 
  View *(*subviewWithIdentifier)(const View *self, const char *identifier);
 
  void (*updateBindings)(View *self);
 
  SDL_Rect (*viewport)(const View *self);
 
  View *(*viewWithCharacters)(const char *chars, Outlet *outlets);
 
  View *(*viewWithData)(const Data *data, Outlet *outlets);
 
  View *(*viewWithDictionary)(const Dictionary *dictionary, Outlet *outlets);
 
  View *(*viewWithResource)(const Resource *resource, Outlet *outlets);
 
  View *(*viewWithResourceName)(const char *name, Outlet *outlets);
 
  Array *(*visibleSubviews)(const View *self);
 
  void (*warn)(View *self, WarningType level, const char *fmt, ...);
 
  void (*willMoveToWindow)(View *self, SDL_Window *window);
};
 
OBJECTIVELYMVC_EXPORT Class *_View(void);

MakePadding

#define MakePadding	(		top,
			right,
			bottom,
			left
	)		(ViewPadding) { (top), (right), (bottom), (left) }

Creates a ViewPadding with the given dimensions.

Definition at line 107 of file View.h.

                { (top), (right), (bottom), (left) }

ViewAlignmentMaskBottom

#define ViewAlignmentMaskBottom   0x4

Definition at line 46 of file View.h.

ViewAlignmentMaskCenter

#define ViewAlignmentMaskCenter   0x10

Definition at line 48 of file View.h.

ViewAlignmentMaskHorizontal

#define ViewAlignmentMaskHorizontal    (ViewAlignmentMaskLeft | ViewAlignmentMaskCenter | ViewAlignmentMaskRight)

Definition at line 55 of file View.h.

ViewAlignmentMaskInternal

#define ViewAlignmentMaskInternal   0x100

Definition at line 50 of file View.h.

ViewAlignmentMaskLeft

#define ViewAlignmentMaskLeft   0x8

Definition at line 47 of file View.h.

ViewAlignmentMaskMiddle

#define ViewAlignmentMaskMiddle   0x2

Definition at line 45 of file View.h.

ViewAlignmentMaskRight

#define ViewAlignmentMaskRight   0x20

Definition at line 49 of file View.h.

ViewAlignmentMaskTop

#define ViewAlignmentMaskTop   0x1

Definition at line 44 of file View.h.

ViewAlignmentMaskVertical

#define ViewAlignmentMaskVertical    (ViewAlignmentMaskTop | ViewAlignmentMaskMiddle | ViewAlignmentMaskBottom)

Definition at line 52 of file View.h.

Enumeration Type Documentation

ViewAlignment

enum ViewAlignment

Alignment constants, used to align a View within its superview.

Enumerator
ViewAlignmentNone
ViewAlignmentTop
ViewAlignmentMiddle
ViewAlignmentBottom
ViewAlignmentLeft
ViewAlignmentCenter
ViewAlignmentRight
ViewAlignmentTopLeft
ViewAlignmentTopCenter
ViewAlignmentTopRight
ViewAlignmentMiddleLeft
ViewAlignmentMiddleCenter
ViewAlignmentMiddleRight
ViewAlignmentBottomLeft
ViewAlignmentBottomCenter
ViewAlignmentBottomRight
ViewAlignmentInternal

Definition at line 61 of file View.h.

             {
  ViewAlignmentNone,
  ViewAlignmentTop = ViewAlignmentMaskTop,
  ViewAlignmentMiddle = ViewAlignmentMaskMiddle,
  ViewAlignmentBottom = ViewAlignmentMaskBottom,
  ViewAlignmentLeft = ViewAlignmentMaskLeft,
  ViewAlignmentCenter = ViewAlignmentMaskCenter,
  ViewAlignmentRight = ViewAlignmentMaskRight,
  ViewAlignmentTopLeft = (ViewAlignmentMaskTop | ViewAlignmentMaskLeft),
  ViewAlignmentTopCenter = (ViewAlignmentMaskTop | ViewAlignmentMaskCenter),
  ViewAlignmentTopRight = (ViewAlignmentMaskTop | ViewAlignmentMaskRight),
  ViewAlignmentMiddleLeft = (ViewAlignmentMaskMiddle | ViewAlignmentMaskLeft),
  ViewAlignmentMiddleCenter = (ViewAlignmentMaskMiddle | ViewAlignmentMaskCenter),
  ViewAlignmentMiddleRight = (ViewAlignmentMaskMiddle | ViewAlignmentMaskRight),
  ViewAlignmentBottomLeft = (ViewAlignmentMaskBottom | ViewAlignmentMaskLeft),
  ViewAlignmentBottomCenter = (ViewAlignmentMaskBottom | ViewAlignmentMaskCenter),
  ViewAlignmentBottomRight = (ViewAlignmentMaskBottom | ViewAlignmentMaskRight),
  ViewAlignmentInternal = ViewAlignmentMaskInternal
} ViewAlignment;

ViewAutoresizing

enum ViewAutoresizing

Auto-resizing constants, which are bitmasked.

Enumerator
ViewAutoresizingNone
ViewAutoresizingWidth
ViewAutoresizingHeight
ViewAutoresizingFill
ViewAutoresizingFit
ViewAutoresizingContain

Definition at line 86 of file View.h.

             {
  ViewAutoresizingNone = 0,
  ViewAutoresizingWidth = 0x1,
  ViewAutoresizingHeight = 0x2,
  ViewAutoresizingFill = 0x3,
  ViewAutoresizingFit = 0x4,
  ViewAutoresizingContain = 0x8
} ViewAutoresizing;

ViewPosition

enum ViewPosition

Relative positioning of subviews within their superview.

Enumerator
ViewPositionBefore
ViewPositionAfter

Definition at line 119 of file View.h.

             {
  ViewPositionBefore = -1,
  ViewPositionAfter = 1
} ViewPosition;

Function Documentation

_View()

OBJECTIVELYMVC_EXPORT Class * _View

(

void

)

Definition at line 2067 of file View.c.

                   {
  static Class *clazz;
  static Once once;
 
  do_once(&once, {
    clazz = _initialize(&(const ClassDef) {
      .name = "View",
      .superclass = _Object(),
      .instanceSize = sizeof(View),
      .interfaceOffset = offsetof(View, interface),
      .interfaceSize = sizeof(ViewInterface),
      .initialize = initialize,
    });
  });
 
  return clazz;
}

Variable Documentation

ViewAlignmentNames

OBJECTIVELYMVC_EXPORT const EnumName ViewAlignmentNames[]

Definition at line 81 of file View.h.

ViewAutoresizingNames

OBJECTIVELYMVC_EXPORT const EnumName ViewAutoresizingNames[]

Definition at line 95 of file View.h.