NSSlider
NSSlider
отображения объекта диапазон значений для чего-то в приложении. Ползунки могут быть вертикальными или горизонтальными планками или круговыми наборами. Индикатор или кнопка, отмечает текущую установку. Пользователь может переместить кнопку в панель ползунка — или повернуть кнопку в круговом ползунке — для изменения настроек.
NSSlider
класс использует NSSliderCell
класс для реализации его пользовательского интерфейса.
Наследование
-
NSObject
-
NSResponder
-
NSView
-
NSControl
-
NSSlider
-
NSObject
-
NSResponder
-
NSView
-
NSControl
-
NSSlider
Соответствует
-
AnyObject
-
CVarArgType
-
Сопоставимый
-
Hashable
-
NSAccessibility
-
NSAccessibilityElementProtocol
-
NSAccessibilitySlider
-
NSAnimatablePropertyContainer
-
NSAppearanceCustomization
-
NSCoding
-
NSDraggingDestination
-
NSObjectProtocol
-
NSUserInterfaceItemIdentification
-
Печатаемый
-
Reflectable
-
NSAccessibility
-
NSAccessibilityElement
-
NSAccessibilitySlider
-
NSAnimatablePropertyContainer
-
NSAppearanceCustomization
-
NSCoding
-
NSDraggingDestination
-
NSObject
-
NSUserInterfaceItemIdentification
Оператор импорта
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 и позже.
См. также
-
изображение - изображение
(OS X v10.9)Этот метод был осужден. Возвраты
nil
.Объявление
Objective C
- (NSImage *)image
Оператор импорта
Objective C
@import AppKit;
Доступность
Доступный в OS X v10.0 и позже.
Осуждаемый в OS X v10.9.
См. также
-
Возвращает толщину кнопки, в пикселях.
Объявление
Swift
var knobThickness: CGFloat { get }
Objective C
@property(readonly) CGFloat knobThickness
Возвращаемое значение
Толщина кнопки ползунка. Толщина определяется, чтобы быть степенью кнопки вдоль длинной размерности панели. В вертикальном ползунке, тогда, толщина кнопки является своей высотой; в горизонтальном ползунке толщина кнопки является своей шириной.
Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.0 и позже.
См. также
-
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.
-
Устанавливает сумму который
NSSliderCell
когда пользователь Перетаскивает опция кнопку, изменяет его значение.Параметры
increment
Сумма, которой изменяется значение ползунка, когда пользователь Перетаскивает опция его кнопку. Это значение должно соответствовать диапазону значений, которые ползунок может представлять — например, если ползунок имеет минимальное значение 5 и максимальное значение 10, инкремент должен быть между 0 и 5. Если
increment
вне того диапазона, значение неизменно.Обсуждение
Если Вы не вызываете этот метод, ползунок ведет себя то же с функциональной клавишей вниз как с ним. Когда Вы вызываете, это - также результат
setAltIncrementValue:
с инкрементом –1.Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.0 и позже.
См. также
-
setImage: - setImage:
(OS X v10.9)Этот метод был осужден. Устанавливает изображение дисплеи получателя в панели позади ее кнопки.
Объявление
Objective C
- (void)setImage:(NSImage *)
barImage
Параметры
barImage
Изображение для установки.
Обсуждение
Ползунок может масштабировать и исказить
barImage
соответствовать в панели.Кнопка может покрыть часть изображения. Если Вы хотите, чтобы изображение было видимо все время, Вы - более обеспеченное размещение его около ползунка.
Оператор импорта
Objective C
@import AppKit;
Доступность
Доступный в OS X v10.0 и позже.
Осуждаемый в OS X v10.9.
См. также
-
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.
См. также
-
заголовок - заголовок
(OS X v10.9)Возвращает заголовок получателя.
Объявление
Objective C
- (NSString *)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.
См. также
-
titleColor - titleColor
(OS X v10.9)Этот метод был осужден. Возвраты
nil
.Объявление
Objective C
- (NSColor *)titleColor
Оператор импорта
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.
См. также
-
setTitle: - setTitle:
(OS X v10.9)Этот метод был осужден. Устанавливает заголовок дисплеи получателя в панели позади ее кнопки.
Объявление
Objective C
- (void)setTitle:(NSString *)
barTitle
Параметры
barTitle
Заголовок ползунка. Кнопка может покрыть часть или весь заголовок. Если Вы хотите, чтобы заголовок был видим все время, Вы - более обеспеченное размещение метки около ползунка.
Оператор импорта
Objective C
@import AppKit;
Доступность
Доступный в OS X v10.0 и позже.
Осуждаемый в OS X v10.9.
См. также
-
setTitleCell: - setTitleCell:
(OS X v10.9)Этот метод был осужден. Устанавливает ячейку, используемую для рисования заголовка получателя.
Объявление
Objective C
- (void)setTitleCell:(NSCell *)
titleCell
Параметры
titleCell
Ячейка раньше составляла заголовок.
Обсуждение
Только необходимо вызвать этот метод если ячейка заголовка по умолчанию,
NSTextFieldCell
, не удовлетворяет Вашим потребностям — т.е. Вы хотите вывести на экран заголовок способом этоNSTextFieldCell
не разрешает. Когда Вы действительно принимаете решение переопределить значение по умолчанию,titleCell
должен быть экземпляр подклассаNSTextFieldCell
.Оператор импорта
Objective C
@import AppKit;
Доступность
Доступный в OS X v10.0 и позже.
Осуждаемый в OS X v10.9.
См. также
-
setTitleColor: - setTitleColor:
(OS X v10.9)Этот метод был осужден. Выбирает цвет, используемый для рисования заголовка получателя.
Объявление
Objective C
- (void)setTitleColor:(NSColor *)
color
Параметры
color
Цвет заголовка.
Оператор импорта
Objective C
@import AppKit;
Доступность
Доступный в OS X v10.0 и позже.
Осуждаемый в OS X v10.9.
См. также
-
setTitleFont: - setTitleFont:
(OS X v10.9)Этот метод был осужден. Устанавливает шрифт, используемый для рисования заголовка получателя.
Объявление
Objective C
- (void)setTitleFont:(NSFont *)
font
Параметры
font
Шрифт заголовка.
Оператор импорта
Objective C
@import AppKit;
Доступность
Доступный в OS X v10.0 и позже.
Осуждаемый в OS X v10.9.
См. также
-
Возвращает максимальное значение, которое получатель может отправить в его цель.
Возвращаемое значение
Максимальное значение ползунка. Когда кнопка в правильном конце панели, горизонтальный ползунок отправляет свое максимальное значение; когда кнопка наверху, вертикальный ползунок отправляет его.
Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.0 и позже.
См. также
-
Возвращает минимальное значение, которое получатель может отправить в его цель.
Возвращаемое значение
Минимальное значение ползунка. Когда его кнопка в нижней части, вертикальный ползунок отправляет свое минимальное значение; горизонтальный ползунок, когда его кнопка полностью налево.
Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.0 и позже.
См. также
-
Устанавливает максимальное значение, которое получатель может отправить в его цель.
Параметры
maxValue
Максимальное значение ползунка. Когда его кнопка полностью вправо, горизонтальный ползунок отправляет свое максимальное значение; когда его кнопка наверху, вертикальный ползунок отправляет свое максимальное значение.
Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.0 и позже.
См. также
-
Устанавливает минимальное значение, которое получатель может отправить в его цель
Параметры
minValue
Минимальное значение ползунка. Когда его кнопка полностью налево, горизонтальный ползунок отправляет свое минимальное значение; когда его кнопка в нижней части, вертикальный ползунок отправляет свое минимальное значение.
Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.0 и позже.
См. также
-
Возвращает булево значение, указывающее, принимает ли ползунок единственное событие mouseDown, одновременно активирующее окно и захватывающее кнопку ползунка.
Объявление
Swift
func acceptsFirstMouse(_
mouseDownEvent
: NSEvent) -> BoolObjective C
- (BOOL)acceptsFirstMouse:(NSEvent *)
mouseDownEvent
Параметры
mouseDownEvent
Событие mouseDown.
Возвращаемое значение
YES
true
если получатель принимает первое событие mouseDown; иначе,NO
false
. ВозвратыYES
true
по умолчанию.Обсуждение
Если Вы хотите, чтобы получатель ожидал его собственного события mouseDown, необходимо переопределить этот метод.
Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.0 и позже.
-
Возвращает булево значение, указывающее, фиксирует ли получатель свои значения к тем значениям, представленным его метками.
Объявление
Swift
var allowsTickMarkValuesOnly: Bool
Objective C
@property BOOL allowsTickMarkValuesOnly
Возвращаемое значение
YES
true
если ползунок фиксирует свои значения к значениям, представленным его метками; иначе,NO
false
.Обсуждение
В его реализации этого метода, получении
NSSlider
объект просто вызывает метод того же имениNSSliderCell
объект.Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.0 и позже.
См. также
-
Возвращает значение метки, самой близкой к указанному значению.
Объявление
Objective C
- (double)closestTickMarkValueToValue:(double)
aValue
Параметры
aValue
Значение, для которого можно возвратить самую близкую метку.
Возвращаемое значение
Значение метки, самой близкой к
aValue
.Обсуждение
В его реализации этого метода получатель просто вызывает метод того же имени
NSSliderCell
экземпляр.Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.0 и позже.
См. также
-
Возвращает индекс метки, самой близкой к расположению получателя, представленного данной точкой.
Объявление
Параметры
point
Точка, представляющая расположение, для которого можно получить метку.
Возвращаемое значение
Индекс метки, самой близкой к расположению, указанному
point
. Еслиpoint
не в ограничительном прямоугольнике (плюс дополнительный пиксель пространства) никакой метки, возвратов методаNSNotFound
.Обсуждение
В его реализации этого метода, получении
NSSlider
экземпляр просто вызывает метод того же имениNSSliderCell
экземпляр. Этот метод вызываетrectOfTickMarkAtIndex:
для каждой метки на ползунке, пока это не находит метку, содержащую точку.Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.0 и позже.
См. также
-
Возвращает число меток, связанных с получателем.
Возвращаемое значение
Число меток ползунка. Метки, присвоенные минимальным и максимальным значениям, включены. В его реализации этого метода, получении N
NSSlider
экземпляр просто вызывает метод того же имениNSSliderCell
экземпляр.Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.0 и позже.
См. также
-
Возвращает ограничительный прямоугольник метки в данном индексе.
Объявление
Параметры
index
Индекс метки, для которой можно получить границы. Метка минимального значения в индексе 0.
Возвращаемое значение
Ограничительный прямоугольник указанной метки.
Обсуждение
Если никакая метка не связана с
index
, повышения методаNSRangeException
. В его реализации этого метода, полученииNSSlider
экземпляр просто вызывает метод того же имениNSSliderCell
экземпляр.Оператор импорта
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
. Например, если ползунок имеет минимальное значение 0, максимальное значение 100, и пять маркеров, допустимые значения 0, 25, 50, 75, и 100. Когда пользователи перемещают кнопку ползунка, она переходит к метке, самой близкой курсор, когда отпускается кнопка мыши.Обсуждение
Если ползунок не имеет никаких меток, этот метод не имеет никакого эффекта. В его реализации этого метода, получении
NSSlider
экземпляр просто вызывает метод того же имениNSSliderCell
экземпляр.Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.0 и позже.
См. также
-
Определяет номер меток, выведенных на экран получателем.
Параметры
numberOfTickMarks
Число меток (включая присвоенных минимальным и максимальным значениям) выведенный на экран ползунком. По умолчанию это значение 0, и никакие метки не появляются. Число меток, присвоенных ползунку, вместе с минимальными и максимальными значениями ползунка, определяет значения, связанные с метками.
Обсуждение
В его реализации этого метода, получении
NSSlider
экземпляр просто вызывает метод того же имениNSSliderCell
экземпляр.Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.0 и позже.
См. также
-
Наборы, где метки появляются относительно получателя.
Объявление
Swift
var tickMarkPosition: NSTickMarkPosition
Objective C
@property NSTickMarkPosition tickMarkPosition
Параметры
position
Постоянное указание позиции меток. Для горизонтальных ползунков это может быть
NSTickMarkBelow
(значение по умолчанию) илиNSTickMarkAbove
; для вертикальных ползунков это может бытьNSTickMarkLeft
(значение по умолчанию) илиNSTickMarkRight
.Обсуждение
Этот метод не имеет никакого эффекта, если никакие метки не были присвоены (т.е.
numberOfTickMarks
возвраты 0). В его реализации этого метода, полученииNSSlider
экземпляр просто вызывает метод того же имениNSSliderCell
экземпляр.Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.0 и позже.
См. также
-
Возвраты, как метки получателя выровненные его.
Объявление
Swift
var tickMarkPosition: NSTickMarkPosition
Objective C
@property NSTickMarkPosition tickMarkPosition
Возвращаемое значение
Постоянное указание позиции меток. Возможные значения
NSTickMarkBelow
,NSTickMarkAbove
,NSTickMarkLeft
, иNSTickMarkRight
(последние два для вертикальных ползунков). Выравнивание по умолчаниюNSTickMarkBelow
иNSTickMarkLeft
.Обсуждение
В его реализации этого метода, получении
NSSlider
экземпляр просто вызывает метод того же имениNSSliderCell
экземпляр.Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.0 и позже.
См. также
-
Возвращает значение получателя, представленное меткой в указанном индексе.
Объявление
Objective C
- (double)tickMarkValueAtIndex:(NSInteger)
index
Параметры
index
Индекс метки, для которой можно возвратить значение. Метка минимального значения имеет индекс 0.
Возвращаемое значение
Значение указанной метки.
Обсуждение
В его реализации этого метода, получении
NSSlider
экземпляр просто вызывает метод того же имениNSSliderCell
экземпляр.Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.0 и позже.