Structure

HSWidgetFrame

A structure that contains location and dimensions of widget in grid positions.

Declaration


typedef struct HSWidgetFrame {
	...
} HSWidgetFrame;

Overview

Frames are a combination of location and dimensions. Location being grid position that follow iOS coordinate space where the origin is upper-left corner and positive extends towards the lower-right corner. While dimensions are number of grid positions that will be occupied. For instance a frame with origin of (2, 2) and size of (3, 2) would represent:

(1, 1)

(1, 2)

(1, 3)

(1, 4)

(2, 1)

Widget Frame
Origin (2, 2)
Size (3, 2)

(2, 4)

(3, 1)

(3, 4)

(4, 1)

(4, 4)

(5, 1)

(5, 2)

(5, 3)

(5, 4)

Topics

Constants

HSWidgetFrameZero
A frame constant with location (0, 0), and dimension containg 0 width and height.

Member Fields

origin
A grid position that specifies the frame's origin.
size
A size that specifies the number of rows and columns of the frame.

Creating Frame

HSWidgetFrameMake
Make a widget frame using the specified row, column, number of rows and number of columns.
HSWidgetFrameMake (c++)
Make a widget frame using the specified origin and size.

Checking Characteristics

HSWidgetFrameContainsPosition
Returns whether a frame contains a specified position.
HSWidgetFrameEqualsFrame
Return whether two frames are equal in size and position.