NSRulerView
Класс сразу
NSRulerView выводит на экран линейку и маркеры выше или стороне представления документа NSScrollView. Представления в NSScrollView могут стать клиентами представления линейки, имение его выводит на экран маркеры для их элементов и получающие сообщения от представления линейки, когда пользователь управляет маркерами.
NSRulerView находится в NSScrollView, выводя на экран маркированную линейку и маркеры для ее клиента, представления документа NSScrollView или подпредставления представления документа.
Посмотрите NSRulerMarkerClientViewDelegation
для методов делегата, которые могут представлять интерес.
Соответствует
-
AnyObject
-
CVarArgType
-
Сопоставимый
-
Hashable
-
NSAccessibility
-
NSAccessibilityElementProtocol
-
NSAnimatablePropertyContainer
-
NSAppearanceCustomization
-
NSCoding
-
NSDraggingDestination
-
NSObjectProtocol
-
NSUserInterfaceItemIdentification
-
Печатаемый
-
Reflectable
-
NSAccessibility
-
NSAccessibilityElement
-
NSAnimatablePropertyContainer
-
NSAppearanceCustomization
-
NSCoding
-
NSDraggingDestination
-
NSObject
-
NSUserInterfaceItemIdentification
Оператор импорта
Swift
import AppKit
Objective C
@import AppKit;
Доступность
Доступный в OS X v10.0 и позже.
-
Инициализирует недавно выделенный NSRulerView для имения
orientation
(NSHorizontalRuler
илиNSVerticalRuler
) вaScrollView
.Объявление
Swift
init(scrollView
scrollView
: NSScrollView?, orientationorientation
: 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 и позже.
-
registerUnitWithName (_: abbreviation:unitToPointsConversionFactor:stepUpCycle:stepDownCycle:) + registerUnitWithName:abbreviation:unitToPointsConversionFactor:stepUpCycle:stepDownCycle:
Регистрирует новую единицу измерения в классе NSRulerView, делая его доступным для всех экземпляров NSRulerView.
Объявление
Обсуждение
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 и позже.
См. также
-
Устанавливает измерительные модули, привыкшие линейкой к
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 и позже.
См. также
-
Возвращает полное имя измерительных модулей в действительности для получателя.
Объявление
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 и позже.
См. также
-
Возвращает клиентское представление получателя, если оно имеет тот.
Объявление
Swift
unowned(unsafe) var clientView: NSView?
Objective C
@property(assign) NSView *clientView
Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.0 и позже.
См. также
-
Устанавливает представление аксессуара получателя в
aView
.Обсуждение
Повышения
NSInternalInconsistencyException
еслиaView
неnil
и получатель не имеет никакого клиентского представления.Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.0 и позже.
-
Возвращает представление аксессуара получателя, если оно имеет тот.
Оператор импорта
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 и позже.
См. также
-
Возвращает расстояние от нулевого знака «диез» получателя до источника границ представления документа NSScrollView (не клиентское представление получателя), в системе координат представления документа.
Объявление
Swift
var originOffset: CGFloat
Objective C
@property CGFloat originOffset
Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.0 и позже.
См. также
-
Устанавливает маркеры линейки получателя в
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 и позже.
См. также
– setMarkers:
– addMarker:
– removeMarker:
– markerLocation
(NSRulerMarker) -
Добавляет
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, withMouseEventevent
: NSEvent) -> BoolObjective C
- (BOOL)trackMarker:(NSRulerMarker *)
marker
withMouseEvent:(NSEvent *)event
Обсуждение
Возвраты
YES
true
если добавляет получательaMarker
,NO
false
если это не делает. Этот метод работает путем отправкиtrackMouse:adding:
кaMarker
сtheEvent
иYES
true
как параметры.Приложение обычно вызывает этот метод в одном из двух случаев. В более простом случае клиентское представление может реализовать
rulerView:handleMouseDown:
вызвать этот метод, когда пользователь нажимает кнопку мыши, в то время как курсор находится в области линейки NSRulerView. Этот метод является надлежащим, когда ясно, какой маркер будет добавлен путем щелчка по области линейки. Второй, более общий, случай включает приложение, обеспечивающее палитру различных видов маркеров, которые могут быть перетащены на линейку от представления аксессуара линейки или от некоторого другого места. С этим методом палитра отслеживает курсор, пока это не вводит представление линейки, при котором времени это передает управление к представлению линейки путем вызоваtrackMarker:withMouseEvent:
.Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.0 и позже.
См. также
-
Проводит временные линии в области линейки.
Объявление
Swift
func moveRulerlineFromLocation(_
oldLocation
: CGFloat, toLocationnewLocation
: CGFloat)Обсуждение
Если
oldLoc
0 или больше, стирает строку линейки в том расположении; еслиnewLoc
0 или больше, рисует новый rulerline в том расположении.oldLoc
иnewLoc
выражены в системе координат NSRulerView, не клиенте или представлении документа, и координаты x для горизонтальных линеек и координаты y для вертикальных линеек. Используйте NSView’sconvert...
методы для преобразования координат от клиента или системы координат представления документа к тому из 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 и позже.
См. также
-
Устанавливает комнату, доступную для представления аксессуара получателя к
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 и позже.
См. также
-
Возвращает толщину области линейки получателя (область, где знаки «диез» и метки нарисованы), ее высота или ширина в зависимости от ориентации получателя.
Объявление
Swift
var ruleThickness: CGFloat
Objective C
@property CGFloat ruleThickness
Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.0 и позже.
См. также
-
Возвращает толщину, необходимую для надлежащего мозаичного размещения получателя в 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 и позже.
См. также
-
isFlipped - isFlipped
Доступный в OS X v10.0 через OS X v10.9Возвраты
YES
true
если система координат NSRulerView зеркально отражается,NO
false
иначе.Объявление
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 и позже.
-