Function

CTTextTabCreate

Creates and initializes a new text tab object.

Declaration

CTTextTabRef CTTextTabCreate(CTTextAlignment alignment, double location, CFDictionaryRef options);

Parameters

alignment

The tab's alignment. This is used to determine the position of text inside the tab column. This parameter must be set to a valid CTTextAlignment value or this function returns NULL.

location

The tab's ruler location, relative to the back margin.

options

Options to pass in when the tab is created. Currently, the only option available is kCTTabColumnTerminatorsAttributeName. This parameter is optional and can be set to NULL if not needed.

Return Value

A reference to a CTTextTab object if the call was successful; otherwise, NULL.