Вперед Назад

Общие текстовые операции расположения

В этой главе описываются некоторые общие текстовые операции расположения и показывает, как они могут быть выполнены с помощью Базового текста. Следующие операции с листингами кода включены в эту главу:

Разметка абзаца
Простая текстовая метка
Колоночное расположение
Ручное повреждение строки
Применение стиля абзаца
Отображение текста в непрямоугольной области

Разметка абзаца

Одна из наиболее распространенных операций в наборе излагает многострочный абзац в произвольно размерной прямоугольной области. Базовый текст делает эту работу простой, требуемой только несколько строк Базового специфичного для текста кода. Для разметки абзаца Вам нужен графический контекст для вовлечения, прямоугольный контур для обеспечения области, где текст размечается, и приписанная строка. Большая часть кода в этом примере требуется, чтобы создавать и инициализировать контекст, путь и строку. После этого сделан, Базовый текст требует, чтобы только три строки кода сделали расположение.

Код в Перечислении 2-1 показывает, как размечается абзац. Этот код мог находиться в drawRect: метод a UIView подкласс ( NSView подкласс в OS X).

Перечисление 2-1 , Набирающее обычный абзац

// Initialize a graphics context in iOS.

CGContextRef context = UIGraphicsGetCurrentContext();

// Flip the context coordinates, in iOS only.

CGContextTranslateCTM(context, 0, self.bounds.size.height);

CGContextScaleCTM(context, 1.0, -1.0);

// Initializing a graphic context in OS X is different:

// CGContextRef context =

//     (CGContextRef)[[NSGraphicsContext currentContext] graphicsPort];

// Set the text matrix.

CGContextSetTextMatrix(context, CGAffineTransformIdentity);

// Create a path which bounds the area where you will be drawing text.

// The path need not be rectangular.

CGMutablePathRef path = CGPathCreateMutable();

// In this simple example, initialize a rectangular path.

CGRect bounds = CGRectMake(10.0, 10.0, 200.0, 200.0);

CGPathAddRect(path, NULL, bounds );

// Initialize a string.

CFStringRef textString = CFSTR("Hello, World! I know nothing in the world that has as much power as a word. Sometimes I write one, and I look at it, until it begins to shine.");

// Create a mutable attributed string with a max length of 0.

// The max length is a hint as to how much internal storage to reserve.

// 0 means no hint.

CFMutableAttributedStringRef attrString =

         CFAttributedStringCreateMutable(kCFAllocatorDefault, 0);

// Copy the textString into the newly created attrString

CFAttributedStringReplaceString (attrString, CFRangeMake(0, 0),

         textString);

// Create a color that will be added as an attribute to the attrString.

CGColorSpaceRef rgbColorSpace = CGColorSpaceCreateDeviceRGB();

CGFloat components[] = { 1.0, 0.0, 0.0, 0.8 };

CGColorRef red = CGColorCreate(rgbColorSpace, components);

CGColorSpaceRelease(rgbColorSpace);

// Set the color of the first 12 chars to red.

CFAttributedStringSetAttribute(attrString, CFRangeMake(0, 12),

         kCTForegroundColorAttributeName, red);

// Create the framesetter with the attributed string.

CTFramesetterRef framesetter =

         CTFramesetterCreateWithAttributedString(attrString);

CFRelease(attrString);

// Create a frame.

CTFrameRef frame = CTFramesetterCreateFrame(framesetter,

          CFRangeMake(0, 0), path, NULL);

// Draw the specified frame in the given context.

CTFrameDraw(frame, context);

// Release the objects we used.

CFRelease(frame);

CFRelease(path);

CFRelease(framesetter);

Простая текстовая метка

Другая общая наборная работа рисует одну строку текста для использования в качестве метки для элемента пользовательского интерфейса. В Базовом тексте это требует только двух строк кода: один для создания объекта линии с CFAttributedString и другим для разграничивания в графический контекст.

Перечисление 2-2 показывает, как в этом выполнили бы drawRect: метод a UIView или NSView подкласс. Перечисление опускает инициализацию строки обычного текста, шрифта и графического контекста, операции, показанные в других списках в этом документе. Это показывает, как создать словарь атрибутов и использовать его для создания приписанной строки. (Создание шрифта показано в Создании Дескрипторов Шрифта и Создании Шрифта от Дескриптора Шрифта.)

Перечисление 2-2 , Набирающее простую текстовую метку

CFStringRef string; CTFontRef font; CGContextRef context;

// Initialize the string, font, and context

CFStringRef keys[] = { kCTFontAttributeName };

CFTypeRef values[] = { font };

CFDictionaryRef attributes =

    CFDictionaryCreate(kCFAllocatorDefault, (const void**)&keys,

        (const void**)&values, sizeof(keys) / sizeof(keys[0]),

        &kCFTypeDictionaryKeyCallBacks,

        &kCFTypeDictionaryValueCallBacks);

CFAttributedStringRef attrString =

    CFAttributedStringCreate(kCFAllocatorDefault, string, attributes);

CFRelease(string);

CFRelease(attributes);

CTLineRef line = CTLineCreateWithAttributedString(attrString);

// Set text position and draw the line into the graphics context

CGContextSetTextPosition(context, 10.0, 10.0);

CTLineDraw(line, context);

CFRelease(line);

Колоночное расположение

Разметка текста в многократных столбцах является другой общей наборной работой. Строго говоря сам Базовый текст только размечает один столбец за один раз и не вычисляет размеры столбца или расположения. Вы делаете те операции прежде, чем вызвать Базовый текст для разметки текста в области контура, которую Вы вычислили. В этой выборке Базовый текст, в дополнение к разметке текста в каждом столбце, также обеспечивает поддиапазон в текстовой строке для каждого столбца.

createColumnsWithColumnCount: метод в Перечислении 2-3 принимает в качестве параметра, что число столбцов нарисовано, и возвращает массив путей, одного пути для каждого столбца.

Перечисление 2-4 включает реализацию drawRect: метод, вызывающий локальную переменную createColumnsWithColumnCount метод, определенный сначала в этом перечислении. Этот код находится в a UIView подкласс ( NSView подкласс в OS X). Подкласс включает attributedString свойство, не показанное здесь, но чье средство доступа вызывают в этом перечислении для возврата приписанной строки, которая будет размечена.

Перечисление 2-3 , Делящее представление на столбцы

- (CFArrayRef)createColumnsWithColumnCount:(int)columnCount

    int column;

    CGRect* columnRects = (CGRect*)calloc(columnCount, sizeof(*columnRects));

    // Set the first column to cover the entire view.

    columnRects[0] = self.bounds;

    // Divide the columns equally across the frame's width.

    CGFloat columnWidth = CGRectGetWidth(self.bounds) / columnCount;

    for (column = 0; column < columnCount - 1; column++) {

        CGRectDivide(columnRects[column], &columnRects[column],

                     &columnRects[column + 1], columnWidth, CGRectMinXEdge);

   // Inset all columns by a few pixels of margin.

    for (column = 0; column < columnCount; column++) {

        columnRects[column] = CGRectInset(columnRects[column], 8.0, 15.0);

    // Create an array of layout paths, one for each column.

    CFMutableArrayRef array =

                     CFArrayCreateMutable(kCFAllocatorDefault,

                                  columnCount, &kCFTypeArrayCallBacks);

    for (column = 0; column < columnCount; column++) {

        CGMutablePathRef path = CGPathCreateMutable();

        CGPathAddRect(path, NULL, columnRects[column]);

        CFArrayInsertValueAtIndex(array, column, path);

        CFRelease(path);

    free(columnRects);

    return array;

Перечисление 2-4 , Выполняющее колоночное текстовое расположение

// Override drawRect: to draw the attributed string into columns.

// (In OS X, the drawRect: method of NSView takes an NSRect parameter,

//  but that parameter is not used in this listing.)

- (void)drawRect:(CGRect)rect

    // Initialize a graphics context in iOS.

    CGContextRef context = UIGraphicsGetCurrentContext();

    // Flip the context coordinates in iOS only.

    CGContextTranslateCTM(context, 0, self.bounds.size.height);

    CGContextScaleCTM(context, 1.0, -1.0);

    // Initializing a graphic context in OS X is different:

    // CGContextRef context =

    //     (CGContextRef)[[NSGraphicsContext currentContext] graphicsPort];

    // Set the text matrix.

    CGContextSetTextMatrix(context, CGAffineTransformIdentity);

    // Create the framesetter with the attributed string.

    CTFramesetterRef framesetter = CTFramesetterCreateWithAttributedString(

                                      (CFAttributedStringRef)self.attributedString);

    // Call createColumnsWithColumnCount function to create an array of

    // three paths (columns).

    CFArrayRef columnPaths = [self createColumnsWithColumnCount:3];

    CFIndex pathCount = CFArrayGetCount(columnPaths);

    CFIndex startIndex = 0;

    int column;

    // Create a frame for each column (path).

    for (column = 0; column < pathCount; column++) {

        // Get the path for this column.

        CGPathRef path = (CGPathRef)CFArrayGetValueAtIndex(columnPaths, column);

        // Create a frame for this column and draw it.

        CTFrameRef frame = CTFramesetterCreateFrame(

                             framesetter, CFRangeMake(startIndex, 0), path, NULL);

        CTFrameDraw(frame, context);

        // Start the next frame at the first character not visible in this frame.

        CFRange frameRange = CTFrameGetVisibleStringRange(frame);

        startIndex += frameRange.length;

        CFRelease(frame);

    CFRelease(columnPaths);

    CFRelease(framesetter);

Ручное повреждение строки

В Базовом тексте Вы обычно не должны делать ручного повреждения строки, если у Вас нет специального процесса расстановки переносов или подобного требования. framesetter выполняет строку, повреждающуюся автоматически. Также Базовый текст позволяет Вам указать точно, где Вы хотите, чтобы повредилась каждая строка текста. Перечисление 2-5 показывает, как создать наборное устройство, объект, используемый framesetter, и использовать наборное устройство непосредственно, чтобы найти надлежащие разрывы строки и создать набранную строку вручную. Эта выборка также показывает, как центрировать строку перед получением.

Этот код мог быть в drawRect: метод a UIView подкласс ( NSView подкласс в OS X). Перечисление не показывает инициализацию переменных, используемых в коде.

Перечисление 2-5 , Выполняющее ручное повреждение строки

double width; CGContextRef context; CGPoint textPosition; CFAttributedStringRef attrString;

// Initialize those variables.

// Create a typesetter using the attributed string.

CTTypesetterRef typesetter = CTTypesetterCreateWithAttributedString(attrString);

// Find a break for line from the beginning of the string to the given width.

CFIndex start = 0;

CFIndex count = CTTypesetterSuggestLineBreak(typesetter, start, width);

// Use the returned character count (to the break) to create the line.

CTLineRef line = CTTypesetterCreateLine(typesetter, CFRangeMake(start, count));

// Get the offset needed to center the line.

float flush = 0.5; // centered

double penOffset = CTLineGetPenOffsetForFlush(line, flush, width);

// Move the given text drawing position by the calculated offset and draw the line.

CGContextSetTextPosition(context, textPosition.x + penOffset, textPosition.y);

CTLineDraw(line, context);

// Move the index beyond the line break.

start += count;

Применение стиля абзаца

Перечисление 2-6 реализует функцию, применяющую стиль абзаца к приписанной строке. Функция принимает как параметры имя шрифта, размер точки и межстрочный интервал, увеличивающий или уменьшающий сумму пространства между строками текста. Эта функция вызвана кодом в Перечислении 2-7, создающем строку обычного текста, использование applyParaStyle функция для создания приписанной строки с данными атрибутами абзацев, затем создает framesetter и кадр, и рисует кадр.

Перечисление 2-6 , Применяющее стиль абзаца

NSAttributedString* applyParaStyle(

                CFStringRef fontName , CGFloat pointSize,

                NSString *plainText, CGFloat lineSpaceInc){

    // Create the font so we can determine its height.

    CTFontRef font = CTFontCreateWithName(fontName, pointSize, NULL);

    // Set the lineSpacing.

    CGFloat lineSpacing = (CTFontGetLeading(font) + lineSpaceInc) * 2;

    // Create the paragraph style settings.

    CTParagraphStyleSetting setting;

    setting.spec = kCTParagraphStyleSpecifierLineSpacing;

    setting.valueSize = sizeof(CGFloat);

    setting.value = &lineSpacing;

    CTParagraphStyleRef paragraphStyle = CTParagraphStyleCreate(&setting, 1);

    // Add the paragraph style to the dictionary.

    NSDictionary *attributes = [NSDictionary dictionaryWithObjectsAndKeys:

                               (__bridge id)font, (id)kCTFontNameAttribute,

                               (__bridge id)paragraphStyle,

                               (id)kCTParagraphStyleAttributeName, nil];

    CFRelease(font);

    CFRelease(paragraphStyle);

    // Apply the paragraph style to the string to created the attributed string.

    NSAttributedString* attrString = [[NSAttributedString alloc]

                               initWithString:(NSString*)plainText

                               attributes:attributes];

    return attrString;

В Перечислении 2-7 стилизованная строка используется для создания framesetter. Код использует framesetter для создания кадра и рисует кадр.

Перечисление 2-7 , Составляющее стилизованный абзац

- (void)drawRect:(CGRect)rect {

    // Initialize a graphics context in iOS.

    CGContextRef context = UIGraphicsGetCurrentContext();

    // Flip the context coordinates in iOS only.

    CGContextTranslateCTM(context, 0, self.bounds.size.height);

    CGContextScaleCTM(context, 1.0, -1.0);

    // Set the text matrix.

    CGContextSetTextMatrix(context, CGAffineTransformIdentity);

    CFStringRef fontName = CFSTR("Didot Italic");

    CGFloat pointSize = 24.0;

    CFStringRef string = CFSTR("Hello, World! I know nothing in the world that has

                                   as much power as a word. Sometimes I write one,

                                   and I look at it, until it begins to shine.");

    // Apply the paragraph style.

    NSAttributedString* attrString = applyParaStyle(fontName, pointSize, string, 50.0);

    // Put the attributed string with applied paragraph style into a framesetter.

    CTFramesetterRef framesetter =

             CTFramesetterCreateWithAttributedString((CFAttributedStringRef)attrString);

    // Create a path to fill the View.

    CGPathRef path = CGPathCreateWithRect(rect, NULL);

    // Create a frame in which to draw.

    CTFrameRef frame = CTFramesetterCreateFrame(

                                    framesetter, CFRangeMake(0, 0), path, NULL);

    // Draw the frame.

    CTFrameDraw(frame, context);

    CFRelease(frame);

    CGPathRelease(path);

    CFRelease(framesetter);

В OS X, NSView drawRect: метод получает NSRect параметр, но CGPathCreateWithRect функция требует a CGRect параметр. Так, необходимо преобразовать NSRect возразите против a CGRect объект со следующим вызовом функции:

CGRect myRect = NSRectToCGRect([self bounds]);

Кроме того, в OS X, Вы получаете графический контекст по-другому, и Вы не зеркально отражаете его координаты, как показано в комментариях в Перечислении 2-7.

Отображение текста в непрямоугольной области

Твердая часть отображения текста в непрямоугольной области должна описать непрямоугольный контур. AddSquashedDonutPath функция в Перечислении 2-8 возвращает путь формы пончика. Как только Вы имеете путь, просто вызываете обычные Базовые текстовые функции, чтобы применить атрибуты и нарисовать.

Перечисление 2-8 , Выводящее на экран текст по непрямоугольному пути

// Create a path in the shape of a donut.

static void AddSquashedDonutPath(CGMutablePathRef path,

              const CGAffineTransform *m, CGRect rect)

    CGFloat width = CGRectGetWidth(rect);

    CGFloat height = CGRectGetHeight(rect);

    CGFloat radiusH = width / 3.0;

    CGFloat radiusV = height / 3.0;

    CGPathMoveToPoint( path, m, rect.origin.x, rect.origin.y + height - radiusV);

    CGPathAddQuadCurveToPoint( path, m, rect.origin.x, rect.origin.y + height,

                               rect.origin.x + radiusH, rect.origin.y + height);

    CGPathAddLineToPoint( path, m, rect.origin.x + width - radiusH,

                               rect.origin.y + height);

    CGPathAddQuadCurveToPoint( path, m, rect.origin.x + width,

                               rect.origin.y + height,

                               rect.origin.x + width,

                               rect.origin.y + height - radiusV);

    CGPathAddLineToPoint( path, m, rect.origin.x + width,

                               rect.origin.y + radiusV);

    CGPathAddQuadCurveToPoint( path, m, rect.origin.x + width, rect.origin.y,

                               rect.origin.x + width - radiusH, rect.origin.y);

    CGPathAddLineToPoint( path, m, rect.origin.x + radiusH, rect.origin.y);

    CGPathAddQuadCurveToPoint( path, m, rect.origin.x, rect.origin.y,

                               rect.origin.x, rect.origin.y + radiusV);

    CGPathCloseSubpath( path);

    CGPathAddEllipseInRect( path, m,

                            CGRectMake( rect.origin.x + width / 2.0 - width / 5.0,

                            rect.origin.y + height / 2.0 - height / 5.0,

                            width / 5.0 * 2.0, height / 5.0 * 2.0));

// Generate the path outside of the drawRect call so the path is calculated only once.

- (NSArray *)paths

    CGMutablePathRef path = CGPathCreateMutable();

    CGRect bounds = self.bounds;

    bounds = CGRectInset(bounds, 10.0, 10.0);

    AddSquashedDonutPath(path, NULL, bounds);

    NSMutableArray *result =

              [NSMutableArray arrayWithObject:CFBridgingRelease(path)];

    return result;

- (void)drawRect:(CGRect)rect

    [super drawRect:rect];

    // Initialize a graphics context in iOS.

    CGContextRef context = UIGraphicsGetCurrentContext();

    // Flip the context coordinates in iOS only.

    CGContextTranslateCTM(context, 0, self.bounds.size.height);

    CGContextScaleCTM(context, 1.0, -1.0);

    // Set the text matrix.

    CGContextSetTextMatrix(context, CGAffineTransformIdentity);

    // Initialize an attributed string.

    CFStringRef textString = CFSTR("Hello, World! I know nothing in the world that

    has as much power as a word. Sometimes I write one, and I look at it,

    until it begins to shine.");

    // Create a mutable attributed string.

     CFMutableAttributedStringRef attrString =

                CFAttributedStringCreateMutable(kCFAllocatorDefault, 0);

    // Copy the textString into the newly created attrString.

    CFAttributedStringReplaceString (attrString, CFRangeMake(0, 0), textString);

    // Create a color that will be added as an attribute to the attrString.

    CGColorSpaceRef rgbColorSpace = CGColorSpaceCreateDeviceRGB();

    CGFloat components[] = { 1.0, 0.0, 0.0, 0.8 };

    CGColorRef red = CGColorCreate(rgbColorSpace, components);

    CGColorSpaceRelease(rgbColorSpace);

    // Set the color of the first 13 chars to red.

    CFAttributedStringSetAttribute(attrString, CFRangeMake(0, 13),

                                     kCTForegroundColorAttributeName, red);

    // Create the framesetter with the attributed string.

    CTFramesetterRef framesetter = CTFramesetterCreateWithAttributedString(attrString);

    // Create the array of paths in which to draw the text.

    NSArray *paths = [self paths];

    CFIndex startIndex = 0;

    // In OS X, use NSColor instead of UIColor.

    #define GREEN_COLOR [UIColor greenColor]

    #define YELLOW_COLOR [UIColor yellowColor]

    #define BLACK_COLOR [UIColor blackColor]

    // For each path in the array of paths...

    for (id object in paths) {

        CGPathRef path = (__bridge CGPathRef)object;

        // Set the background of the path to yellow.

        CGContextSetFillColorWithColor(context, [YELLOW_COLOR CGColor]);

        CGContextAddPath(context, path);

        CGContextFillPath(context);

        CGContextDrawPath(context, kCGPathStroke);

        // Create a frame for this path and draw the text.

        CTFrameRef frame = CTFramesetterCreateFrame(framesetter,

                                         CFRangeMake(startIndex, 0), path, NULL);

        CTFrameDraw(frame, context);

        // Start the next frame at the first character not visible in this frame.

        CFRange frameRange = CTFrameGetVisibleStringRange(frame);

        startIndex += frameRange.length;

        CFRelease(frame);

CFRelease(attrString);

CFRelease(framesetter);

Вперед Назад