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

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

Разработчик

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

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

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

NSRulerView

Класс сразу

NSRulerView выводит на экран линейку и маркеры выше или стороне представления документа NSScrollView. Представления в NSScrollView могут стать клиентами представления линейки, имение его выводит на экран маркеры для их элементов и получающие сообщения от представления линейки, когда пользователь управляет маркерами.

NSRulerView находится в NSScrollView, выводя на экран маркированную линейку и маркеры для ее клиента, представления документа NSScrollView или подпредставления представления документа.

Посмотрите NSRulerMarkerClientViewDelegation для методов делегата, которые могут представлять интерес.

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


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


Swift

import AppKit

Objective C

@import AppKit;

Доступность


Доступный в OS X v10.0 и позже.
  • Инициализирует недавно выделенный NSRulerView для имения orientation (NSHorizontalRuler или NSVerticalRuler) в aScrollView.

    Объявление

    Swift

    init(scrollView scrollView: NSScrollView?, orientation orientation: NSRulerOrientation)

    Objective C

    - (instancetype)initWithScrollView:(NSScrollView *)scrollView orientation:(NSRulerOrientation)orientation

    Обсуждение

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

    Этот метод является определяемым инициализатором для класса NSRulerView. Возвращает инициализированный объект.

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

  • Регистрирует новую единицу измерения в классе NSRulerView, делая его доступным для всех экземпляров NSRulerView.

    Объявление

    Swift

    class func registerUnitWithName(_ unitName: String, abbreviation abbreviation: String, unitToPointsConversionFactor conversionFactor: CGFloat, stepUpCycle stepUpCycle: [AnyObject], stepDownCycle stepDownCycle: [AnyObject])

    Objective C

    + (void)registerUnitWithName:(NSString *)unitName abbreviation:(NSString *)abbreviation unitToPointsConversionFactor:(CGFloat)conversionFactor stepUpCycle:(NSArray *)stepUpCycle stepDownCycle:(NSArray *)stepDownCycle

    Обсуждение

    unitName имя модуля на английском языке, на форме множественного числа и капитализируемый условно — «Дюймы», например. Имя модуля используется в качестве ключа для идентификации измерительных модулей и так не должно быть локализовано. abbreviation локализованная краткая форма имени модуля, такой как «в» для Дюймов. conversionFactor число точек PostScript в указанном модуле; существует 72,0 точки на дюйм, например. stepUpCycle и stepDownCycle массивы NSNumbers, указывающих, как знаки «диез» вычисляются, как объяснено в Установке Представления Линейки. Все числа в stepUpCycle должно быть больше, чем 1,0, те в stepDownCycle должны быть меньше чем 1,0.

    NSRulerView поддерживает эти модули по умолчанию:

    Имя модуля

    Сокращение

    Точки/Модуль

    Цикл повышения

    Цикл понижения

    Дюймы

    в

    72.0

    2.0

    0.5

    Сантиметры

    cm

    28.35

    2.0

    0.5, 0.2

    Точки

    pt

    1.0

    10.0

    0.5

    Цицеро

    PC

    12.0

    10.0

    0.5

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

    См. также

    – setMeasurementUnits:

  • Устанавливает измерительные модули, привыкшие линейкой к unitName.

    Объявление

    Swift

    var measurementUnits: String

    Objective C

    @property(copy) NSString *measurementUnits

    Обсуждение

    unitName должно быть, был зарегистрирован в объекте класса NSRulerView до вызова этого метода. См. описание метода класса registerUnitWithName:abbreviation:unitToPointsConversionFactor:stepUpCycle:stepDownCycle: для списка предопределенных модулей.

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

    См. также

    – measurementUnits

  • Возвращает полное имя измерительных модулей в действительности для получателя.

    Объявление

    Swift

    var measurementUnits: String

    Objective C

    @property(copy) NSString *measurementUnits

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

  • Устанавливает клиентское представление получателя в aView, не сохраняя его, и удаляет его маркеры линейки, после информирования предшествующего клиента использования изменения rulerView:willSetClientView:.

    Объявление

    Swift

    unowned(unsafe) var clientView: NSView?

    Objective C

    @property(assign) NSView *clientView

    Обсуждение

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

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

    См. также

    – clientView

  • Возвращает клиентское представление получателя, если оно имеет тот.

    Объявление

    Swift

    unowned(unsafe) var clientView: NSView?

    Objective C

    @property(assign) NSView *clientView

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

    См. также

    – setClientView:

  • Устанавливает представление аксессуара получателя в aView.

    Объявление

    Swift

    var accessoryView: NSView?

    Objective C

    @property(strong) NSView *accessoryView

    Обсуждение

    Повышения NSInternalInconsistencyException если aView не nil и получатель не имеет никакого клиентского представления.

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

  • Возвращает представление аксессуара получателя, если оно имеет тот.

    Объявление

    Swift

    var accessoryView: NSView?

    Objective C

    @property(strong) NSView *accessoryView

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

  • Устанавливает расстояние до нулевого знака «диез» от источника границ представления документа NSScrollView (не клиентского представления получателя), в системе координат представления документа.

    Объявление

    Swift

    var originOffset: CGFloat

    Objective C

    @property CGFloat originOffset

    Обсуждение

    Смещение по умолчанию 0.0, означая, что источник линейки совпадает с источником границ представления документа.

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

    См. также

    – originOffset

  • Возвращает расстояние от нулевого знака «диез» получателя до источника границ представления документа NSScrollView (не клиентское представление получателя), в системе координат представления документа.

    Объявление

    Swift

    var originOffset: CGFloat

    Objective C

    @property CGFloat originOffset

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

    См. также

    – setOriginOffset:

  • Устанавливает маркеры линейки получателя в markers, удаление любых существующих маркеров линейки и не консалтинг с клиентом просматривают о новых маркерах.

    Объявление

    Swift

    var markers: [AnyObject]?

    Objective C

    @property(copy) NSArray *markers

    Обсуждение

    markers может быть nil или пустой для удаления всех маркеров линейки. Повышения NSInternalInconsistencyException если markers не nil и получатель не имеет никакого клиентского представления.

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

  • Возвращает NSRulerMarkers получателя.

    Объявление

    Swift

    var markers: [AnyObject]?

    Objective C

    @property(copy) NSArray *markers

    Обсуждение

    Маркеры, как гарантируют, не будут сортированы ни в каком определенном порядке.

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

  • Добавляет aMarker к получателю, не консультируясь с клиентом просматривают для утверждения.

    Объявление

    Swift

    func addMarker(_ marker: NSRulerMarker)

    Objective C

    - (void)addMarker:(NSRulerMarker *)marker

    Обсуждение

    Повышения NSInternalInconsistencyException если получатель не имеет никакого клиентского представления.

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

  • Удаляет aMarker от получателя, не консультируясь с клиентом просматривают для утверждения.

    Объявление

    Swift

    func removeMarker(_ marker: NSRulerMarker)

    Objective C

    - (void)removeMarker:(NSRulerMarker *)marker

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

  • Отслеживает мышь для добавления aMarker на основе начальной мыши вниз или перетащенного мышью события theEvent.

    Объявление

    Swift

    func trackMarker(_ marker: NSRulerMarker, withMouseEvent event: NSEvent) -> Bool

    Objective C

    - (BOOL)trackMarker:(NSRulerMarker *)marker withMouseEvent:(NSEvent *)event

    Обсуждение

    Возвраты YEStrue если добавляет получатель aMarker, NOfalse если это не делает. Этот метод работает путем отправки trackMouse:adding: к aMarker с theEvent и YEStrue как параметры.

    Приложение обычно вызывает этот метод в одном из двух случаев. В более простом случае клиентское представление может реализовать rulerView:handleMouseDown: вызвать этот метод, когда пользователь нажимает кнопку мыши, в то время как курсор находится в области линейки NSRulerView. Этот метод является надлежащим, когда ясно, какой маркер будет добавлен путем щелчка по области линейки. Второй, более общий, случай включает приложение, обеспечивающее палитру различных видов маркеров, которые могут быть перетащены на линейку от представления аксессуара линейки или от некоторого другого места. С этим методом палитра отслеживает курсор, пока это не вводит представление линейки, при котором времени это передает управление к представлению линейки путем вызова trackMarker:withMouseEvent:.

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

  • Проводит временные линии в области линейки.

    Объявление

    Swift

    func moveRulerlineFromLocation(_ oldLocation: CGFloat, toLocation newLocation: CGFloat)

    Objective C

    - (void)moveRulerlineFromLocation:(CGFloat)oldLocation toLocation:(CGFloat)newLocation

    Обсуждение

    Если oldLoc 0 или больше, стирает строку линейки в том расположении; если newLoc 0 или больше, рисует новый rulerline в том расположении. oldLoc и newLoc выражены в системе координат NSRulerView, не клиенте или представлении документа, и координаты x для горизонтальных линеек и координаты y для вертикальных линеек. Используйте NSView’s convert... методы для преобразования координат от клиента или системы координат представления документа к тому из NSRulerView.

    Этот метод полезен для проведения линий выделения на линейке для показа позиции или степени объекта, в то время как это позорится клиентское представление. Отправитель ответственен за отслеживание число и позиции временных строк — NSRulerView только делает получение.

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

  • Рисует знаки «диез» получателя и метки в aRect, который выражен в системе координат получателя.

    Объявление

    Swift

    func drawHashMarksAndLabelsInRect(_ rect: NSRect)

    Objective C

    - (void)drawHashMarksAndLabelsInRect:(NSRect)rect

    Обсуждение

    Этот метод вызывается drawRect:— Вы никогда не должны должны быть вызывать его непосредственно. Можно определить пользовательские измерительные модули с помощью метода класса registerUnitWithName:abbreviation:unitToPointsConversionFactor:stepUpCycle:stepDownCycle:. Переопределите этот метод, если Вы хотите настроить появление самих знаков «диез».

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

  • Рисует маркеры получателя в aRect, который выражен в системе координат получателя.

    Объявление

    Swift

    func drawMarkersInRect(_ rect: NSRect)

    Objective C

    - (void)drawMarkersInRect:(NSRect)rect

    Обсуждение

    Этот метод вызывается drawRect:; Вы никогда не должны должны быть вызывать его непосредственно, но Вы могли бы хотеть переопределить его, если Вы хотите сделать что-то другое при рисовании маркеров.

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

  • Перерасчет сил интервала знака «диез» в следующий раз получатель выведен на экран.

    Объявление

    Swift

    func invalidateHashMarks()

    Objective C

    - (void)invalidateHashMarks

    Обсуждение

    Если Вы переопределяете, Вы никогда не должны должны быть вызывать этот метод непосредственно, но, возможно, должны были бы переопределить его drawHashMarksAndLabelsInRect:.

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

  • Устанавливает NSScrollView, которому принадлежит получатель к scrollView, не сохраняя его.

    Объявление

    Swift

    unowned(unsafe) var scrollView: NSScrollView?

    Objective C

    @property(assign) NSScrollView *scrollView

    Обсуждение

    Этот метод обычно вызывается только представлением прокрутки линейки; необходимо редко должны быть вызвать его непосредственно.

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

    См. также

    – scrollView
    – setHorizontalRulerView: (NSScrollView)
    – setVerticalRulerView: (NSScrollView)

  • Возвращает объект NSScrollView, содержащий получатель.

    Объявление

    Swift

    unowned(unsafe) var scrollView: NSScrollView?

    Objective C

    @property(assign) NSScrollView *scrollView

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

    См. также

    – setScrollView:
    – setHorizontalRulerView: (NSScrollView)
    – setVerticalRulerView: (NSScrollView)

  • Устанавливает ориентацию получателя к orientation.

    Объявление

    Swift

    var orientation: NSRulerOrientation

    Objective C

    @property NSRulerOrientation orientation

    Обсуждение

    Возможные значения для orientation описаны в Константах. Вы никогда не должны должны быть вызывать этот метод непосредственно — он автоматически вызывается содержанием NSScrollView.

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

    См. также

    – ориентация

  • Возвращает ориентацию получателя.

    Объявление

    Swift

    var orientation: NSRulerOrientation

    Objective C

    @property NSRulerOrientation orientation

    Обсуждение

    Возможные значения описаны в Константах.

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

    См. также

    – setOrientation:

  • Устанавливает комнату, доступную для представления аксессуара получателя к thickness.

    Объявление

    Swift

    var reservedThicknessForAccessoryView: CGFloat

    Objective C

    @property CGFloat reservedThicknessForAccessoryView

    Обсуждение

    Если линейка является горизонталью, thickness высота вспомогательного представление; иначе, это - ширина. NSRulerViews резервом по умолчанию никакое пространство для вспомогательного представление.

    NSRulerView автоматически увеличивает зарезервированную толщину по мере необходимости до того из вспомогательных представление. То, когда вспомогательные просматривают, более тонко, чем зарезервированное пространство, оно центрируется в том пространстве. Если Вы планируете использовать несколько вспомогательные представления различных размеров, необходимо установить зарезервированную толщину заранее в тот из самых толстых вспомогательных представление, во избежание перемозаичного размещения NSScrollView.

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

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

    Объявление

    Swift

    var reservedThicknessForAccessoryView: CGFloat

    Objective C

    @property CGFloat reservedThicknessForAccessoryView

    Обсуждение

    Эта толщина автоматически увеличена по мере необходимости к вспомогательному толщина представления (но никогда автоматически сокращена). Для предотвращения перемозаичного размещения представления прокрутки представления линейки необходимо установить его максимальную толщину после создания использования setReservedThicknessForAccessoryView:.

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

  • Устанавливает комнату, доступную для маркеров линейки к thickness.

    Объявление

    Swift

    var reservedThicknessForMarkers: CGFloat

    Objective C

    @property CGFloat reservedThicknessForMarkers

    Обсуждение

    Толщина по умолчанию, зарезервированная для маркеров, является 15,0 модулями PostScript для горизонтальной линейки и 0,0 модулями PostScript для вертикальной линейки (под предположением, что вертикальные линейки редко содержат маркеры). Если Вы не ожидаете иметь какие-либо маркеры на линейке, можно установить зарезервированную толщину в 0,0.

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

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

  • Возвращает толщину, зарезервированную для содержания изображений маркеров линейки получателя, высоты или ширины в зависимости от ориентации получателя.

    Объявление

    Swift

    var reservedThicknessForMarkers: CGFloat

    Objective C

    @property CGFloat reservedThicknessForMarkers

    Обсуждение

    Эта толщина автоматически увеличена по мере необходимости для размещения самого толстого изображения маркера линейки (но никогда автоматически сокращена). Для предотвращения перемозаичного размещения представления прокрутки представления линейки необходимо установить его максимальную толщину после создания использования setReservedThicknessForMarkers:.

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

    См. также

    – thicknessRequiredInRuler (NSRulerMarker)

  • Наборы к thickness толщина области, где нарисованы знаки «диез» линейки и метки.

    Объявление

    Swift

    var ruleThickness: CGFloat

    Objective C

    @property CGFloat ruleThickness

    Обсуждение

    Это значение является высотой области линейки для горизонтальной линейки или ширины области линейки для вертикальной линейки. Линейки являются значением по умолчанию 16,0 толстыми модулями PostScript. Необходимо редко должны быть изменить этот атрибут макета, но подклассы могли бы сделать так для размещения пользовательского получения.

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

    См. также

    – ruleThickness

  • Возвращает толщину области линейки получателя (область, где знаки «диез» и метки нарисованы), ее высота или ширина в зависимости от ориентации получателя.

    Объявление

    Swift

    var ruleThickness: CGFloat

    Objective C

    @property CGFloat ruleThickness

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

    См. также

    – setRuleThickness:

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

    Объявление

    Swift

    var requiredThickness: CGFloat { get }

    Objective C

    @property(readonly) CGFloat requiredThickness

    Обсуждение

    Эта толщина является высотой горизонтальной линейки и шириной вертикальной линейки. Требуемая толщина является суммой толщин области линейки, области маркера и вспомогательного представление.

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

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

    Объявление

    Swift

    var baselineLocation: CGFloat { get }

    Objective C

    @property(readonly) CGFloat baselineLocation

    Обсуждение

    Это - y позиция для горизонтальных линеек и x позиция для вертикальных.

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

    См. также

    – ruleThickness

  • isFlipped - isFlipped Доступный в OS X v10.0 через OS X v10.9

    Возвраты YEStrue если система координат NSRulerView зеркально отражается, NOfalse иначе.

    Объявление

    Objective C

    - (BOOL)isFlipped

    Обсуждение

    Вертикальная линейка принимает во внимание, зеркально отражается ли система координат представления документа NSScrollView — не клиентского представления получателя —. Горизонтальная линейка всегда зеркально отражается.

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

    Objective C

    @import AppKit;

    Доступность

    Доступный в OS X v10.0 через OS X v10.9.

Типы данных

  • Эти константы определяются для указания ориентации линейки и используются orientation и setOrientation:.

    Объявление

    Swift

    enum NSRulerOrientation : UInt { case HorizontalRuler case VerticalRuler }

    Objective C

    typedef enum { NSHorizontalRuler, NSVerticalRuler } NSRulerOrientation;

    Константы

    • HorizontalRuler

      NSHorizontalRuler

      Линейка ориентирована горизонтально.

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

    • VerticalRuler

      NSVerticalRuler

      Линейка ориентирована вертикально.

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

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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