Spec-Zone .ru
спецификации, руководства, описания, API

Библиотека разработчика Mac

Разработчик

Ссылка платформы AppKit ссылка класса NSClipView

Опции
Развертывание Target:

На этой странице
Язык:

NSClipView

Класс сразу

NSClipView содержит и прокручивает представление документа, выведенное на экран NSScrollView. Вы обычно не должны программировать с NSClipView объекты, как NSScrollView дескрипторы большинство подробных данных их работы.

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

Взаимодействие с NSScrollView

При использовании NSClipView в NSScrollView (обычная конфигурация), необходимо получить доступ NSScrollView свойства, управляющие фоновым состоянием рисования, вместо того, чтобы получить доступ к этим свойствам NSClipView. Эта рекомендация применяется к следующим свойствам:

NSClipView методы предназначаются для когда NSClipView используется независимо от содержания NSScrollView. В обычном случае, NSScrollView должен быть позволен управлять рисующими фон свойствами его связанного NSClipView.

Существует только одно рисующее фон состояние на NSScrollView/NSClipView пара. Два объекта не поддерживают независимый и отличный drawsBackground и backgroundColor свойства; скорее средства доступа для этих свойств на NSScrollView в основном подчинитесь связанному NSClipView и позвольте NSClipView поддержать состояние. Обратите внимание на то, что это состояние не кэшируется NSScrollView объект.

Также важно отметить ту установку drawsBackground к NOfalse в NSScrollView имеет добавленный эффект установки NSClipView свойство copiesOnScroll к NOfalse. Побочный эффект установки drawsBackground свойство непосредственно к NSClipView появление «следов» (остатки предыдущего получения) в представлении документа, когда это прокручивается.

Наследование

Соответствует

Оператор импорта

Swift

import AppKit

Objective C

@import AppKit;

Доступность

Доступный в OS X v10.0 и позже.

Установка представления документа
  • documentView documentView Свойство

    Представление документа представления клипа.

    Объявление

    Swift

    unowned(unsafe) var documentView: AnyObject?

    Objective C

    @property(assign) id documentView

    Обсуждение

    Если представление клипа содержится в NSScrollView, необходимо отправить NSScrollView a setDocumentView: для сообщения вместо этого, таким образом, это может выполнить любое обновление его, нужно. Установка этого свойства к представлению удаляет любое предыдущее представление документа и устанавливает источник прямоугольника границ представления клипа к источнику прямоугольника кадра нового представления. Выполнение так также регистрирует представление клипа для уведомлений NSViewFrameDidChangeNotification и NSViewBoundsDidChangeNotification, корректирует ключевой цикл представления для включения нового представления документа и обновляет родителя NSScrollView выведите на экран в случае необходимости использование reflectScrolledClipView:.

    Оператор импорта

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

    Доступный в OS X v10.0 и позже.

Прокрутка
  • scrollToPoint (_:) - scrollToPoint:

    Изменяет источник прямоугольника границ представления клипа к newOrigin.

    Объявление

    Swift

    func scrollToPoint(_ newOrigin: NSPoint)

    Objective C

    - (void)scrollToPoint:(NSPoint)newOrigin

    Оператор импорта

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

    Доступный в OS X v10.0 и позже.

    См. также

    – constrainBoundsRect:

  • автопрокрутите (_:) - автопрокрутка:

    Прокручивает представление клипа пропорционально к theEventрасстояние за пределами него.

    Объявление

    Swift

    func autoscroll(_ theEvent: NSEvent) -> Bool

    Objective C

    - (BOOL)autoscroll:(NSEvent *)theEvent

    Обсуждение

    theEventрасположение должно быть выражено в основной системе координат окна (который это обычно), не получение NSClipView. Возвраты YEStrue если выполняется какая-либо прокрутка; иначе возвраты NOfalse.

    Никогда не вызывайте этот метод непосредственно; вместо этого, NSScrollViewпредставление документа должно неоднократно отправлять себя autoscroll: сообщения, когда указатель перетаскивается вне NSScrollViewкадр во время модального цикла событий инициируется событием mouseDown. NSView реализации класса autoscroll: передавать сообщение к суперпредставлению получателя; таким образом сообщение в конечном счете передается к NSClipView.

    Оператор импорта

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

    Доступный в OS X v10.0 и позже.

  • constrainScrollPoint (_:) - constrainScrollPoint: (OS X v10.10)

    Возвращает точку прокрутки, скорректированную из proposedNewOrigin, при необходимости, для гарантии представления все еще ляжет в его представлении документа.

    Оператор осуждения

    Использовать constrainBoundsRect: вместо этого.

    Объявление

    Swift

    func constrainScrollPoint(_ newOrigin: NSPoint) -> NSPoint

    Objective C

    - (NSPoint)constrainScrollPoint:(NSPoint)newOrigin

    Обсуждение

    Например, если proposedNewOriginy координата находится налево от источника представления документа, тогда координата y возвратилась, установлен в тот из источника представления документа.

    Оператор импорта

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

    Доступный в OS X v10.0 и позже.

    Осуждаемый в OS X v10.10.

    См. также

    – scrollToPoint:

  • constrainBoundsRect (_:) - constrainBoundsRect:

    В то время как пользователь увеличивает и прокручивает, ограничивает границы представления клипа.

    Объявление

    Swift

    func constrainBoundsRect(_ proposedBounds: NSRect) -> NSRect

    Objective C

    - (NSRect)constrainBoundsRect:(NSRect)proposedBounds

    Параметры

    proposedBounds

    Границы для использования, чтобы гарантировать, что представление все еще ляжет в своем представлении документа.

    Возвращаемое значение

    Прямоугольник границ.

    Обсуждение

    Обратите внимание на то, что можно переместить реализацию осуждаемого constrainScrollPoint: к этому методу путем корректировки источника proposedBounds (вместо того, чтобы использовать newOrigin параметр в -constrainScrollPoint:). Сохранить совместимость, если подкласс переопределяет -constrainScrollPoint:, поведение по умолчанию constrainBoundsRect: должен будет использовать это -constrainScrollPoint: скорректировать источник proposedBounds, и не изменить размер.

    Оператор импорта

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

    Доступный в OS X v10.9 и позже.

Определение прокрутки эффективности
  • copiesOnScroll copiesOnScroll Свойство

    Булево значение, указывающее, представили ли копии представления клипа изображения при прокрутке.

    Объявление

    Swift

    var copiesOnScroll: Bool

    Objective C

    @property BOOL copiesOnScroll

    Обсуждение

    Когда значение этого свойства YEStrue, представление клипа копирует свое существующее представленное изображение при прокрутке (только рисование представленных частей его представления документа); когда это NOfalse, представление вынуждает свое содержание быть перерисованным каждый раз.

    Оператор импорта

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

    Доступный в OS X v10.0 и позже.

Доступ к вставкам содержания
  • contentInsets contentInsets Свойство

    Расстояние, что довольное представление вставляется от представления прокрутки включения.

    Объявление

    Swift

    var contentInsets: NSEdgeInsets

    Objective C

    @property NSEdgeInsets contentInsets

    Обсуждение

    Когда представление прокрутки включения contentInsets значение является ненулевым (т.е. значение не {0,0,0,0}), представление прокрутки устанавливает кадр довольного представление к границам представления прокрутки минус граница представления прокрутки, если это имеет тот. (Когда contentInsets значение равно нулю, представление прокрутки корректирует contentView.frame для адаптации во всех других представлениях, представление прокрутки поддерживает.), Когда значение contentView.automaticallyAdjustsContentInsets YEStrue (который является значением по умолчанию), заголовок, линейки, и другие представления наложены поверх довольного, представление и представление прокрутки устанавливают корректное contentInsets значение на contentView. Когда это свойство изменяется путем вызова, Обратите внимание на то, что можно анимировать представление клипа [self animator].

    Оператор импорта

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

    Доступный в OS X v10.10 и позже.

  • automaticallyAdjustsContentInsets automaticallyAdjustsContentInsets Свойство

    Булево значение, указывающее, составляет ли представление клипа автоматически другие подпредставления представления прокрутки.

    Объявление

    Swift

    var automaticallyAdjustsContentInsets: Bool

    Objective C

    @property BOOL automaticallyAdjustsContentInsets

    Обсуждение

    Когда значение этого свойства YEStrue, и представление клипа используется в качестве contentView из NSScrollView, представление клипа автоматически составляет другие подпредставления представления прокрутки, такие как линейки и заголовки. Значение по умолчанию YEStrue.

    Оператор импорта

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

    Доступный в OS X v10.10 и позже.

Доступ к видимой части
  • documentRect documentRect Свойство

    Если представление документа меньше, прямоугольник, определяющий кадр представления документа, скорректированный к размеру клипа, просматривает. (только для чтения)

    Объявление

    Swift

    var documentRect: NSRect { get }

    Objective C

    @property(readonly) NSRect documentRect

    Обсуждение

    Прямоугольник документа используется в сочетании с NSClipView прямоугольник границ объекта для определения значений для индикаторов относительной позиции и размера между NSClipView и его представление документа. Например, NSScrollView использование эти прямоугольники для установки размера и позиции кнопок в ее скроллерах. Когда представление документа намного больше, чем NSClipView, кнопка является маленькой; когда представление документа около того же размера, кнопка является большой; и когда представление документа является тем же размером или меньший, нет никакой кнопки.

    Оператор импорта

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

    Доступный в OS X v10.0 и позже.

    См. также

    – reflectScrolledClipView: (NSScrollView)
    documentVisibleRect

  • documentVisibleRect documentVisibleRect Свойство

    Представленный прямоугольник представления документа представления клипа, в собственной системе координат представления документа. (только для чтения)

    Объявление

    Swift

    var documentVisibleRect: NSRect { get }

    Objective C

    @property(readonly) NSRect documentVisibleRect

    Обсуждение

    Обратите внимание на то, что этот прямоугольник не отражает эффекты никакого отсечения, которое может произойти выше NSClipView самостоятельно. Для получения части документа просматривают, это, как гарантируют, будет видимо, отправит ему a visibleRect сообщение.

    Оператор импорта

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

    Доступный в OS X v10.0 и позже.

    См. также

    documentRect

Установка курсора документа
  • documentCursor documentCursor Свойство

    Когда указатель находится по представлению, объект курсора использовал.

    Объявление

    Swift

    var documentCursor: NSCursor?

    Objective C

    @property(strong) NSCursor *documentCursor

    Обсуждение

    Значение по умолчанию этого свойства nil, если Вы не указываете значение в xib файле, связанном с представлением клипа (или прокрутите представление). Обратите внимание на то, что представление документа представления клипа может указать курсор для своего представления прокрутки включения путем установки enclosingScrollView.

    Оператор импорта

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

    Доступный в OS X v10.0 и позже.

Работа с цветом фона
  • drawsBackground drawsBackground Свойство

    Булево значение, указывающее, рисует ли представление клипа свой цвет фона.

    Объявление

    Swift

    var drawsBackground: Bool

    Objective C

    @property BOOL drawsBackground

    Обсуждение

    Если Ваш NSClipView включается в NSScrollView, необходимо установить drawsBackground свойство на NSScrollView. Установка этого свойства к NOfalse на NSScrollView имеет добавленный эффект установки NSClipView свойство copiesOnScroll к NOfalse. Побочный эффект установки drawsBackground свойство на NSClipView появление «следов» (остатки предыдущего получения) в представлении документа, когда это прокручивается.

    Оператор импорта

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

    Доступный в OS X v10.0 и позже.

  • backgroundColor backgroundColor Свойство

    Цвет фона представления клипа.

    Объявление

    Swift

    @NSCopying var backgroundColor: NSColor

    Objective C

    @property(copy) NSColor *backgroundColor

    Обсуждение

    Значение по умолчанию этого свойства предоставляется током controlBackgroundColor.

    Оператор импорта

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

    Доступный в OS X v10.0 и позже.

Переопределение методы NSView
  • viewBoundsChanged (_:) - viewBoundsChanged:

    Дескрипторы NSViewBoundsDidChangeNotification, переданный в aNotification параметр, путем обновления содержания NSScrollView на основе новых границ.

    Объявление

    Swift

    func viewBoundsChanged(_ notification: NSNotification)

    Objective C

    - (void)viewBoundsChanged:(NSNotification *)notification

    Оператор импорта

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

    Доступный в OS X v10.0 и позже.

  • viewFrameChanged (_:) - viewFrameChanged:

    Дескрипторы NSViewFrameDidChangeNotification, переданный в aNotification параметр, путем обновления содержания NSScrollView на основе нового кадра.

    Объявление

    Swift

    func viewFrameChanged(_ notification: NSNotification)

    Objective C

    - (void)viewFrameChanged:(NSNotification *)notification

    Оператор импорта

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

    Доступный в OS X v10.0 и позже.