NSSliderCell
NSSliderCell
возразите управляет появлением и поведением NSSlider
объект, или единственного ползунка в NSMatrix
объект.
Можно настроить NSSliderCell
до известной степени, использование set...
методы. Если эти методы не дают Вам достаточную гибкость, можно создать подкласс. В том подклассе можно переопределить любой из следующих методов: knobRectFlipped:
, drawBarInside:flipped:
, drawKnob:
, и prefersTrackingUntilMouseUp
.
Соответствует
Оператор импорта
Swift
import AppKit
Objective C
@import AppKit;
Доступность
Доступный в OS X v10.0 и позже.
-
Возвращает сумму, которой ползунок изменяет свое значение, когда пользователь Перетаскивает опция кнопку.
Возвращаемое значение
Сумма, которой ползунок изменяет свое значение, когда пользователь перетаскивает кнопку с удерживаемой функциональной клавишей. Если Вы не вызываете
setAltIncrementValue:
,altIncrementValue
возвраты –1.0 и ползунок ведут себя не по-другому с функциональной клавишей вниз, чем с ним.Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.0 и позже.
См. также
-
Устанавливает сумму, которой получатель изменяет свое значение, когда кнопка Перетаскивается опцией.
Параметры
increment
Сумма, которой получатель изменяет свое значение, когда кнопка Перетаскивается опцией. Это число должно соответствовать диапазону значений, которые ползунок может представлять — например, если ползунок имеет минимальное значение 5 и максимальное значение 10,
increment
должен быть между 0 и 5.Обсуждение
Если Вы не вызываете этот метод, ползунок ведет себя то же независимо от того, удерживается ли функциональная клавиша (это - также результат, когда Вы вызываете
setAltIncrementValue:
с инкрементом –1).Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.0 и позже.
См. также
-
Возвращает булево значение, указывающее ли
NSSliderCell
продолжает отслеживать указатель до следующей мыши.Объявление
Swift
class func prefersTrackingUntilMouseUp() -> Bool
Objective C
+ (BOOL)prefersTrackingUntilMouseUp
Возвращаемое значение
YES
true
еслиNSSliderCell
продолжает отслеживать указатель даже после того, как он оставит прямоугольник отслеживания ячейки; иначе,NO
false
. По умолчанию, этот метод возвратыYES
true
.Обсуждение
Если возвращается этот метод
YES
true
, пользователи сохраняют контроль над кнопкой, пока они не отпускают кнопку мыши, даже если они перетаскивают указатель на другую сторону экрана.Вы не должны вызывать этот метод явно. Переопределите его при создании подкласса
NSSliderCell
это должно отследить мышь по-другому.Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.0 и позже.
-
Возвращает прямоугольник, в котором ячейка отслеживает указатель, в то время как снижается кнопка мыши.
Возвращаемое значение
Прямоугольник отслеживания
NSSliderCell
. Этот прямоугольник включает панель ползунка, но не внешнюю панель.Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.0 и позже.
-
Устанавливает тип ползунка к линейному или круговому.
Параметры
sliderType
Постоянное указание типа ползунка. Возможные значения описаны в
NSSliderType
.Обсуждение
Если
sliderType
NSCircularSlider
, тогда Вы получаете круговой ползунок фиксированного размера. Минимальное значение (minValue
) наверху, и повышения стоимости по часовой стрелке вокруг набора. Максимальное выбираемое значение чуть нижеmaxValue
; например, еслиmaxValue
360, можно установить набор до 359,999.Можно использовать
setNumberOfTickMarks:
метод для отображения меток, и можно использоватьsetAllowsTickMarkValuesOnly:
метод, чтобы указать, что значения ограничиваются теми значениями, представленными метками. Можно установить это управление в регулярные или небольшие размеры; мини-размер не поддерживается.Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.3 и позже.
-
Возвращает тип ползунка, или линейный или круговой.
Возвращаемое значение
Постоянное указание типа ползунка. Возможные возвращаемые значения описаны в
NSSliderType
.Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.3 и позже.
См. также
-
Возвращает прямоугольник, в котором нарисована панель.
Объявление
Swift
func barRectFlipped(_
flipped
: Bool) -> NSRectObjective C
- (NSRect)barRectFlipped:(BOOL)
flipped
Параметры
flipped
YES
true
если система координат связанногоNSSlider
илиNSMatrix
зеркально отражается; иначеNO
false
. Можно определить ли дело обстоит так путем отправкиNSView
сообщениеisFlipped
обменивайтесь сообщениями кNSMatrix
илиNSSlider
.Возвращаемое значение
Прямоугольник, в котором нарисована панель, указал в системе координат
NSSlider
илиNSMatrix
с которым связан получатель. Панель не включает внешнюю панель или кнопку ползунка.Обсуждение
Если пользовательские иллюстрации панели требуют определенных размерностей, можно переопределить этот метод.
Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.9 и позже.
-
Рисует метки ползунка.
Объявление
Swift
func drawTickMarks()
Objective C
- (void)drawTickMarks
Обсуждение
Вы не должны вызывать этот метод явно. Это включено так, можно переопределить его в подклассе и нарисовать пользовательские метки.
Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.9 и позже.
-
Возвращает прямоугольник, в котором нарисована кнопка ползунка.
Объявление
Swift
func knobRectFlipped(_
flipped
: Bool) -> NSRectObjective C
- (NSRect)knobRectFlipped:(BOOL)
flipped
Параметры
flipped
YES
true
если система координат связанногоNSSlider
илиNSMatrix
зеркально отражается; иначеNO
false
. Можно определить ли дело обстоит так путем отправкиNSView
сообщениеisFlipped
обменивайтесь сообщениями кNSMatrix
илиNSSlider
.Возвращаемое значение
Прямоугольник, в котором нарисована кнопка, указал в системе координат
NSSlider
илиNSMatrix
с которым связан получатель.Прямоугольник кнопки зависит от того, где в ползунке кнопка принадлежит — т.е. это зависит от минимальных и максимальных значений получателя и от значения, которое будет представлять позиция кнопки.
Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.0 и позже.
-
Рисует панель ползунка — но не ее внешняя панель или кнопка — в указанном прямоугольнике.
Объявление
Swift
func drawBarInside(_
aRect
: NSRect, flippedflipped
: Bool)Objective C
- (void)drawBarInside:(NSRect)
aRect
flipped:(BOOL)flipped
Параметры
aRect
Границы панели ползунка, не ее внутреннего прямоугольника.
flipped
Булево значение, указывающее ли представление управления ячейки — т.е.
NSSlider
илиNSMatrix
связанный сNSSliderCell
— имеет зеркально отраженную систему координат.Обсуждение
Вы не должны вызывать этот метод явно. Это включено так, можно переопределить его в подклассе.
Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.0 и позже.
См. также
-
Вычисляет прямоугольник, в котором кнопка должна быть нарисована, затем вызывает
drawKnob:
фактически нарисовать кнопку.Объявление
Swift
func drawKnob()
Objective C
- (void)drawKnob
Обсуждение
Прежде чем это сообщение отправляется, a
lockFocus
метод должен быть отправлен в представление управления ячейки.Вы могли бы вызвать этот метод при переопределении одного из методов дисплея, принадлежащих
NSControl
илиNSCell
.Специальные замечания
Если Вы создаете подкласс
NSSliderCell
, не переопределяйте этот метод. ПереопределениеdrawKnob:
вместо этого.Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.0 и позже.
-
Рисует кнопку ползунка в данном прямоугольнике.
Параметры
knobRect
Прямоугольник, в котором можно нарисовать кнопку ползунка.
Обсуждение
Прежде чем это сообщение отправляется, a
lockFocus
сообщение должно быть отправлено в представление управления ячейки.Вы не должны вызывать этот метод явно. Это включено так, можно переопределить его в подклассе.
Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.0 и позже.
-
Возвращает толщину кнопки.
Объявление
Swift
var knobThickness: CGFloat { get }
Objective C
@property(readonly) CGFloat knobThickness
Возвращаемое значение
Толщина кнопки ползунка, в пикселях. Толщина определяется, чтобы быть степенью кнопки вдоль длинной размерности панели. В вертикальном ползунке толщина кнопки является своей высотой; в горизонтальном ползунке его толщина является его шириной.
Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.0 и позже.
См. также
-
setKnobThickness: - setKnobThickness:
(OS X v10.9)Установите толщину кнопки, измеренную в пикселях.
Оператор осуждения
Нет никакого метода замены.
Объявление
Objective C
- (void)setKnobThickness:(CGFloat)
thickness
Параметры
thickness
Толщина кнопки. Толщина определяется, чтобы быть степенью кнопки вдоль длинной размерности панели. В вертикальном ползунке, тогда, толщина кнопки является своей высотой; в горизонтальном ползунке его толщина является его шириной.
Оператор импорта
Objective C
@import AppKit;
Доступность
Доступный в OS X v10.0 и позже.
Осуждаемый в OS X v10.9.
См. также
-
isVertical - isVertical
Доступный в OS X v10.0 через OS X v10.9Возвращает целое число, указывающее ориентацию (вертикальный или горизонтальный) ползунка.
Объявление
Objective C
- (NSInteger)isVertical
Возвращаемое значение
1, если ползунок является вертикальным, 0, если это - горизонталь, и –1, если ориентация не может быть определена (например, если ползунок еще не был выведен на экран). Если его высота больше, чем его ширина, ползунок определяется как вертикальный.
Оператор импорта
Objective C
@import AppKit;
Доступность
Доступный в OS X v10.0 через OS X v10.9.
-
заголовок - заголовок
(OS X v10.9)Возвращает заголовок ползунка.
Оператор осуждения
Ползунок не включает заголовок.
Объявление
Objective C
- (NSString *)title
Возвращаемое значение
Заголовок. Заголовок по умолчанию является пустой строкой (
@""
).Оператор импорта
Objective C
@import AppKit;
Доступность
Доступный в OS X v10.0 и позже.
Осуждаемый в OS X v10.9.
См. также
-
setTitle: - setTitle:
(OS X v10.9)Устанавливает заголовок в панели позади кнопки ползунка.
Оператор осуждения
Ползунок не включает заголовок.
Объявление
Objective C
- (void)setTitle:(NSString *)
title
Параметры
title
Заголовок.
Оператор импорта
Objective C
@import AppKit;
Доступность
Доступный в OS X v10.0 и позже.
Осуждаемый в OS X v10.9.
См. также
-
titleCell - titleCell
(OS X v10.9)Возвраты
nil
.Оператор осуждения
Ползунок не включает заголовок.
Объявление
Objective C
- (id)titleCell
Оператор импорта
Objective C
@import AppKit;
Доступность
Доступный в OS X v10.0 и позже.
Осуждаемый в OS X v10.9.
См. также
-
setTitleCell: - setTitleCell:
(OS X v10.9)Устанавливает ячейку, используемую для рисования заголовка ползунка.
Оператор осуждения
Ползунок не включает заголовок.
Объявление
Objective C
- (void)setTitleCell:(NSCell *)
aCell
Обсуждение
Только необходимо вызвать этот метод если ячейка заголовка по умолчанию,
NSTextFieldCell
, не удовлетворяет Вашим потребностям — т.е. если Вы хотите вывести на экран заголовок способом этоNSTextFieldCell
не разрешает. Когда Вы действительно принимаете решение переопределить значение по умолчанию,aCell
должен быть экземпляр подклассаNSTextFieldCell
.Оператор импорта
Objective C
@import AppKit;
Доступность
Доступный в OS X v10.0 и позже.
Осуждаемый в OS X v10.9.
См. также
-
titleFont - titleFont
(OS X v10.9)Возвраты
nil
.Оператор осуждения
Ползунок не включает заголовок.
Объявление
Objective C
- (NSFont *)titleFont
Оператор импорта
Objective C
@import AppKit;
Доступность
Доступный в OS X v10.0 и позже.
Осуждаемый в OS X v10.9.
См. также
-
titleColor - titleColor
(OS X v10.9)Возвраты
nil
.Оператор осуждения
Ползунок не включает заголовок.
Объявление
Objective C
- (NSColor *)titleColor
Оператор импорта
Objective C
@import AppKit;
Доступность
Доступный в OS X v10.0 и позже.
Осуждаемый в OS X v10.9.
См. также
-
setTitleFont: - setTitleFont:
(OS X v10.9)Устанавливает шрифт, используемый для рисования заголовка ползунка.
Оператор осуждения
Ползунок не включает заголовок.
Объявление
Objective C
- (void)setTitleFont:(NSFont *)
fontObj
Оператор импорта
Objective C
@import AppKit;
Доступность
Доступный в OS X v10.0 и позже.
Осуждаемый в OS X v10.9.
См. также
-
setTitleColor: - setTitleColor:
(OS X v10.9)Выбирает цвет, используемый для рисования заголовка ползунка.
Оператор осуждения
Ползунок не включает заголовок.
Объявление
Objective C
- (void)setTitleColor:(NSColor *)
newColor
Оператор импорта
Objective C
@import AppKit;
Доступность
Доступный в OS X v10.0 и позже.
Осуждаемый в OS X v10.9.
См. также
-
Возвращает максимальное значение, которое ползунок может отправить в его цель.
Возвращаемое значение
Максимальное значение ползунка. Когда кнопка в правильном конце ползунка, горизонтальный ползунок отправляет свое максимальное значение; когда кнопка наверху, вертикальный ползунок отправляет его.
Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.0 и позже.
См. также
-
Устанавливает максимальное значение, которое ползунок может отправить в его цель.
Параметры
aDouble
Максимальное значение ползунка. Когда его кнопка полностью вправо, горизонтальный ползунок отправляет свое максимальное значение; когда его кнопка наверху, вертикальный ползунок отправляет свое максимальное значение. Максимальное выбираемое значение для кругового ползунка чуть ниже
maxValue
; например, еслиmaxValue
360, можно установить набор до 359,999.Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.0 и позже.
См. также
-
Возвращает минимальное значение, которое ползунок может отправить в его цель.
Возвращаемое значение
Минимальное значение ползунка. Когда его кнопка в нижней части, вертикальный ползунок отправляет это значение; когда его кнопка полностью налево, горизонтальный ползунок отправляет его; когда его кнопка наверху, круговой ползунок отправляет его.
Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.0 и позже.
-
Устанавливает минимальное значение, которое ползунок может отправить в его цель.
Параметры
aDouble
Минимальное значение ползунка. Когда его кнопка полностью налево, горизонтальный ползунок отправляет свое минимальное значение; когда его кнопка в нижней части, вертикальный ползунок отправляет свое минимальное значение; когда его кнопка наверху, круговой ползунок отправляет его.
Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.0 и позже.
См. также
-
Возвращает булево значение, указывающее, фиксирует ли получатель свои значения к тем значениям, представленным его метками.
Объявление
Swift
var allowsTickMarkValuesOnly: Bool
Objective C
@property BOOL allowsTickMarkValuesOnly
Возвращаемое значение
YES
true
если значения ползунка ограничиваются теми значениями, представленными метками; иначе,NO
false
.Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.0 и позже.
См. также
-
Возвращает значение метки, самой близкой к указанному значению.
Объявление
Objective C
- (double)closestTickMarkValueToValue:(double)
aValue
Параметры
aValue
Значение, для которого можно получить самую близкую метку.
Возвращаемое значение
Значение самой близкой метки.
Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.0 и позже.
См. также
-
Возвращает индекс метки, самой близкой к расположению ползунка, представленного указанной точкой.
Объявление
Параметры
point
Точка, представляющая расположение ползунка.
Возвращаемое значение
Индекс метки, самой близкой к указанному расположению.
Обсуждение
Если
point
не в ограничительном прямоугольнике (плюс дополнительный пиксель пространства) никакой метки, возвратов методаNSNotFound
. Это вызовы методаrectOfTickMarkAtIndex:
для каждой метки на ползунке, пока это не находит метку, содержащуюpoint
.Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.0 и позже.
-
Возвращает число меток, связанных с ползунком.
Возвращаемое значение
Число меток. Метки, присвоенные минимальным и максимальным значениям, включены.
Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.0 и позже.
См. также
-
Возвращает ограничительный прямоугольник метки в указанном индексе.
Объявление
Параметры
index
Индекс метки, для которой можно возвратить ограничительный прямоугольник. Метка минимального значения в индексе 0.
Возвращаемое значение
Ограничительный прямоугольник указанной метки.
Обсуждение
Если никакая метка не связана с
index
, повышения методаNSRangeException
.Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.0 и позже.
См. также
-
Наборы, фиксируются ли значения получателя к значениям, представленным метками.
Объявление
Swift
var allowsTickMarkValuesOnly: Bool
Objective C
@property BOOL allowsTickMarkValuesOnly
Параметры
flag
YES
true
если значения ползунка фиксируются к значениям, представленным метками ползунка; иначеNO
false
. Например, если Вы указываетеYES
true
для ползунка, имеющего минимальное значение 0, максимальное значение 100, и пять маркеров, допустимые значения 0, 25, 50, 75, и 100. Когда пользователи перемещают кнопку ползунка, она переходит к метке, самой близкой указатель, когда отпускается кнопка мыши. Если ползунок не имеет никаких меток, этот метод не имеет никакого эффекта.Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.0 и позже.
См. также
-
Определяет номер меток, выведенных на экран получателем.
Параметры
numberOfTickMarks
Число меток, выведенных на экран ползунком, включая присвоенных минимальным и максимальным значениям. По умолчанию это значение 0, и никакие метки не появляются. Число меток, присвоенных ползунку, вместе с минимальными и максимальными значениями ползунка, определяет значения, связанные с метками.
Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.0 и позже.
См. также
-
Наборы, где метки появляются относительно получателя.
Объявление
Swift
var tickMarkPosition: NSTickMarkPosition
Objective C
@property NSTickMarkPosition tickMarkPosition
Параметры
position
Постоянное указание позиции меток. Возможные значения описаны в
NSTickMarkPosition
.Обсуждение
Этот метод не имеет никакого эффекта, если никакие метки не были присвоены (т.е. если
numberOfTickMarks
возвраты 0).Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.0 и позже.
См. также
-
Возвращает позицию меток относительно получателя.
Объявление
Swift
var tickMarkPosition: NSTickMarkPosition
Objective C
@property NSTickMarkPosition tickMarkPosition
Возвращаемое значение
Постоянное указание позиции меток. Возможные значения описаны в
NSTickMarkPosition
. Выравнивание по умолчаниюNSTickMarkBelow
иNSTickMarkLeft
.Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.0 и позже.
См. также
-
Возвращает значение получателя, представленное меткой в указанном индексе.
Объявление
Objective C
- (double)tickMarkValueAtIndex:(NSInteger)
index
Параметры
index
Индекс метки, для которой можно получить значение. Метка минимального значения имеет индекс 0.
Возвращаемое значение
Значение представлено указанной меткой.
Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.0 и позже.
Типы данных
-
Указывает где метки
NSSliderCell
объект появляется.Объявление
Swift
enum NSTickMarkPosition : UInt { case Below case Above }
Objective C
typedef enum _NSTickMarkPosition { NSTickMarkBelow = 0, NSTickMarkAbove = 1, NSTickMarkLeft = NSTickMarkAbove, NSTickMarkRight = NSTickMarkBelow } NSTickMarkPosition;
Константы
-
Below
NSTickMarkBelow
Метки ниже (для горизонтальных ползунков); значение по умолчанию для горизонтальных ползунков.
Доступный в OS X v10.0 и позже.
-
Above
NSTickMarkAbove
Метки выше (для горизонтальных ползунков).
Доступный в OS X v10.0 и позже.
-
NSTickMarkLeft
NSTickMarkLeft
Метки налево (для вертикальных ползунков); значение по умолчанию. для вертикальных ползунков
Доступный в OS X v10.0 и позже.
-
NSTickMarkRight
NSTickMarkRight
Метки вправо (для вертикальных ползунков).
Доступный в OS X v10.0 и позже.
Обсуждение
Эти константы используются в
setTickMarkPosition:
иtickMarkPosition
.Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.0 и позже.
-
-
Типы ползунков, используемых
setSliderType:
иsliderType
.Объявление
Swift
enum NSSliderType : UInt { case LinearSlider case CircularSlider }
Objective C
typedef enum { NSLinearSlider = 0, NSCircularSlider = 1 } NSSliderType;
Константы
-
LinearSlider
NSLinearSlider
Ползунок формы панели.
Доступный в OS X v10.3 и позже.
-
CircularSlider
NSCircularSlider
Круговой ползунок; т.е. набор.
Доступный в OS X v10.3 и позже.
Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.3 и позже.
-