2232 lines
78 KiB
Plaintext
2232 lines
78 KiB
Plaintext
|
|
/**
|
|
* Implementation of the native Cocoa View that serves as container for the scintilla parts.
|
|
* @file ScintillaView.mm
|
|
*
|
|
* Created by Mike Lischke.
|
|
*
|
|
* Copyright 2011, 2013, Oracle and/or its affiliates. All rights reserved.
|
|
* Copyright 2009, 2011 Sun Microsystems, Inc. All rights reserved.
|
|
* This file is dual licensed under LGPL v2.1 and the Scintilla license (http://www.scintilla.org/License.txt).
|
|
*/
|
|
|
|
#include <cmath>
|
|
|
|
#include <string_view>
|
|
#include <vector>
|
|
#include <optional>
|
|
|
|
#import "ScintillaTypes.h"
|
|
#import "ScintillaMessages.h"
|
|
#import "ScintillaStructures.h"
|
|
|
|
#import "Debugging.h"
|
|
#import "Geometry.h"
|
|
#import "Platform.h"
|
|
#import "ScintillaView.h"
|
|
#import "ScintillaCocoa.h"
|
|
|
|
#if !__has_feature(objc_arc)
|
|
#error ARC must be enabled
|
|
#endif
|
|
|
|
using namespace Scintilla;
|
|
using namespace Scintilla::Internal;
|
|
|
|
// Add backend property to ScintillaView as a private category.
|
|
// Specified here as backend accessed by SCIMarginView and SCIContentView.
|
|
@interface ScintillaView()
|
|
@property(nonatomic, readonly) Scintilla::Internal::ScintillaCocoa *backend;
|
|
@end
|
|
|
|
// Two additional cursors we need, which aren't provided by Cocoa.
|
|
static NSCursor *reverseArrowCursor;
|
|
static NSCursor *waitCursor;
|
|
|
|
NSString *const SCIUpdateUINotification = @"SCIUpdateUI";
|
|
|
|
/**
|
|
* Provide an NSCursor object that matches the Window::Cursor enumeration.
|
|
*/
|
|
static NSCursor *cursorFromEnum(Window::Cursor cursor) {
|
|
switch (cursor) {
|
|
case Window::Cursor::text:
|
|
return [NSCursor IBeamCursor];
|
|
case Window::Cursor::arrow:
|
|
return [NSCursor arrowCursor];
|
|
case Window::Cursor::wait:
|
|
return waitCursor;
|
|
case Window::Cursor::horizontal:
|
|
return [NSCursor resizeLeftRightCursor];
|
|
case Window::Cursor::vertical:
|
|
return [NSCursor resizeUpDownCursor];
|
|
case Window::Cursor::reverseArrow:
|
|
return reverseArrowCursor;
|
|
case Window::Cursor::up:
|
|
default:
|
|
return [NSCursor arrowCursor];
|
|
}
|
|
}
|
|
|
|
@implementation SCIScrollView
|
|
- (void) tile {
|
|
[super tile];
|
|
|
|
#if defined(MAC_OS_X_VERSION_10_14)
|
|
if (std::floor(NSAppKitVersionNumber) > NSAppKitVersionNumber10_13) {
|
|
NSRect frame = self.contentView.frame;
|
|
frame.origin.x = self.verticalRulerView.requiredThickness;
|
|
frame.size.width -= frame.origin.x;
|
|
self.contentView.frame = frame;
|
|
}
|
|
#endif
|
|
}
|
|
@end
|
|
|
|
// Add marginWidth and owner properties as a private category.
|
|
@interface SCIMarginView()
|
|
@property(assign) int marginWidth;
|
|
@property(nonatomic, weak) ScintillaView *owner;
|
|
@end
|
|
|
|
@implementation SCIMarginView {
|
|
int marginWidth;
|
|
ScintillaView *__weak owner;
|
|
NSMutableArray *currentCursors;
|
|
}
|
|
|
|
@synthesize marginWidth, owner;
|
|
|
|
- (instancetype) initWithScrollView: (NSScrollView *) aScrollView {
|
|
self = [super initWithScrollView: aScrollView orientation: NSVerticalRuler];
|
|
if (self != nil) {
|
|
owner = nil;
|
|
marginWidth = 20;
|
|
currentCursors = [NSMutableArray arrayWithCapacity: 0];
|
|
for (size_t i=0; i<=SC_MAX_MARGIN; i++) {
|
|
[currentCursors addObject: reverseArrowCursor];
|
|
}
|
|
self.clientView = aScrollView.documentView;
|
|
if ([self respondsToSelector: @selector(setAccessibilityLabel:)])
|
|
self.accessibilityLabel = @"Scintilla Margin";
|
|
}
|
|
return self;
|
|
}
|
|
|
|
|
|
- (void) setFrame: (NSRect) frame {
|
|
super.frame = frame;
|
|
|
|
[self.window invalidateCursorRectsForView: self];
|
|
}
|
|
|
|
- (CGFloat) requiredThickness {
|
|
return marginWidth;
|
|
}
|
|
|
|
- (void) drawHashMarksAndLabelsInRect: (NSRect) aRect {
|
|
if (owner) {
|
|
NSRect contentRect = self.scrollView.contentView.bounds;
|
|
NSRect marginRect = self.bounds;
|
|
// Ensure paint to bottom of view to avoid glitches
|
|
if (marginRect.size.height > contentRect.size.height) {
|
|
// Legacy scroll bar mode leaves a poorly painted corner
|
|
aRect = marginRect;
|
|
}
|
|
owner.backend->PaintMargin(aRect);
|
|
}
|
|
}
|
|
|
|
/**
|
|
* Called by the framework if it wants to show a context menu for the margin.
|
|
*/
|
|
- (NSMenu *) menuForEvent: (NSEvent *) theEvent {
|
|
NSMenu *menu = [owner menuForEvent: theEvent];
|
|
if (menu) {
|
|
return menu;
|
|
} else if (owner.backend->ShouldDisplayPopupOnMargin()) {
|
|
return owner.backend->CreateContextMenu(theEvent);
|
|
} else {
|
|
return nil;
|
|
}
|
|
}
|
|
|
|
- (void) mouseDown: (NSEvent *) theEvent {
|
|
NSClipView *textView = self.scrollView.contentView;
|
|
[textView.window makeFirstResponder: textView];
|
|
owner.backend->MouseDown(theEvent);
|
|
}
|
|
|
|
- (void) rightMouseDown: (NSEvent *) theEvent {
|
|
[NSMenu popUpContextMenu: [self menuForEvent: theEvent] withEvent: theEvent forView: self];
|
|
|
|
owner.backend->RightMouseDown(theEvent);
|
|
}
|
|
|
|
- (void) mouseDragged: (NSEvent *) theEvent {
|
|
owner.backend->MouseMove(theEvent);
|
|
}
|
|
|
|
- (void) mouseMoved: (NSEvent *) theEvent {
|
|
owner.backend->MouseMove(theEvent);
|
|
}
|
|
|
|
- (void) mouseUp: (NSEvent *) theEvent {
|
|
owner.backend->MouseUp(theEvent);
|
|
}
|
|
|
|
// Not a simple button so return failure
|
|
- (BOOL) accessibilityPerformPress {
|
|
return NO;
|
|
}
|
|
|
|
/**
|
|
* This method is called to give us the opportunity to define our mouse sensitive rectangle.
|
|
*/
|
|
- (void) resetCursorRects {
|
|
[super resetCursorRects];
|
|
|
|
int x = 0;
|
|
NSRect marginRect = self.bounds;
|
|
size_t co = currentCursors.count;
|
|
for (size_t i=0; i<co; i++) {
|
|
long cursType = owner.backend->WndProc(Message::GetMarginCursorN, i, 0);
|
|
long width =owner.backend->WndProc(Message::GetMarginWidthN, i, 0);
|
|
NSCursor *cc = cursorFromEnum(static_cast<Window::Cursor>(cursType));
|
|
currentCursors[i] = cc;
|
|
marginRect.origin.x = x;
|
|
marginRect.size.width = width;
|
|
[self addCursorRect: marginRect cursor: cc];
|
|
[cc setOnMouseEntered: YES];
|
|
x += width;
|
|
}
|
|
}
|
|
|
|
- (void) drawRect: (NSRect) rect {
|
|
[super drawRect:rect];
|
|
}
|
|
|
|
@end
|
|
|
|
// Add owner property as a private category.
|
|
@interface SCIContentView()
|
|
@property(nonatomic, weak) ScintillaView *owner;
|
|
@end
|
|
|
|
@implementation SCIContentView {
|
|
ScintillaView *__weak mOwner;
|
|
NSCursor *mCurrentCursor;
|
|
NSTrackingArea *trackingArea;
|
|
|
|
// Set when we are in composition mode and partial input is displayed.
|
|
NSRange mMarkedTextRange;
|
|
}
|
|
|
|
@synthesize owner = mOwner;
|
|
|
|
//--------------------------------------------------------------------------------------------------
|
|
|
|
- (NSView *) initWithFrame: (NSRect) frame {
|
|
self = [super initWithFrame: frame];
|
|
|
|
if (self != nil) {
|
|
// Some initialization for our view.
|
|
mCurrentCursor = [NSCursor arrowCursor];
|
|
trackingArea = nil;
|
|
mMarkedTextRange = NSMakeRange(NSNotFound, 0);
|
|
|
|
[self registerForDraggedTypes: @[NSStringPboardType, ScintillaRecPboardType, NSFilenamesPboardType]];
|
|
|
|
// Set up accessibility in the text role
|
|
if ([self respondsToSelector: @selector(setAccessibilityElement:)]) {
|
|
self.accessibilityElement = TRUE;
|
|
self.accessibilityEnabled = TRUE;
|
|
self.accessibilityLabel = NSLocalizedString(@"Scintilla", nil); // No real localization
|
|
self.accessibilityRoleDescription = @"source code editor";
|
|
self.accessibilityRole = NSAccessibilityTextAreaRole;
|
|
self.accessibilityIdentifier = @"Scintilla";
|
|
}
|
|
}
|
|
|
|
return self;
|
|
}
|
|
|
|
//--------------------------------------------------------------------------------------------------
|
|
|
|
/**
|
|
* When the view is resized or scrolled we need to update our tracking area.
|
|
*/
|
|
- (void) updateTrackingAreas {
|
|
if (trackingArea) {
|
|
[self removeTrackingArea: trackingArea];
|
|
}
|
|
|
|
int opts = (NSTrackingActiveAlways | NSTrackingInVisibleRect | NSTrackingMouseEnteredAndExited | NSTrackingMouseMoved);
|
|
trackingArea = [[NSTrackingArea alloc] initWithRect: self.bounds
|
|
options: opts
|
|
owner: self
|
|
userInfo: nil];
|
|
[self addTrackingArea: trackingArea];
|
|
[super updateTrackingAreas];
|
|
}
|
|
|
|
//--------------------------------------------------------------------------------------------------
|
|
|
|
/**
|
|
* When the view is resized we need to let the backend know.
|
|
*/
|
|
- (void) setFrame: (NSRect) frame {
|
|
super.frame = frame;
|
|
|
|
mOwner.backend->Resize();
|
|
|
|
[super prepareContentInRect: [self visibleRect]];
|
|
}
|
|
|
|
//--------------------------------------------------------------------------------------------------
|
|
|
|
/**
|
|
* Called by the backend if a new cursor must be set for the view.
|
|
*/
|
|
- (void) setCursor: (int) cursor {
|
|
Window::Cursor eCursor = (Window::Cursor)cursor;
|
|
mCurrentCursor = cursorFromEnum(eCursor);
|
|
|
|
// Trigger recreation of the cursor rectangle(s).
|
|
[self.window invalidateCursorRectsForView: self];
|
|
[mOwner updateMarginCursors];
|
|
}
|
|
|
|
//--------------------------------------------------------------------------------------------------
|
|
|
|
/**
|
|
* This method is called to give us the opportunity to define our mouse sensitive rectangle.
|
|
*/
|
|
- (void) resetCursorRects {
|
|
[super resetCursorRects];
|
|
|
|
// We only have one cursor rect: our bounds.
|
|
const NSRect visibleBounds = mOwner.backend->GetBounds();
|
|
[self addCursorRect: visibleBounds cursor: mCurrentCursor];
|
|
[mCurrentCursor setOnMouseEntered: YES];
|
|
}
|
|
|
|
//--------------------------------------------------------------------------------------------------
|
|
|
|
/**
|
|
* Called before repainting.
|
|
*/
|
|
- (void) viewWillDraw {
|
|
if (!mOwner) {
|
|
[super viewWillDraw];
|
|
return;
|
|
}
|
|
|
|
const NSRect *rects;
|
|
NSInteger nRects = 0;
|
|
[self getRectsBeingDrawn: &rects count: &nRects];
|
|
if (nRects > 0) {
|
|
NSRect rectUnion = rects[0];
|
|
for (int i=0; i<nRects; i++) {
|
|
rectUnion = NSUnionRect(rectUnion, rects[i]);
|
|
}
|
|
mOwner.backend->WillDraw(rectUnion);
|
|
}
|
|
[super viewWillDraw];
|
|
}
|
|
|
|
//--------------------------------------------------------------------------------------------------
|
|
|
|
/**
|
|
* Called before responsive scrolling overdraw.
|
|
*/
|
|
- (void) prepareContentInRect: (NSRect) rect {
|
|
if (mOwner)
|
|
mOwner.backend->WillDraw(rect);
|
|
#if MAC_OS_X_VERSION_MAX_ALLOWED > 1080
|
|
[super prepareContentInRect: rect];
|
|
#endif
|
|
}
|
|
|
|
//--------------------------------------------------------------------------------------------------
|
|
|
|
/**
|
|
* Gets called by the runtime when the effective appearance changes.
|
|
*/
|
|
- (void) viewDidChangeEffectiveAppearance {
|
|
if (mOwner.backend) {
|
|
mOwner.backend->UpdateBaseElements();
|
|
}
|
|
}
|
|
|
|
//--------------------------------------------------------------------------------------------------
|
|
|
|
/**
|
|
* Gets called by the runtime when the view needs repainting.
|
|
*/
|
|
- (void) drawRect: (NSRect) rect {
|
|
CGContextRef context = (CGContextRef) [NSGraphicsContext currentContext].graphicsPort;
|
|
|
|
if (!mOwner.backend->Draw(rect, context)) {
|
|
dispatch_async(dispatch_get_main_queue(), ^ {
|
|
[self setNeedsDisplay: YES];
|
|
});
|
|
}
|
|
}
|
|
|
|
//--------------------------------------------------------------------------------------------------
|
|
|
|
/**
|
|
* Windows uses a client coordinate system where the upper left corner is the origin in a window
|
|
* (and so does Scintilla). We have to adjust for that. However by returning YES here, we are
|
|
* already done with that.
|
|
* Note that because of returning YES here most coordinates we use now (e.g. for painting,
|
|
* invalidating rectangles etc.) are given with +Y pointing down!
|
|
*/
|
|
- (BOOL) isFlipped {
|
|
return YES;
|
|
}
|
|
|
|
//--------------------------------------------------------------------------------------------------
|
|
|
|
- (BOOL) isOpaque {
|
|
return YES;
|
|
}
|
|
|
|
//--------------------------------------------------------------------------------------------------
|
|
|
|
/**
|
|
* Implement the "click through" behavior by telling the caller we accept the first mouse event too.
|
|
*/
|
|
- (BOOL) acceptsFirstMouse: (NSEvent *) theEvent {
|
|
#pragma unused(theEvent)
|
|
return YES;
|
|
}
|
|
|
|
//--------------------------------------------------------------------------------------------------
|
|
|
|
/**
|
|
* Make this view accepting events as first responder.
|
|
*/
|
|
- (BOOL) acceptsFirstResponder {
|
|
return YES;
|
|
}
|
|
|
|
//--------------------------------------------------------------------------------------------------
|
|
|
|
/**
|
|
* Called by the framework if it wants to show a context menu for the editor.
|
|
*/
|
|
- (NSMenu *) menuForEvent: (NSEvent *) theEvent {
|
|
NSMenu *menu = [mOwner menuForEvent: theEvent];
|
|
if (menu) {
|
|
return menu;
|
|
} else if (mOwner.backend->ShouldDisplayPopupOnText()) {
|
|
return mOwner.backend->CreateContextMenu(theEvent);
|
|
} else {
|
|
return nil;
|
|
}
|
|
}
|
|
|
|
//--------------------------------------------------------------------------------------------------
|
|
|
|
// Adoption of NSTextInputClient protocol.
|
|
|
|
- (NSAttributedString *) attributedSubstringForProposedRange: (NSRange) aRange actualRange: (NSRangePointer) actualRange {
|
|
const NSInteger lengthCharacters = self.accessibilityNumberOfCharacters;
|
|
if (aRange.location > lengthCharacters) {
|
|
return nil;
|
|
}
|
|
const NSRange posRange = mOwner.backend->PositionsFromCharacters(aRange);
|
|
// The backend validated aRange and may have removed characters beyond the end of the document.
|
|
const NSRange charRange = mOwner.backend->CharactersFromPositions(posRange);
|
|
if (!NSEqualRanges(aRange, charRange)) {
|
|
*actualRange = charRange;
|
|
}
|
|
|
|
[mOwner message: SCI_SETTARGETRANGE wParam: posRange.location lParam: NSMaxRange(posRange)];
|
|
std::string text([mOwner message: SCI_TARGETASUTF8], 0);
|
|
[mOwner message: SCI_TARGETASUTF8 wParam: 0 lParam: reinterpret_cast<sptr_t>(&text[0])];
|
|
text = FixInvalidUTF8(text);
|
|
NSString *result = @(text.c_str());
|
|
NSMutableAttributedString *asResult = [[NSMutableAttributedString alloc] initWithString: result];
|
|
|
|
const NSRange rangeAS = NSMakeRange(0, asResult.length);
|
|
// SCI_GETSTYLEAT reports a signed byte but want an unsigned to index into styles
|
|
const char styleByte = static_cast<char>([mOwner message: SCI_GETSTYLEAT wParam: posRange.location]);
|
|
const long style = static_cast<unsigned char>(styleByte);
|
|
std::string fontName([mOwner message: SCI_STYLEGETFONT wParam: style lParam: 0], 0);
|
|
[mOwner message: SCI_STYLEGETFONT wParam: style lParam: (sptr_t)&fontName[0]];
|
|
const CGFloat fontSize = [mOwner message: SCI_STYLEGETSIZEFRACTIONAL wParam: style] / 100.0f;
|
|
NSString *sFontName = @(fontName.c_str());
|
|
NSFont *font = [NSFont fontWithName: sFontName size: fontSize];
|
|
if (font) {
|
|
[asResult addAttribute: NSFontAttributeName value: font range: rangeAS];
|
|
}
|
|
|
|
return asResult;
|
|
}
|
|
|
|
//--------------------------------------------------------------------------------------------------
|
|
|
|
- (NSUInteger) characterIndexForPoint: (NSPoint) point {
|
|
const NSRect rectPoint = {point, NSZeroSize};
|
|
const NSRect rectInWindow = [self.window convertRectFromScreen: rectPoint];
|
|
const NSRect rectLocal = [self.superview.superview convertRect: rectInWindow fromView: nil];
|
|
|
|
const long position = [mOwner message: SCI_CHARPOSITIONFROMPOINT
|
|
wParam: rectLocal.origin.x
|
|
lParam: rectLocal.origin.y];
|
|
if (position == Sci::invalidPosition) {
|
|
return NSNotFound;
|
|
} else {
|
|
const NSRange index = mOwner.backend->CharactersFromPositions(NSMakeRange(position, 0));
|
|
return index.location;
|
|
}
|
|
}
|
|
|
|
//--------------------------------------------------------------------------------------------------
|
|
|
|
- (void) doCommandBySelector: (SEL) selector {
|
|
#pragma clang diagnostic push
|
|
#pragma clang diagnostic ignored "-Warc-performSelector-leaks"
|
|
if ([self respondsToSelector: selector])
|
|
[self performSelector: selector withObject: nil];
|
|
#pragma clang diagnostic pop
|
|
}
|
|
|
|
//--------------------------------------------------------------------------------------------------
|
|
|
|
- (NSRect) firstRectForCharacterRange: (NSRange) aRange actualRange: (NSRangePointer) actualRange {
|
|
#pragma unused(actualRange)
|
|
const NSRange posRange = mOwner.backend->PositionsFromCharacters(aRange);
|
|
|
|
NSRect rect;
|
|
rect.origin.x = [mOwner message: SCI_POINTXFROMPOSITION wParam: 0 lParam: posRange.location];
|
|
rect.origin.y = [mOwner message: SCI_POINTYFROMPOSITION wParam: 0 lParam: posRange.location];
|
|
const NSUInteger rangeEnd = NSMaxRange(posRange);
|
|
rect.size.width = [mOwner message: SCI_POINTXFROMPOSITION wParam: 0 lParam: rangeEnd] - rect.origin.x;
|
|
rect.size.height = [mOwner message: SCI_POINTYFROMPOSITION wParam: 0 lParam: rangeEnd] - rect.origin.y;
|
|
rect.size.height += [mOwner message: SCI_TEXTHEIGHT wParam: 0 lParam: 0];
|
|
const NSRect rectInWindow = [self.superview.superview convertRect: rect toView: nil];
|
|
const NSRect rectScreen = [self.window convertRectToScreen: rectInWindow];
|
|
|
|
return rectScreen;
|
|
}
|
|
|
|
//--------------------------------------------------------------------------------------------------
|
|
|
|
- (BOOL) hasMarkedText {
|
|
return mMarkedTextRange.length > 0;
|
|
}
|
|
|
|
//--------------------------------------------------------------------------------------------------
|
|
|
|
/**
|
|
* General text input. Used to insert new text at the current input position, replacing the current
|
|
* selection if there is any.
|
|
* First removes the replacementRange.
|
|
*/
|
|
- (void) insertText: (id) aString replacementRange: (NSRange) replacementRange {
|
|
if ((mMarkedTextRange.location != NSNotFound) && (replacementRange.location != NSNotFound)) {
|
|
NSLog(@"Trying to insertText when there is both a marked range and a replacement range");
|
|
}
|
|
|
|
// Remove any previously marked text first.
|
|
mOwner.backend->CompositionUndo();
|
|
if (mMarkedTextRange.location != NSNotFound) {
|
|
const NSRange posRangeMark = mOwner.backend->PositionsFromCharacters(mMarkedTextRange);
|
|
[mOwner message: SCI_SETEMPTYSELECTION wParam: posRangeMark.location];
|
|
}
|
|
mMarkedTextRange = NSMakeRange(NSNotFound, 0);
|
|
|
|
if (replacementRange.location == (NSNotFound-1))
|
|
// This occurs when the accent popup is visible and menu selected.
|
|
// Its replacing a non-existent position so do nothing.
|
|
return;
|
|
|
|
if (replacementRange.location != NSNotFound) {
|
|
const NSRange posRangeReplacement = mOwner.backend->PositionsFromCharacters(replacementRange);
|
|
[mOwner message: SCI_DELETERANGE
|
|
wParam: posRangeReplacement.location
|
|
lParam: posRangeReplacement.length];
|
|
[mOwner message: SCI_SETEMPTYSELECTION wParam: posRangeReplacement.location];
|
|
}
|
|
|
|
NSString *newText = @"";
|
|
if ([aString isKindOfClass: [NSString class]])
|
|
newText = (NSString *) aString;
|
|
else if ([aString isKindOfClass: [NSAttributedString class]])
|
|
newText = (NSString *) [aString string];
|
|
|
|
mOwner.backend->InsertText(newText, CharacterSource::DirectInput);
|
|
}
|
|
|
|
//--------------------------------------------------------------------------------------------------
|
|
|
|
- (NSRange) markedRange {
|
|
return mMarkedTextRange;
|
|
}
|
|
|
|
//--------------------------------------------------------------------------------------------------
|
|
|
|
- (NSRange) selectedRange {
|
|
const NSRange posRangeSel = [mOwner selectedRangePositions];
|
|
if (posRangeSel.length == 0) {
|
|
NSTextInputContext *tic = [NSTextInputContext currentInputContext];
|
|
// Chinese input causes malloc crash when empty selection returned with actual
|
|
// position so return NSNotFound.
|
|
// If this is applied to European input, it stops the accented character
|
|
// chooser from appearing.
|
|
// May need to add more input source names.
|
|
if ([tic.selectedKeyboardInputSource
|
|
isEqualToString: @"com.apple.inputmethod.TCIM.Cangjie"]) {
|
|
return NSMakeRange(NSNotFound, 0);
|
|
}
|
|
}
|
|
return mOwner.backend->CharactersFromPositions(posRangeSel);
|
|
}
|
|
|
|
//--------------------------------------------------------------------------------------------------
|
|
|
|
/**
|
|
* Called by the input manager to set text which might be combined with further input to form
|
|
* the final text (e.g. composition of ^ and a to â).
|
|
*
|
|
* @param aString The text to insert, either what has been marked already or what is selected already
|
|
* or simply added at the current insertion point. Depending on what is available.
|
|
* @param range The range of the new text to select (given relative to the insertion point of the new text).
|
|
* @param replacementRange The range to remove before insertion.
|
|
*/
|
|
- (void) setMarkedText: (id) aString selectedRange: (NSRange) range replacementRange: (NSRange) replacementRange {
|
|
NSString *newText = @"";
|
|
if ([aString isKindOfClass: [NSString class]])
|
|
newText = (NSString *) aString;
|
|
else if ([aString isKindOfClass: [NSAttributedString class]])
|
|
newText = (NSString *) [aString string];
|
|
|
|
// Replace marked text if there is one.
|
|
if (mMarkedTextRange.length > 0) {
|
|
mOwner.backend->CompositionUndo();
|
|
if (replacementRange.location != NSNotFound) {
|
|
// This situation makes no sense and has not occurred in practice.
|
|
NSLog(@"Can not handle a replacement range when there is also a marked range");
|
|
} else {
|
|
replacementRange = mMarkedTextRange;
|
|
const NSRange posRangeMark = mOwner.backend->PositionsFromCharacters(mMarkedTextRange);
|
|
[mOwner message: SCI_SETEMPTYSELECTION wParam: posRangeMark.location];
|
|
}
|
|
} else {
|
|
// Must perform deletion before entering composition mode or else
|
|
// both document and undo history will not contain the deleted text
|
|
// leading to an inaccurate and unusable undo history.
|
|
|
|
// Convert selection virtual space into real space
|
|
mOwner.backend->ConvertSelectionVirtualSpace();
|
|
|
|
if (replacementRange.location != NSNotFound) {
|
|
const NSRange posRangeReplacement = mOwner.backend->PositionsFromCharacters(replacementRange);
|
|
[mOwner message: SCI_DELETERANGE
|
|
wParam: posRangeReplacement.location
|
|
lParam: posRangeReplacement.length];
|
|
} else { // No marked or replacement range, so replace selection
|
|
if (!mOwner.backend->ScintillaCocoa::ClearAllSelections()) {
|
|
// Some of the selection is protected so can not perform composition here
|
|
return;
|
|
}
|
|
// Ensure only a single selection.
|
|
mOwner.backend->SelectOnlyMainSelection();
|
|
const NSRange posRangeSel = [mOwner selectedRangePositions];
|
|
replacementRange = mOwner.backend->CharactersFromPositions(posRangeSel);
|
|
}
|
|
}
|
|
|
|
// To support IME input to multiple selections, the following code would
|
|
// need to insert newText at each selection, mark each piece of new text and then
|
|
// select range relative to each insertion.
|
|
|
|
if (newText.length) {
|
|
// Switching into composition.
|
|
mOwner.backend->CompositionStart();
|
|
|
|
NSRange posRangeCurrent = mOwner.backend->PositionsFromCharacters(NSMakeRange(replacementRange.location, 0));
|
|
// Note: Scintilla internally works almost always with bytes instead chars, so we need to take
|
|
// this into account when determining selection ranges and such.
|
|
ptrdiff_t lengthInserted = mOwner.backend->InsertText(newText, CharacterSource::TentativeInput);
|
|
posRangeCurrent.length = lengthInserted;
|
|
mMarkedTextRange = mOwner.backend->CharactersFromPositions(posRangeCurrent);
|
|
// Mark the just inserted text. Keep the marked range for later reset.
|
|
[mOwner setGeneralProperty: SCI_SETINDICATORCURRENT value: INDICATOR_IME];
|
|
[mOwner setGeneralProperty: SCI_INDICATORFILLRANGE
|
|
parameter: posRangeCurrent.location
|
|
value: posRangeCurrent.length];
|
|
} else {
|
|
mMarkedTextRange = NSMakeRange(NSNotFound, 0);
|
|
// Re-enable undo action collection if composition ended (indicated by an empty mark string).
|
|
mOwner.backend->CompositionCommit();
|
|
}
|
|
|
|
// Select the part which is indicated in the given range. It does not scroll the caret into view.
|
|
if (range.length > 0) {
|
|
// range is in characters so convert to bytes for selection.
|
|
range.location += replacementRange.location;
|
|
NSRange posRangeSelect = mOwner.backend->PositionsFromCharacters(range);
|
|
[mOwner setGeneralProperty: SCI_SETSELECTION parameter: NSMaxRange(posRangeSelect) value: posRangeSelect.location];
|
|
}
|
|
}
|
|
|
|
//--------------------------------------------------------------------------------------------------
|
|
|
|
- (void) unmarkText {
|
|
if (mMarkedTextRange.length > 0) {
|
|
mOwner.backend->CompositionCommit();
|
|
mMarkedTextRange = NSMakeRange(NSNotFound, 0);
|
|
}
|
|
}
|
|
|
|
//--------------------------------------------------------------------------------------------------
|
|
|
|
- (NSArray *) validAttributesForMarkedText {
|
|
return @[];
|
|
}
|
|
|
|
// End of the NSTextInputClient protocol adoption.
|
|
|
|
//--------------------------------------------------------------------------------------------------
|
|
|
|
/**
|
|
* Generic input method. It is used to pass on keyboard input to Scintilla. The control itself only
|
|
* handles shortcuts. The input is then forwarded to the Cocoa text input system, which in turn does
|
|
* its own input handling (character composition via NSTextInputClient protocol):
|
|
*/
|
|
- (void) keyDown: (NSEvent *) theEvent {
|
|
bool handled = false;
|
|
if (mMarkedTextRange.length == 0)
|
|
handled = mOwner.backend->KeyboardInput(theEvent);
|
|
if (!handled) {
|
|
NSArray *events = @[theEvent];
|
|
[self interpretKeyEvents: events];
|
|
}
|
|
}
|
|
|
|
//--------------------------------------------------------------------------------------------------
|
|
|
|
- (void) mouseDown: (NSEvent *) theEvent {
|
|
mOwner.backend->MouseDown(theEvent);
|
|
}
|
|
|
|
//--------------------------------------------------------------------------------------------------
|
|
|
|
- (void) mouseDragged: (NSEvent *) theEvent {
|
|
mOwner.backend->MouseMove(theEvent);
|
|
}
|
|
|
|
//--------------------------------------------------------------------------------------------------
|
|
|
|
- (void) mouseUp: (NSEvent *) theEvent {
|
|
mOwner.backend->MouseUp(theEvent);
|
|
}
|
|
|
|
//--------------------------------------------------------------------------------------------------
|
|
|
|
- (void) mouseMoved: (NSEvent *) theEvent {
|
|
mOwner.backend->MouseMove(theEvent);
|
|
}
|
|
|
|
//--------------------------------------------------------------------------------------------------
|
|
|
|
- (void) mouseEntered: (NSEvent *) theEvent {
|
|
mOwner.backend->MouseEntered(theEvent);
|
|
}
|
|
|
|
//--------------------------------------------------------------------------------------------------
|
|
|
|
- (void) mouseExited: (NSEvent *) theEvent {
|
|
mOwner.backend->MouseExited(theEvent);
|
|
}
|
|
|
|
//--------------------------------------------------------------------------------------------------
|
|
|
|
/**
|
|
* Implementing scrollWheel makes scrolling work better even if just
|
|
* calling super.
|
|
* Mouse wheel with command key may magnify text if enabled.
|
|
* Pinch gestures and key commands can also be used for magnification.
|
|
*/
|
|
- (void) scrollWheel: (NSEvent *) theEvent {
|
|
#ifdef SCROLL_WHEEL_MAGNIFICATION
|
|
if (([theEvent modifierFlags] & NSEventModifierFlagCommand) != 0) {
|
|
mOwner.backend->MouseWheel(theEvent);
|
|
return;
|
|
}
|
|
#endif
|
|
[super scrollWheel: theEvent];
|
|
}
|
|
|
|
//--------------------------------------------------------------------------------------------------
|
|
|
|
/**
|
|
* Ensure scrolling is aligned to whole lines instead of starting part-way through a line
|
|
*/
|
|
- (NSRect) adjustScroll: (NSRect) proposedVisibleRect {
|
|
if (!mOwner)
|
|
return proposedVisibleRect;
|
|
NSRect rc = proposedVisibleRect;
|
|
// Snap to lines
|
|
NSRect contentRect = self.bounds;
|
|
if ((rc.origin.y > 0) && (NSMaxY(rc) < contentRect.size.height)) {
|
|
// Only snap for positions inside the document - allow outside
|
|
// for overshoot.
|
|
long lineHeight = mOwner.backend->WndProc(Message::TextHeight, 0, 0);
|
|
rc.origin.y = std::round(static_cast<XYPOSITION>(rc.origin.y) / lineHeight) * lineHeight;
|
|
}
|
|
// Snap to whole points - on retina displays this avoids visual debris
|
|
// when scrolling horizontally.
|
|
if ((rc.origin.x > 0) && (NSMaxX(rc) < contentRect.size.width)) {
|
|
// Only snap for positions inside the document - allow outside
|
|
// for overshoot.
|
|
rc.origin.x = std::round(static_cast<XYPOSITION>(rc.origin.x));
|
|
}
|
|
return rc;
|
|
}
|
|
|
|
//--------------------------------------------------------------------------------------------------
|
|
|
|
/**
|
|
* The editor is getting the foreground control (the one getting the input focus).
|
|
*/
|
|
- (BOOL) becomeFirstResponder {
|
|
mOwner.backend->SetFirstResponder(true);
|
|
return YES;
|
|
}
|
|
|
|
//--------------------------------------------------------------------------------------------------
|
|
|
|
/**
|
|
* The editor is losing the input focus.
|
|
*/
|
|
- (BOOL) resignFirstResponder {
|
|
mOwner.backend->SetFirstResponder(false);
|
|
return YES;
|
|
}
|
|
|
|
//--------------------------------------------------------------------------------------------------
|
|
|
|
/**
|
|
* Implement NSDraggingSource.
|
|
*/
|
|
|
|
- (NSDragOperation) draggingSession: (NSDraggingSession *) session
|
|
sourceOperationMaskForDraggingContext: (NSDraggingContext) context {
|
|
#pragma unused(session)
|
|
switch (context) {
|
|
case NSDraggingContextOutsideApplication:
|
|
return NSDragOperationCopy | NSDragOperationMove | NSDragOperationDelete;
|
|
|
|
case NSDraggingContextWithinApplication:
|
|
default:
|
|
return NSDragOperationCopy | NSDragOperationMove | NSDragOperationDelete;
|
|
}
|
|
}
|
|
|
|
- (void) draggingSession: (NSDraggingSession *) session
|
|
movedToPoint: (NSPoint) screenPoint {
|
|
#pragma unused(session, screenPoint)
|
|
}
|
|
|
|
- (void) draggingSession: (NSDraggingSession *) session
|
|
endedAtPoint: (NSPoint) screenPoint
|
|
operation: (NSDragOperation) operation {
|
|
#pragma unused(session, screenPoint)
|
|
if (operation == NSDragOperationDelete) {
|
|
mOwner.backend->WndProc(Message::Clear, 0, 0);
|
|
}
|
|
}
|
|
|
|
/**
|
|
* Implement NSDraggingDestination.
|
|
*/
|
|
|
|
//--------------------------------------------------------------------------------------------------
|
|
|
|
/**
|
|
* Called when an external drag operation enters the view.
|
|
*/
|
|
- (NSDragOperation) draggingEntered: (id <NSDraggingInfo>) sender {
|
|
return mOwner.backend->DraggingEntered(sender);
|
|
}
|
|
|
|
//--------------------------------------------------------------------------------------------------
|
|
|
|
/**
|
|
* Called frequently during an external drag operation if we are the target.
|
|
*/
|
|
- (NSDragOperation) draggingUpdated: (id <NSDraggingInfo>) sender {
|
|
return mOwner.backend->DraggingUpdated(sender);
|
|
}
|
|
|
|
//--------------------------------------------------------------------------------------------------
|
|
|
|
/**
|
|
* Drag image left the view. Clean up if necessary.
|
|
*/
|
|
- (void) draggingExited: (id <NSDraggingInfo>) sender {
|
|
mOwner.backend->DraggingExited(sender);
|
|
}
|
|
|
|
//--------------------------------------------------------------------------------------------------
|
|
|
|
- (BOOL) prepareForDragOperation: (id <NSDraggingInfo>) sender {
|
|
#pragma unused(sender)
|
|
return YES;
|
|
}
|
|
|
|
//--------------------------------------------------------------------------------------------------
|
|
|
|
- (BOOL) performDragOperation: (id <NSDraggingInfo>) sender {
|
|
return mOwner.backend->PerformDragOperation(sender);
|
|
}
|
|
|
|
//--------------------------------------------------------------------------------------------------
|
|
|
|
/**
|
|
* Drag operation is done. Notify editor.
|
|
*/
|
|
- (void) concludeDragOperation: (id <NSDraggingInfo>) sender {
|
|
// Clean up is the same as if we are no longer the drag target.
|
|
mOwner.backend->DraggingExited(sender);
|
|
}
|
|
|
|
//--------------------------------------------------------------------------------------------------
|
|
|
|
// NSResponder actions.
|
|
|
|
- (void) selectAll: (id) sender {
|
|
#pragma unused(sender)
|
|
mOwner.backend->SelectAll();
|
|
}
|
|
|
|
- (void) deleteBackward: (id) sender {
|
|
#pragma unused(sender)
|
|
mOwner.backend->DeleteBackward();
|
|
}
|
|
|
|
- (void) cut: (id) sender {
|
|
#pragma unused(sender)
|
|
mOwner.backend->Cut();
|
|
}
|
|
|
|
- (void) copy: (id) sender {
|
|
#pragma unused(sender)
|
|
mOwner.backend->Copy();
|
|
}
|
|
|
|
- (void) paste: (id) sender {
|
|
#pragma unused(sender)
|
|
if (mMarkedTextRange.location != NSNotFound) {
|
|
[[NSTextInputContext currentInputContext] discardMarkedText];
|
|
mOwner.backend->CompositionCommit();
|
|
mMarkedTextRange = NSMakeRange(NSNotFound, 0);
|
|
}
|
|
mOwner.backend->Paste();
|
|
}
|
|
|
|
- (void) undo: (id) sender {
|
|
#pragma unused(sender)
|
|
if (mMarkedTextRange.location != NSNotFound) {
|
|
[[NSTextInputContext currentInputContext] discardMarkedText];
|
|
mOwner.backend->CompositionCommit();
|
|
mMarkedTextRange = NSMakeRange(NSNotFound, 0);
|
|
}
|
|
mOwner.backend->Undo();
|
|
}
|
|
|
|
- (void) redo: (id) sender {
|
|
#pragma unused(sender)
|
|
mOwner.backend->Redo();
|
|
}
|
|
|
|
- (BOOL) canUndo {
|
|
return mOwner.backend->CanUndo() && (mMarkedTextRange.location == NSNotFound);
|
|
}
|
|
|
|
- (BOOL) canRedo {
|
|
return mOwner.backend->CanRedo();
|
|
}
|
|
|
|
- (BOOL) validateUserInterfaceItem: (id <NSValidatedUserInterfaceItem>) anItem {
|
|
SEL action = anItem.action;
|
|
if (action==@selector(undo:)) {
|
|
return [self canUndo];
|
|
} else if (action==@selector(redo:)) {
|
|
return [self canRedo];
|
|
} else if (action==@selector(cut:) || action==@selector(copy:) || action==@selector(clear:)) {
|
|
return mOwner.backend->HasSelection();
|
|
} else if (action==@selector(paste:)) {
|
|
return mOwner.backend->CanPaste();
|
|
}
|
|
return YES;
|
|
}
|
|
|
|
- (void) clear: (id) sender {
|
|
[self deleteBackward: sender];
|
|
}
|
|
|
|
- (BOOL) isEditable {
|
|
return mOwner.backend->WndProc(Message::GetReadOnly, 0, 0) == 0;
|
|
}
|
|
|
|
#pragma mark - NSAccessibility
|
|
|
|
//--------------------------------------------------------------------------------------------------
|
|
|
|
// Adoption of NSAccessibility protocol.
|
|
// NSAccessibility wants to pass ranges in UTF-16 code units, not bytes (like Scintilla)
|
|
// or characters.
|
|
// Needs more testing with non-ASCII and non-BMP text.
|
|
// Needs to take account of folding and wraping.
|
|
|
|
//--------------------------------------------------------------------------------------------------
|
|
|
|
/**
|
|
* NSAccessibility : Text of the whole document as a string.
|
|
*/
|
|
- (id) accessibilityValue {
|
|
const sptr_t length = [mOwner message: SCI_GETLENGTH];
|
|
return mOwner.backend->RangeTextAsString(NSMakeRange(0, length));
|
|
}
|
|
|
|
//--------------------------------------------------------------------------------------------------
|
|
|
|
/**
|
|
* NSAccessibility : Line of the caret.
|
|
*/
|
|
- (NSInteger) accessibilityInsertionPointLineNumber {
|
|
const Sci::Position caret = [mOwner message: SCI_GETCURRENTPOS];
|
|
const NSRange rangeCharactersCaret = mOwner.backend->CharactersFromPositions(NSMakeRange(caret, 0));
|
|
return mOwner.backend->VisibleLineForIndex(rangeCharactersCaret.location);
|
|
}
|
|
|
|
//--------------------------------------------------------------------------------------------------
|
|
|
|
/**
|
|
* NSAccessibility : Not implemented and not called by VoiceOver.
|
|
*/
|
|
- (NSRange) accessibilityRangeForPosition: (NSPoint) point {
|
|
return NSMakeRange(0, 0);
|
|
}
|
|
|
|
//--------------------------------------------------------------------------------------------------
|
|
|
|
/**
|
|
* NSAccessibility : Number of characters in the whole document.
|
|
*/
|
|
- (NSInteger) accessibilityNumberOfCharacters {
|
|
sptr_t length = [mOwner message: SCI_GETLENGTH];
|
|
const NSRange posRange = mOwner.backend->CharactersFromPositions(NSMakeRange(length, 0));
|
|
return posRange.location;
|
|
}
|
|
|
|
//--------------------------------------------------------------------------------------------------
|
|
|
|
/**
|
|
* NSAccessibility : The selection text as a string.
|
|
*/
|
|
- (NSString *) accessibilitySelectedText {
|
|
const sptr_t positionBegin = [mOwner message: SCI_GETSELECTIONSTART];
|
|
const sptr_t positionEnd = [mOwner message: SCI_GETSELECTIONEND];
|
|
const NSRange posRangeSel = NSMakeRange(positionBegin, positionEnd-positionBegin);
|
|
return mOwner.backend->RangeTextAsString(posRangeSel);
|
|
}
|
|
|
|
//--------------------------------------------------------------------------------------------------
|
|
|
|
/**
|
|
* NSAccessibility : The character range of the main selection.
|
|
*/
|
|
- (NSRange) accessibilitySelectedTextRange {
|
|
const sptr_t positionBegin = [mOwner message: SCI_GETSELECTIONSTART];
|
|
const sptr_t positionEnd = [mOwner message: SCI_GETSELECTIONEND];
|
|
const NSRange posRangeSel = NSMakeRange(positionBegin, positionEnd-positionBegin);
|
|
return mOwner.backend->CharactersFromPositions(posRangeSel);
|
|
}
|
|
|
|
//--------------------------------------------------------------------------------------------------
|
|
|
|
/**
|
|
* NSAccessibility : The setter for accessibilitySelectedTextRange.
|
|
* This method is the only setter required for reasonable VoiceOver behaviour.
|
|
*/
|
|
- (void) setAccessibilitySelectedTextRange: (NSRange) range {
|
|
NSRange rangePositions = mOwner.backend->PositionsFromCharacters(range);
|
|
[mOwner message: SCI_SETSELECTION wParam: rangePositions.location lParam: NSMaxRange(rangePositions)];
|
|
}
|
|
|
|
//--------------------------------------------------------------------------------------------------
|
|
|
|
/**
|
|
* NSAccessibility : Range of the glyph at a character index.
|
|
* Currently doesn't try to handle composite characters.
|
|
*/
|
|
- (NSRange) accessibilityRangeForIndex: (NSInteger) index {
|
|
sptr_t length = [mOwner message: SCI_GETLENGTH];
|
|
const NSRange rangeLength = mOwner.backend->CharactersFromPositions(NSMakeRange(length, 0));
|
|
NSRange rangePositions = NSMakeRange(length, 0);
|
|
if (index < rangeLength.location) {
|
|
rangePositions = mOwner.backend->PositionsFromCharacters(NSMakeRange(index, 1));
|
|
}
|
|
return mOwner.backend->CharactersFromPositions(rangePositions);
|
|
}
|
|
|
|
//--------------------------------------------------------------------------------------------------
|
|
|
|
/**
|
|
* NSAccessibility : All the text ranges.
|
|
* Currently only returns the main selection.
|
|
*/
|
|
- (NSArray<NSValue *> *) accessibilitySelectedTextRanges {
|
|
const sptr_t positionBegin = [mOwner message: SCI_GETSELECTIONSTART];
|
|
const sptr_t positionEnd = [mOwner message: SCI_GETSELECTIONEND];
|
|
const NSRange posRangeSel = NSMakeRange(positionBegin, positionEnd-positionBegin);
|
|
NSRange rangeCharacters = mOwner.backend->CharactersFromPositions(posRangeSel);
|
|
NSValue *valueRange = [NSValue valueWithRange: (NSRange)rangeCharacters];
|
|
return @[valueRange];
|
|
}
|
|
|
|
//--------------------------------------------------------------------------------------------------
|
|
|
|
/**
|
|
* NSAccessibility : Character range currently visible.
|
|
*/
|
|
- (NSRange) accessibilityVisibleCharacterRange {
|
|
const sptr_t lineTopVisible = [mOwner message: SCI_GETFIRSTVISIBLELINE];
|
|
const sptr_t lineTop = [mOwner message: SCI_DOCLINEFROMVISIBLE wParam: lineTopVisible];
|
|
const sptr_t lineEndVisible = lineTopVisible + [mOwner message: SCI_LINESONSCREEN] - 1;
|
|
const sptr_t lineEnd = [mOwner message: SCI_DOCLINEFROMVISIBLE wParam: lineEndVisible];
|
|
const sptr_t posStartView = [mOwner message: SCI_POSITIONFROMLINE wParam: lineTop];
|
|
const sptr_t posEndView = [mOwner message: SCI_GETLINEENDPOSITION wParam: lineEnd];
|
|
const NSRange posRangeSel = NSMakeRange(posStartView, posEndView-posStartView);
|
|
return mOwner.backend->CharactersFromPositions(posRangeSel);
|
|
}
|
|
|
|
//--------------------------------------------------------------------------------------------------
|
|
|
|
/**
|
|
* NSAccessibility : Character range of a line.
|
|
*/
|
|
- (NSRange) accessibilityRangeForLine: (NSInteger) line {
|
|
return mOwner.backend->RangeForVisibleLine(line);
|
|
}
|
|
|
|
//--------------------------------------------------------------------------------------------------
|
|
|
|
/**
|
|
* NSAccessibility : Line number of a text position in characters.
|
|
*/
|
|
- (NSInteger) accessibilityLineForIndex: (NSInteger) index {
|
|
return mOwner.backend->VisibleLineForIndex(index);
|
|
}
|
|
|
|
//--------------------------------------------------------------------------------------------------
|
|
|
|
/**
|
|
* NSAccessibility : A rectangle that covers a range which will be shown as the
|
|
* VoiceOver cursor.
|
|
* Producing a nice rectangle is a little tricky particularly when including new
|
|
* lines. Needs to improve the case where parts of two lines are included.
|
|
*/
|
|
- (NSRect) accessibilityFrameForRange: (NSRange) range {
|
|
const NSRect rectInView = mOwner.backend->FrameForRange(range);
|
|
const NSRect rectInWindow = [self.superview.superview convertRect: rectInView toView: nil];
|
|
return [self.window convertRectToScreen: rectInWindow];
|
|
}
|
|
|
|
//--------------------------------------------------------------------------------------------------
|
|
|
|
/**
|
|
* NSAccessibility : A range of text as a string.
|
|
*/
|
|
- (NSString *) accessibilityStringForRange: (NSRange) range {
|
|
const NSRange posRange = mOwner.backend->PositionsFromCharacters(range);
|
|
return mOwner.backend->RangeTextAsString(posRange);
|
|
}
|
|
|
|
//--------------------------------------------------------------------------------------------------
|
|
|
|
/**
|
|
* NSAccessibility : A range of text as an attributed string.
|
|
* Currently no attributes are set.
|
|
*/
|
|
- (NSAttributedString *) accessibilityAttributedStringForRange: (NSRange) range {
|
|
const NSRange posRange = mOwner.backend->PositionsFromCharacters(range);
|
|
NSString *result = mOwner.backend->RangeTextAsString(posRange);
|
|
return [[NSMutableAttributedString alloc] initWithString: result];
|
|
}
|
|
|
|
//--------------------------------------------------------------------------------------------------
|
|
|
|
/**
|
|
* NSAccessibility : Show the context menu at the caret.
|
|
*/
|
|
- (BOOL) accessibilityPerformShowMenu {
|
|
const sptr_t caret = [mOwner message: SCI_GETCURRENTPOS];
|
|
NSRect rect;
|
|
rect.origin.x = [mOwner message: SCI_POINTXFROMPOSITION wParam: 0 lParam: caret];
|
|
rect.origin.y = [mOwner message: SCI_POINTYFROMPOSITION wParam: 0 lParam: caret];
|
|
rect.origin.y += [mOwner message: SCI_TEXTHEIGHT wParam: 0 lParam: 0];
|
|
rect.size.width = 1.0;
|
|
rect.size.height = 1.0;
|
|
NSRect rectInWindow = [self.superview.superview convertRect: rect toView: nil];
|
|
NSPoint pt = rectInWindow.origin;
|
|
NSEvent *event = [NSEvent mouseEventWithType: NSEventTypeRightMouseDown
|
|
location: pt
|
|
modifierFlags: 0
|
|
timestamp: 0
|
|
windowNumber: self.window.windowNumber
|
|
context: nil
|
|
eventNumber: 0
|
|
clickCount: 1
|
|
pressure: 0.0];
|
|
NSMenu *menu = mOwner.backend->CreateContextMenu(event);
|
|
[NSMenu popUpContextMenu: menu withEvent: event forView: self];
|
|
return YES;
|
|
}
|
|
|
|
//--------------------------------------------------------------------------------------------------
|
|
|
|
|
|
@end
|
|
|
|
//--------------------------------------------------------------------------------------------------
|
|
|
|
@implementation ScintillaView {
|
|
// The back end is kind of a controller and model in one.
|
|
// It uses the content view for display.
|
|
Scintilla::Internal::ScintillaCocoa *mBackend;
|
|
|
|
// This is the actual content to which the backend renders itself.
|
|
SCIContentView *mContent;
|
|
|
|
NSScrollView *scrollView;
|
|
SCIMarginView *marginView;
|
|
|
|
CGFloat zoomDelta;
|
|
|
|
// Area to display additional controls (e.g. zoom info, caret position, status info).
|
|
NSView <InfoBarCommunicator> *mInfoBar;
|
|
BOOL mInfoBarAtTop;
|
|
|
|
id<ScintillaNotificationProtocol> __unsafe_unretained mDelegate;
|
|
}
|
|
|
|
@synthesize backend = mBackend;
|
|
@synthesize delegate = mDelegate;
|
|
@synthesize scrollView;
|
|
|
|
/**
|
|
* ScintillaView is a composite control made from an NSView and an embedded NSView that is
|
|
* used as canvas for the output (by the backend, using its CGContext), plus other elements
|
|
* (scrollers, info bar).
|
|
*/
|
|
|
|
//--------------------------------------------------------------------------------------------------
|
|
|
|
/**
|
|
* Initialize custom cursor.
|
|
*/
|
|
+ (void) initialize {
|
|
if (self == [ScintillaView class]) {
|
|
NSBundle *bundle = [NSBundle bundleForClass: [ScintillaView class]];
|
|
|
|
NSString *path = [bundle pathForResource: @"mac_cursor_busy" ofType: @"tiff" inDirectory: nil];
|
|
NSImage *image = [[NSImage alloc] initWithContentsOfFile: path];
|
|
if (image) {
|
|
waitCursor = [[NSCursor alloc] initWithImage: image hotSpot: NSMakePoint(2, 2)];
|
|
} else {
|
|
NSLog(@"Wait cursor is invalid.");
|
|
waitCursor = [NSCursor arrowCursor];
|
|
}
|
|
|
|
path = [bundle pathForResource: @"mac_cursor_flipped" ofType: @"tiff" inDirectory: nil];
|
|
image = [[NSImage alloc] initWithContentsOfFile: path];
|
|
if (image) {
|
|
reverseArrowCursor = [[NSCursor alloc] initWithImage: image hotSpot: NSMakePoint(15, 2)];
|
|
} else {
|
|
NSLog(@"Reverse arrow cursor is invalid.");
|
|
reverseArrowCursor = [NSCursor arrowCursor];
|
|
}
|
|
}
|
|
}
|
|
|
|
//--------------------------------------------------------------------------------------------------
|
|
|
|
/**
|
|
* Specify the SCIContentView class. Can be overridden in a subclass to provide an SCIContentView subclass.
|
|
*/
|
|
|
|
+ (Class) contentViewClass {
|
|
return [SCIContentView class];
|
|
}
|
|
|
|
//--------------------------------------------------------------------------------------------------
|
|
|
|
/**
|
|
* Receives zoom messages, for example when a "pinch zoom" is performed on the trackpad.
|
|
*/
|
|
- (void) magnifyWithEvent: (NSEvent *) event {
|
|
#if MAC_OS_X_VERSION_MAX_ALLOWED > MAC_OS_X_VERSION_10_5
|
|
zoomDelta += event.magnification * 10.0;
|
|
|
|
if (std::abs(zoomDelta)>=1.0) {
|
|
long zoomFactor = static_cast<long>([self getGeneralProperty: SCI_GETZOOM] + zoomDelta);
|
|
[self setGeneralProperty: SCI_SETZOOM parameter: zoomFactor value: 0];
|
|
zoomDelta = 0.0;
|
|
}
|
|
#endif
|
|
}
|
|
|
|
- (void) beginGestureWithEvent: (NSEvent *) event {
|
|
// Scintilla is only interested in this event as the starft of a zoom
|
|
#pragma unused(event)
|
|
zoomDelta = 0.0;
|
|
}
|
|
|
|
//--------------------------------------------------------------------------------------------------
|
|
|
|
/**
|
|
* Sends a new notification of the given type to the default notification center.
|
|
*/
|
|
- (void) sendNotification: (NSString *) notificationName {
|
|
NSNotificationCenter *center = [NSNotificationCenter defaultCenter];
|
|
[center postNotificationName: notificationName object: self];
|
|
}
|
|
|
|
//--------------------------------------------------------------------------------------------------
|
|
|
|
/**
|
|
* Called by a connected component (usually the info bar) if something changed there.
|
|
*
|
|
* @param type The type of the notification.
|
|
* @param message Carries the new status message if the type is a status message change.
|
|
* @param location Carries the new location (e.g. caret) if the type is a caret change or similar type.
|
|
* @param value Carries the new zoom value if the type is a zoom change.
|
|
*/
|
|
- (void) notify: (NotificationType) type message: (NSString *) message location: (NSPoint) location
|
|
value: (float) value {
|
|
// These parameters are just to conform to the protocol
|
|
#pragma unused(message)
|
|
#pragma unused(location)
|
|
switch (type) {
|
|
case IBNZoomChanged: {
|
|
// Compute point increase/decrease based on default font size.
|
|
long fontSize = [self getGeneralProperty: SCI_STYLEGETSIZE parameter: STYLE_DEFAULT];
|
|
int zoom = (int)(fontSize * (value - 1));
|
|
[self setGeneralProperty: SCI_SETZOOM value: zoom];
|
|
break;
|
|
}
|
|
default:
|
|
break;
|
|
};
|
|
}
|
|
|
|
//--------------------------------------------------------------------------------------------------
|
|
|
|
- (void) setCallback: (id <InfoBarCommunicator>) callback {
|
|
// Not used. Only here to satisfy protocol.
|
|
#pragma unused(callback)
|
|
}
|
|
|
|
//--------------------------------------------------------------------------------------------------
|
|
|
|
/**
|
|
* Prevents drawing of the inner view to avoid flickering when doing many visual updates
|
|
* (like clearing all marks and setting new ones etc.).
|
|
*/
|
|
- (void) suspendDrawing: (BOOL) suspend {
|
|
if (suspend)
|
|
[self.window disableFlushWindow];
|
|
else
|
|
[self.window enableFlushWindow];
|
|
}
|
|
|
|
//--------------------------------------------------------------------------------------------------
|
|
|
|
/**
|
|
* Method receives notifications from Scintilla (e.g. for handling clicks on the
|
|
* folder margin or changes in the editor).
|
|
* A delegate can be set to receive all notifications. If set no handling takes place here, except
|
|
* for action pertaining to internal stuff (like the info bar).
|
|
*/
|
|
- (void) notification: (SCNotification *) scn {
|
|
// Parent notification. Details are passed as SCNotification structure.
|
|
|
|
if (mDelegate != nil) {
|
|
[mDelegate notification: scn];
|
|
if (scn->nmhdr.code != static_cast<unsigned int>(Notification::Zoom) &&
|
|
scn->nmhdr.code != static_cast<unsigned int>(Notification::UpdateUI))
|
|
return;
|
|
}
|
|
|
|
switch (static_cast<Notification>(scn->nmhdr.code)) {
|
|
case Notification::MarginClick: {
|
|
if (scn->margin == 2) {
|
|
// Click on the folder margin. Toggle the current line if possible.
|
|
long line = [self getGeneralProperty: SCI_LINEFROMPOSITION parameter: scn->position];
|
|
[self setGeneralProperty: SCI_TOGGLEFOLD value: line];
|
|
}
|
|
break;
|
|
};
|
|
case Notification::Modified: {
|
|
// Decide depending on the modification type what to do.
|
|
// There can be more than one modification carried by one notification.
|
|
if (scn->modificationType &
|
|
static_cast<int>((ModificationFlags::InsertText | ModificationFlags::DeleteText)))
|
|
[self sendNotification: NSTextDidChangeNotification];
|
|
break;
|
|
}
|
|
case Notification::Zoom: {
|
|
// A zoom change happened. Notify info bar if there is one.
|
|
float zoom = [self getGeneralProperty: SCI_GETZOOM parameter: 0];
|
|
long fontSize = [self getGeneralProperty: SCI_STYLEGETSIZE parameter: STYLE_DEFAULT];
|
|
float factor = (zoom / fontSize) + 1;
|
|
[mInfoBar notify: IBNZoomChanged message: nil location: NSZeroPoint value: factor];
|
|
break;
|
|
}
|
|
case Notification::UpdateUI: {
|
|
// Triggered whenever changes in the UI state need to be reflected.
|
|
// These can be: caret changes, selection changes etc.
|
|
NSPoint caretPosition = mBackend->GetCaretPosition();
|
|
[mInfoBar notify: IBNCaretChanged message: nil location: caretPosition value: 0];
|
|
[self sendNotification: SCIUpdateUINotification];
|
|
if (scn->updated & static_cast<int>((Update::Selection | Update::Content))) {
|
|
[self sendNotification: NSTextViewDidChangeSelectionNotification];
|
|
}
|
|
break;
|
|
}
|
|
case Notification::FocusOut:
|
|
[self sendNotification: NSTextDidEndEditingNotification];
|
|
break;
|
|
case Notification::FocusIn: // Nothing to do for now.
|
|
break;
|
|
default:
|
|
break;
|
|
}
|
|
}
|
|
|
|
//--------------------------------------------------------------------------------------------------
|
|
|
|
/**
|
|
* Setup a special indicator used in the editor to provide visual feedback for
|
|
* input composition, depending on language, keyboard etc.
|
|
*/
|
|
- (void) updateIndicatorIME {
|
|
[self setColorProperty: SCI_INDICSETFORE parameter: INDICATOR_IME fromHTML: @"#FF0000"];
|
|
const bool drawInBackground = [self message: SCI_GETPHASESDRAW] != 0;
|
|
[self setGeneralProperty: SCI_INDICSETUNDER parameter: INDICATOR_IME value: drawInBackground];
|
|
[self setGeneralProperty: SCI_INDICSETSTYLE parameter: INDICATOR_IME value: INDIC_PLAIN];
|
|
[self setGeneralProperty: SCI_INDICSETALPHA parameter: INDICATOR_IME value: 100];
|
|
}
|
|
|
|
//--------------------------------------------------------------------------------------------------
|
|
|
|
/**
|
|
* Initialization of the view. Used to setup a few other things we need.
|
|
*/
|
|
- (instancetype) initWithFrame: (NSRect) frame {
|
|
self = [super initWithFrame: frame];
|
|
if (self) {
|
|
mContent = [[[[self class] contentViewClass] alloc] initWithFrame: NSZeroRect];
|
|
mContent.owner = self;
|
|
|
|
// Initialize the scrollers but don't show them yet.
|
|
// Pick an arbitrary size, just to make NSScroller selecting the proper scroller direction
|
|
// (horizontal or vertical).
|
|
NSRect scrollerRect = NSMakeRect(0, 0, 100, 10);
|
|
scrollView = (NSScrollView *)[[SCIScrollView alloc] initWithFrame: scrollerRect];
|
|
#if defined(MAC_OS_X_VERSION_10_14)
|
|
// Let SCIScrollView account for other subviews such as vertical ruler by turning off
|
|
// automaticallyAdjustsContentInsets.
|
|
if (std::floor(NSAppKitVersionNumber) > NSAppKitVersionNumber10_13) {
|
|
scrollView.contentView.automaticallyAdjustsContentInsets = NO;
|
|
scrollView.contentView.contentInsets = NSEdgeInsetsMake(0., 0., 0., 0.);
|
|
}
|
|
#endif
|
|
scrollView.documentView = mContent;
|
|
[scrollView setHasVerticalScroller: YES];
|
|
[scrollView setHasHorizontalScroller: YES];
|
|
scrollView.autoresizingMask = NSViewWidthSizable|NSViewHeightSizable;
|
|
//[scrollView setScrollerStyle:NSScrollerStyleLegacy];
|
|
//[scrollView setScrollerKnobStyle:NSScrollerKnobStyleDark];
|
|
//[scrollView setHorizontalScrollElasticity:NSScrollElasticityNone];
|
|
[self addSubview: scrollView];
|
|
|
|
marginView = [[SCIMarginView alloc] initWithScrollView: scrollView];
|
|
marginView.owner = self;
|
|
marginView.ruleThickness = marginView.requiredThickness;
|
|
scrollView.verticalRulerView = marginView;
|
|
[scrollView setHasHorizontalRuler: NO];
|
|
[scrollView setHasVerticalRuler: YES];
|
|
[scrollView setRulersVisible: YES];
|
|
|
|
mBackend = new ScintillaCocoa(self, mContent, marginView);
|
|
|
|
// Establish a connection from the back end to this container so we can handle situations
|
|
// which require our attention.
|
|
mBackend->SetDelegate(self);
|
|
|
|
[self updateIndicatorIME];
|
|
|
|
NSNotificationCenter *center = [NSNotificationCenter defaultCenter];
|
|
[center addObserver: self
|
|
selector: @selector(applicationDidResignActive:)
|
|
name: NSApplicationDidResignActiveNotification
|
|
object: nil];
|
|
|
|
[center addObserver: self
|
|
selector: @selector(applicationDidBecomeActive:)
|
|
name: NSApplicationDidBecomeActiveNotification
|
|
object: nil];
|
|
|
|
[center addObserver: self
|
|
selector: @selector(windowWillMove:)
|
|
name: NSWindowWillMoveNotification
|
|
object: self.window];
|
|
|
|
[center addObserver: self
|
|
selector: @selector(defaultsDidChange:)
|
|
name: NSSystemColorsDidChangeNotification
|
|
object: self.window];
|
|
|
|
[scrollView.contentView setPostsBoundsChangedNotifications: YES];
|
|
[center addObserver: self
|
|
selector: @selector(scrollerAction:)
|
|
name: NSViewBoundsDidChangeNotification
|
|
object: scrollView.contentView];
|
|
|
|
mBackend->UpdateBaseElements();
|
|
}
|
|
return self;
|
|
}
|
|
|
|
//--------------------------------------------------------------------------------------------------
|
|
|
|
- (void) dealloc {
|
|
[[NSNotificationCenter defaultCenter] removeObserver: self];
|
|
mBackend->Finalise();
|
|
delete mBackend;
|
|
mBackend = NULL;
|
|
mContent.owner = nil;
|
|
[marginView setClientView: nil];
|
|
[scrollView removeFromSuperview];
|
|
}
|
|
|
|
//--------------------------------------------------------------------------------------------------
|
|
|
|
- (void) applicationDidResignActive: (NSNotification *) note {
|
|
#pragma unused(note)
|
|
mBackend->ActiveStateChanged(false);
|
|
}
|
|
|
|
//--------------------------------------------------------------------------------------------------
|
|
|
|
- (void) applicationDidBecomeActive: (NSNotification *) note {
|
|
#pragma unused(note)
|
|
mBackend->ActiveStateChanged(true);
|
|
}
|
|
|
|
//--------------------------------------------------------------------------------------------------
|
|
|
|
- (void) windowWillMove: (NSNotification *) note {
|
|
#pragma unused(note)
|
|
mBackend->WindowWillMove();
|
|
}
|
|
|
|
//--------------------------------------------------------------------------------------------------
|
|
|
|
- (void) defaultsDidChange: (NSNotification *) note {
|
|
#pragma unused(note)
|
|
mBackend->UpdateBaseElements();
|
|
}
|
|
|
|
//--------------------------------------------------------------------------------------------------
|
|
|
|
- (void) viewDidMoveToWindow {
|
|
[super viewDidMoveToWindow];
|
|
|
|
[self positionSubViews];
|
|
|
|
// Enable also mouse move events for our window (and so this view).
|
|
[self.window setAcceptsMouseMovedEvents: YES];
|
|
}
|
|
|
|
//--------------------------------------------------------------------------------------------------
|
|
|
|
/**
|
|
* Used to position and size the parts of the editor (content, scrollers, info bar).
|
|
*/
|
|
- (void) positionSubViews {
|
|
CGFloat scrollerWidth = [NSScroller scrollerWidthForControlSize: NSControlSizeRegular
|
|
scrollerStyle: NSScrollerStyleLegacy];
|
|
|
|
NSSize size = self.frame.size;
|
|
NSRect barFrame = {{0, size.height - scrollerWidth}, {size.width, scrollerWidth}};
|
|
BOOL infoBarVisible = mInfoBar != nil && !mInfoBar.hidden;
|
|
|
|
// Horizontal offset of the content. Almost always 0 unless the vertical scroller
|
|
// is on the left side.
|
|
CGFloat contentX = 0;
|
|
NSRect scrollRect = {{contentX, 0}, {size.width, size.height}};
|
|
|
|
// Info bar frame.
|
|
if (infoBarVisible) {
|
|
scrollRect.size.height -= scrollerWidth;
|
|
// Initial value already is as if the bar is at top.
|
|
if (!mInfoBarAtTop) {
|
|
scrollRect.origin.y += scrollerWidth;
|
|
barFrame.origin.y = 0;
|
|
}
|
|
}
|
|
|
|
if (!NSEqualRects(scrollView.frame, scrollRect)) {
|
|
scrollView.frame = scrollRect;
|
|
}
|
|
|
|
if (infoBarVisible)
|
|
mInfoBar.frame = barFrame;
|
|
}
|
|
|
|
//--------------------------------------------------------------------------------------------------
|
|
|
|
/**
|
|
* Set the width of the margin.
|
|
*/
|
|
- (void) setMarginWidth: (int) width {
|
|
if (marginView.ruleThickness != width) {
|
|
marginView.marginWidth = width;
|
|
marginView.ruleThickness = marginView.requiredThickness;
|
|
}
|
|
}
|
|
|
|
//--------------------------------------------------------------------------------------------------
|
|
|
|
/**
|
|
* Triggered by one of the scrollers when it gets manipulated by the user. Notify the backend
|
|
* about the change.
|
|
*/
|
|
- (void) scrollerAction: (id) sender {
|
|
#pragma unused(sender)
|
|
mBackend->UpdateForScroll();
|
|
}
|
|
|
|
//--------------------------------------------------------------------------------------------------
|
|
|
|
/**
|
|
* Used to reposition our content depending on the size of the view.
|
|
*/
|
|
- (void) setFrame: (NSRect) newFrame {
|
|
NSRect previousFrame = self.frame;
|
|
super.frame = newFrame;
|
|
[self positionSubViews];
|
|
if (!NSEqualRects(previousFrame, newFrame)) {
|
|
mBackend->Resize();
|
|
}
|
|
}
|
|
|
|
//--------------------------------------------------------------------------------------------------
|
|
|
|
/**
|
|
* Getter for the currently selected text in raw form (no formatting information included).
|
|
* If there is no text available an empty string is returned.
|
|
*/
|
|
- (NSString *) selectedString {
|
|
NSString *result = @"";
|
|
|
|
const long length = mBackend->WndProc(Message::GetSelText, 0, 0);
|
|
if (length > 0) {
|
|
std::string buffer(length + 1, '\0');
|
|
try {
|
|
mBackend->WndProc(Message::GetSelText, length + 1, (sptr_t) &buffer[0]);
|
|
|
|
result = @(buffer.c_str());
|
|
} catch (...) {
|
|
}
|
|
}
|
|
|
|
return result;
|
|
}
|
|
|
|
//--------------------------------------------------------------------------------------------------
|
|
|
|
/**
|
|
* Delete a range from the document.
|
|
*/
|
|
- (void) deleteRange: (NSRange) aRange {
|
|
if (aRange.length > 0) {
|
|
NSRange posRange = mBackend->PositionsFromCharacters(aRange);
|
|
[self message: SCI_DELETERANGE wParam: posRange.location lParam: posRange.length];
|
|
}
|
|
}
|
|
|
|
//--------------------------------------------------------------------------------------------------
|
|
|
|
/**
|
|
* Getter for the current text in raw form (no formatting information included).
|
|
* If there is no text available an empty string is returned.
|
|
*/
|
|
- (NSString *) string {
|
|
NSString *result = @"";
|
|
|
|
const long length = mBackend->WndProc(Message::GetLength, 0, 0);
|
|
if (length > 0) {
|
|
std::string buffer(length + 1, '\0');
|
|
try {
|
|
mBackend->WndProc(Message::GetText, length + 1, (sptr_t) &buffer[0]);
|
|
|
|
result = @(buffer.c_str());
|
|
} catch (...) {
|
|
}
|
|
}
|
|
|
|
return result;
|
|
}
|
|
|
|
//--------------------------------------------------------------------------------------------------
|
|
|
|
/**
|
|
* Setter for the current text (no formatting included).
|
|
*/
|
|
- (void) setString: (NSString *) aString {
|
|
const char *text = aString.UTF8String;
|
|
mBackend->WndProc(Message::SetText, 0, (long) text);
|
|
}
|
|
|
|
//--------------------------------------------------------------------------------------------------
|
|
|
|
- (void) insertString: (NSString *) aString atOffset: (int) offset {
|
|
const char *text = aString.UTF8String;
|
|
mBackend->WndProc(Message::AddText, offset, (long) text);
|
|
}
|
|
|
|
//--------------------------------------------------------------------------------------------------
|
|
|
|
- (void) setEditable: (BOOL) editable {
|
|
mBackend->WndProc(Message::SetReadOnly, editable ? 0 : 1, 0);
|
|
}
|
|
|
|
//--------------------------------------------------------------------------------------------------
|
|
|
|
- (BOOL) isEditable {
|
|
return mBackend->WndProc(Message::GetReadOnly, 0, 0) == 0;
|
|
}
|
|
|
|
//--------------------------------------------------------------------------------------------------
|
|
|
|
- (SCIContentView *) content {
|
|
return mContent;
|
|
}
|
|
|
|
//--------------------------------------------------------------------------------------------------
|
|
|
|
- (void) updateMarginCursors {
|
|
[self.window invalidateCursorRectsForView: marginView];
|
|
}
|
|
|
|
//--------------------------------------------------------------------------------------------------
|
|
|
|
/**
|
|
* Direct call into the backend to allow uninterpreted access to it. The values to be passed in and
|
|
* the result heavily depend on the message that is used for the call. Refer to the Scintilla
|
|
* documentation to learn what can be used here.
|
|
*/
|
|
+ (sptr_t) directCall: (ScintillaView *) sender message: (unsigned int) message wParam: (uptr_t) wParam
|
|
lParam: (sptr_t) lParam {
|
|
return ScintillaCocoa::DirectFunction(
|
|
reinterpret_cast<sptr_t>(sender->mBackend), message, wParam, lParam);
|
|
}
|
|
|
|
- (sptr_t) message: (unsigned int) message wParam: (uptr_t) wParam lParam: (sptr_t) lParam {
|
|
return mBackend->WndProc(static_cast<Message>(message), wParam, lParam);
|
|
}
|
|
|
|
- (sptr_t) message: (unsigned int) message wParam: (uptr_t) wParam {
|
|
return mBackend->WndProc(static_cast<Message>(message), wParam, 0);
|
|
}
|
|
|
|
- (sptr_t) message: (unsigned int) message {
|
|
return mBackend->WndProc(static_cast<Message>(message), 0, 0);
|
|
}
|
|
|
|
//--------------------------------------------------------------------------------------------------
|
|
|
|
/**
|
|
* This is a helper method to set properties in the backend, with native parameters.
|
|
*
|
|
* @param property Main property like SCI_STYLESETFORE for which a value is to be set.
|
|
* @param parameter Additional info for this property like a parameter or index.
|
|
* @param value The actual value. It depends on the property what this parameter means.
|
|
*/
|
|
- (void) setGeneralProperty: (int) property parameter: (long) parameter value: (long) value {
|
|
mBackend->WndProc(static_cast<Message>(property), parameter, value);
|
|
}
|
|
|
|
//--------------------------------------------------------------------------------------------------
|
|
|
|
/**
|
|
* A simplified version for setting properties which only require one parameter.
|
|
*
|
|
* @param property Main property like SCI_STYLESETFORE for which a value is to be set.
|
|
* @param value The actual value. It depends on the property what this parameter means.
|
|
*/
|
|
- (void) setGeneralProperty: (int) property value: (long) value {
|
|
mBackend->WndProc(static_cast<Message>(property), value, 0);
|
|
}
|
|
|
|
//--------------------------------------------------------------------------------------------------
|
|
|
|
/**
|
|
* This is a helper method to get a property in the backend, with native parameters.
|
|
*
|
|
* @param property Main property like SCI_STYLESETFORE for which a value is to get.
|
|
* @param parameter Additional info for this property like a parameter or index.
|
|
* @param extra Yet another parameter if needed.
|
|
* @result A generic value which must be interpreted depending on the property queried.
|
|
*/
|
|
- (long) getGeneralProperty: (int) property parameter: (long) parameter extra: (long) extra {
|
|
return mBackend->WndProc(static_cast<Message>(property), parameter, extra);
|
|
}
|
|
|
|
//--------------------------------------------------------------------------------------------------
|
|
|
|
/**
|
|
* Convenience function to avoid unneeded extra parameter.
|
|
*/
|
|
- (long) getGeneralProperty: (int) property parameter: (long) parameter {
|
|
return mBackend->WndProc(static_cast<Message>(property), parameter, 0);
|
|
}
|
|
|
|
//--------------------------------------------------------------------------------------------------
|
|
|
|
/**
|
|
* Convenience function to avoid unneeded parameters.
|
|
*/
|
|
- (long) getGeneralProperty: (int) property {
|
|
return mBackend->WndProc(static_cast<Message>(property), 0, 0);
|
|
}
|
|
|
|
//--------------------------------------------------------------------------------------------------
|
|
|
|
/**
|
|
* Use this variant if you have to pass in a reference to something (e.g. a text range).
|
|
*/
|
|
- (long) getGeneralProperty: (int) property ref: (const void *) ref {
|
|
return mBackend->WndProc(static_cast<Message>(property), 0, (sptr_t) ref);
|
|
}
|
|
|
|
//--------------------------------------------------------------------------------------------------
|
|
|
|
/**
|
|
* Specialized property setter for colors.
|
|
*/
|
|
- (void) setColorProperty: (int) property parameter: (long) parameter value: (NSColor *) value {
|
|
if (value.colorSpaceName != NSDeviceRGBColorSpace)
|
|
value = [value colorUsingColorSpaceName: NSDeviceRGBColorSpace];
|
|
long red = static_cast<long>(value.redComponent * 255);
|
|
long green = static_cast<long>(value.greenComponent * 255);
|
|
long blue = static_cast<long>(value.blueComponent * 255);
|
|
|
|
long color = (blue << 16) + (green << 8) + red;
|
|
mBackend->WndProc(static_cast<Message>(property), parameter, color);
|
|
}
|
|
|
|
//--------------------------------------------------------------------------------------------------
|
|
|
|
/**
|
|
* Another color property setting, which allows to specify the color as string like in HTML
|
|
* documents (i.e. with leading # and either 3 hex digits or 6).
|
|
*/
|
|
- (void) setColorProperty: (int) property parameter: (long) parameter fromHTML: (NSString *) fromHTML {
|
|
if (fromHTML.length > 3 && [fromHTML characterAtIndex: 0] == '#') {
|
|
bool longVersion = fromHTML.length > 6;
|
|
int index = 1;
|
|
|
|
char value[3] = {0, 0, 0};
|
|
value[0] = static_cast<char>([fromHTML characterAtIndex: index++]);
|
|
if (longVersion)
|
|
value[1] = static_cast<char>([fromHTML characterAtIndex: index++]);
|
|
else
|
|
value[1] = value[0];
|
|
|
|
unsigned rawRed;
|
|
[[NSScanner scannerWithString: @(value)] scanHexInt: &rawRed];
|
|
|
|
value[0] = static_cast<char>([fromHTML characterAtIndex: index++]);
|
|
if (longVersion)
|
|
value[1] = static_cast<char>([fromHTML characterAtIndex: index++]);
|
|
else
|
|
value[1] = value[0];
|
|
|
|
unsigned rawGreen;
|
|
[[NSScanner scannerWithString: @(value)] scanHexInt: &rawGreen];
|
|
|
|
value[0] = static_cast<char>([fromHTML characterAtIndex: index++]);
|
|
if (longVersion)
|
|
value[1] = static_cast<char>([fromHTML characterAtIndex: index++]);
|
|
else
|
|
value[1] = value[0];
|
|
|
|
unsigned rawBlue;
|
|
[[NSScanner scannerWithString: @(value)] scanHexInt: &rawBlue];
|
|
|
|
long color = (rawBlue << 16) + (rawGreen << 8) + rawRed;
|
|
mBackend->WndProc(static_cast<Message>(property), parameter, color);
|
|
}
|
|
}
|
|
|
|
//--------------------------------------------------------------------------------------------------
|
|
|
|
/**
|
|
* Specialized property getter for colors.
|
|
*/
|
|
- (NSColor *) getColorProperty: (int) property parameter: (long) parameter {
|
|
long color = mBackend->WndProc(static_cast<Message>(property), parameter, 0);
|
|
CGFloat red = (color & 0xFF) / 255.0;
|
|
CGFloat green = ((color >> 8) & 0xFF) / 255.0;
|
|
CGFloat blue = ((color >> 16) & 0xFF) / 255.0;
|
|
NSColor *result = [NSColor colorWithDeviceRed: red green: green blue: blue alpha: 1];
|
|
return result;
|
|
}
|
|
|
|
//--------------------------------------------------------------------------------------------------
|
|
|
|
/**
|
|
* Specialized property setter for references (pointers, addresses).
|
|
*/
|
|
- (void) setReferenceProperty: (int) property parameter: (long) parameter value: (const void *) value {
|
|
mBackend->WndProc(static_cast<Message>(property), parameter, (sptr_t) value);
|
|
}
|
|
|
|
//--------------------------------------------------------------------------------------------------
|
|
|
|
/**
|
|
* Specialized property getter for references (pointers, addresses).
|
|
*/
|
|
- (const void *) getReferenceProperty: (int) property parameter: (long) parameter {
|
|
return (const void *) mBackend->WndProc(static_cast<Message>(property), parameter, 0);
|
|
}
|
|
|
|
//--------------------------------------------------------------------------------------------------
|
|
|
|
/**
|
|
* Specialized property setter for string values.
|
|
*/
|
|
- (void) setStringProperty: (int) property parameter: (long) parameter value: (NSString *) value {
|
|
const char *rawValue = value.UTF8String;
|
|
mBackend->WndProc(static_cast<Message>(property), parameter, (sptr_t) rawValue);
|
|
}
|
|
|
|
|
|
//--------------------------------------------------------------------------------------------------
|
|
|
|
/**
|
|
* Specialized property getter for string values.
|
|
*/
|
|
- (NSString *) getStringProperty: (int) property parameter: (long) parameter {
|
|
const char *rawValue = (const char *) mBackend->WndProc(static_cast<Message>(property), parameter, 0);
|
|
return @(rawValue);
|
|
}
|
|
|
|
//--------------------------------------------------------------------------------------------------
|
|
|
|
/**
|
|
* Specialized property setter for lexer properties, which are commonly passed as strings.
|
|
*/
|
|
- (void) setLexerProperty: (NSString *) name value: (NSString *) value {
|
|
const char *rawName = name.UTF8String;
|
|
const char *rawValue = value.UTF8String;
|
|
mBackend->WndProc(Message::SetProperty, (sptr_t) rawName, (sptr_t) rawValue);
|
|
}
|
|
|
|
//--------------------------------------------------------------------------------------------------
|
|
|
|
/**
|
|
* Specialized property getter for references (pointers, addresses).
|
|
*/
|
|
- (NSString *) getLexerProperty: (NSString *) name {
|
|
const char *rawName = name.UTF8String;
|
|
const char *result = (const char *) mBackend->WndProc(Message::SetProperty, (sptr_t) rawName, 0);
|
|
return @(result);
|
|
}
|
|
|
|
//--------------------------------------------------------------------------------------------------
|
|
|
|
/**
|
|
* Sets the notification callback
|
|
*/
|
|
- (void) registerNotifyCallback: (intptr_t) windowid value: (SciNotifyFunc) callback {
|
|
mBackend->RegisterNotifyCallback(windowid, callback);
|
|
}
|
|
|
|
|
|
//--------------------------------------------------------------------------------------------------
|
|
|
|
/**
|
|
* Sets the new control which is displayed as info bar at the top or bottom of the editor.
|
|
* Set newBar to nil if you want to hide the bar again.
|
|
* The info bar's height is set to the height of the scrollbar.
|
|
*/
|
|
- (void) setInfoBar: (NSView <InfoBarCommunicator> *) newBar top: (BOOL) top {
|
|
if (mInfoBar != newBar) {
|
|
[mInfoBar removeFromSuperview];
|
|
|
|
mInfoBar = newBar;
|
|
mInfoBarAtTop = top;
|
|
if (mInfoBar != nil) {
|
|
[self addSubview: mInfoBar];
|
|
[mInfoBar setCallback: self];
|
|
}
|
|
|
|
[self positionSubViews];
|
|
}
|
|
}
|
|
|
|
//--------------------------------------------------------------------------------------------------
|
|
|
|
/**
|
|
* Sets the edit's info bar status message. This call only has an effect if there is an info bar.
|
|
*/
|
|
- (void) setStatusText: (NSString *) text {
|
|
if (mInfoBar != nil)
|
|
[mInfoBar notify: IBNStatusChanged message: text location: NSZeroPoint value: 0];
|
|
}
|
|
|
|
//--------------------------------------------------------------------------------------------------
|
|
|
|
- (NSRange) selectedRange {
|
|
return [mContent selectedRange];
|
|
}
|
|
|
|
//--------------------------------------------------------------------------------------------------
|
|
|
|
/**
|
|
* Return the main selection as an NSRange of positions (not characters).
|
|
* Unlike selectedRange, this can return empty ranges inside the document.
|
|
*/
|
|
|
|
- (NSRange) selectedRangePositions {
|
|
const sptr_t positionBegin = [self message: SCI_GETSELECTIONSTART];
|
|
const sptr_t positionEnd = [self message: SCI_GETSELECTIONEND];
|
|
return NSMakeRange(positionBegin, positionEnd-positionBegin);
|
|
}
|
|
|
|
|
|
//--------------------------------------------------------------------------------------------------
|
|
|
|
- (void) insertText: (id) aString {
|
|
if ([aString isKindOfClass: [NSString class]])
|
|
mBackend->InsertText(aString, CharacterSource::DirectInput);
|
|
else if ([aString isKindOfClass: [NSAttributedString class]])
|
|
mBackend->InsertText([aString string], CharacterSource::DirectInput);
|
|
}
|
|
|
|
//--------------------------------------------------------------------------------------------------
|
|
|
|
/**
|
|
* For backwards compatibility.
|
|
*/
|
|
- (BOOL) findAndHighlightText: (NSString *) searchText
|
|
matchCase: (BOOL) matchCase
|
|
wholeWord: (BOOL) wholeWord
|
|
scrollTo: (BOOL) scrollTo
|
|
wrap: (BOOL) wrap {
|
|
return [self findAndHighlightText: searchText
|
|
matchCase: matchCase
|
|
wholeWord: wholeWord
|
|
scrollTo: scrollTo
|
|
wrap: wrap
|
|
backwards: NO];
|
|
}
|
|
|
|
//--------------------------------------------------------------------------------------------------
|
|
|
|
/**
|
|
* Searches and marks the first occurrence of the given text and optionally scrolls it into view.
|
|
*
|
|
* @result YES if something was found, NO otherwise.
|
|
*/
|
|
- (BOOL) findAndHighlightText: (NSString *) searchText
|
|
matchCase: (BOOL) matchCase
|
|
wholeWord: (BOOL) wholeWord
|
|
scrollTo: (BOOL) scrollTo
|
|
wrap: (BOOL) wrap
|
|
backwards: (BOOL) backwards {
|
|
FindOption searchFlags = FindOption::None;
|
|
if (matchCase)
|
|
searchFlags = searchFlags | FindOption::MatchCase;
|
|
if (wholeWord)
|
|
searchFlags = searchFlags | FindOption::WholeWord;
|
|
|
|
long selectionStart = [self getGeneralProperty: SCI_GETSELECTIONSTART parameter: 0];
|
|
long selectionEnd = [self getGeneralProperty: SCI_GETSELECTIONEND parameter: 0];
|
|
|
|
// Sets the start point for the coming search to the beginning of the current selection.
|
|
// For forward searches we have therefore to set the selection start to the current selection end
|
|
// for proper incremental search. This does not harm as we either get a new selection if something
|
|
// is found or the previous selection is restored.
|
|
if (!backwards)
|
|
[self getGeneralProperty: SCI_SETSELECTIONSTART parameter: selectionEnd];
|
|
[self setGeneralProperty: SCI_SEARCHANCHOR value: 0];
|
|
sptr_t result;
|
|
const char *textToSearch = searchText.UTF8String;
|
|
|
|
// The following call will also set the selection if something was found.
|
|
if (backwards) {
|
|
result = [ScintillaView directCall: self
|
|
message: SCI_SEARCHPREV
|
|
wParam: (uptr_t) searchFlags
|
|
lParam: (sptr_t) textToSearch];
|
|
if (result < 0 && wrap) {
|
|
// Try again from the end of the document if nothing could be found so far and
|
|
// wrapped search is set.
|
|
[self getGeneralProperty: SCI_SETSELECTIONSTART parameter: [self getGeneralProperty: SCI_GETTEXTLENGTH parameter: 0]];
|
|
[self setGeneralProperty: SCI_SEARCHANCHOR value: 0];
|
|
result = [ScintillaView directCall: self
|
|
message: SCI_SEARCHNEXT
|
|
wParam: (uptr_t) searchFlags
|
|
lParam: (sptr_t) textToSearch];
|
|
}
|
|
} else {
|
|
result = [ScintillaView directCall: self
|
|
message: SCI_SEARCHNEXT
|
|
wParam: (uptr_t) searchFlags
|
|
lParam: (sptr_t) textToSearch];
|
|
if (result < 0 && wrap) {
|
|
// Try again from the start of the document if nothing could be found so far and
|
|
// wrapped search is set.
|
|
[self getGeneralProperty: SCI_SETSELECTIONSTART parameter: 0];
|
|
[self setGeneralProperty: SCI_SEARCHANCHOR value: 0];
|
|
result = [ScintillaView directCall: self
|
|
message: SCI_SEARCHNEXT
|
|
wParam: (uptr_t) searchFlags
|
|
lParam: (sptr_t) textToSearch];
|
|
}
|
|
}
|
|
|
|
if (result >= 0) {
|
|
if (scrollTo)
|
|
[self setGeneralProperty: SCI_SCROLLCARET value: 0];
|
|
} else {
|
|
// Restore the former selection if we did not find anything.
|
|
[self setGeneralProperty: SCI_SETSELECTIONSTART value: selectionStart];
|
|
[self setGeneralProperty: SCI_SETSELECTIONEND value: selectionEnd];
|
|
}
|
|
return (result >= 0) ? YES : NO;
|
|
}
|
|
|
|
//--------------------------------------------------------------------------------------------------
|
|
|
|
/**
|
|
* Searches the given text and replaces
|
|
*
|
|
* @result Number of entries replaced, 0 if none.
|
|
*/
|
|
- (int) findAndReplaceText: (NSString *) searchText
|
|
byText: (NSString *) newText
|
|
matchCase: (BOOL) matchCase
|
|
wholeWord: (BOOL) wholeWord
|
|
doAll: (BOOL) doAll {
|
|
// The current position is where we start searching for single occurrences. Otherwise we start at
|
|
// the beginning of the document.
|
|
long startPosition;
|
|
if (doAll)
|
|
startPosition = 0; // Start at the beginning of the text if we replace all occurrences.
|
|
else
|
|
// For a single replacement we start at the current caret position.
|
|
startPosition = [self getGeneralProperty: SCI_GETCURRENTPOS];
|
|
long endPosition = [self getGeneralProperty: SCI_GETTEXTLENGTH];
|
|
|
|
FindOption searchFlags = FindOption::None;
|
|
if (matchCase)
|
|
searchFlags = searchFlags | FindOption::MatchCase;
|
|
if (wholeWord)
|
|
searchFlags = searchFlags | FindOption::WholeWord;
|
|
[self setGeneralProperty: SCI_SETSEARCHFLAGS value: (long)searchFlags];
|
|
[self setGeneralProperty: SCI_SETTARGETSTART value: startPosition];
|
|
[self setGeneralProperty: SCI_SETTARGETEND value: endPosition];
|
|
|
|
const char *textToSearch = searchText.UTF8String;
|
|
long sourceLength = strlen(textToSearch); // Length in bytes.
|
|
const char *replacement = newText.UTF8String;
|
|
long targetLength = strlen(replacement); // Length in bytes.
|
|
sptr_t result;
|
|
|
|
int replaceCount = 0;
|
|
if (doAll) {
|
|
while (true) {
|
|
result = [ScintillaView directCall: self
|
|
message: SCI_SEARCHINTARGET
|
|
wParam: sourceLength
|
|
lParam: (sptr_t) textToSearch];
|
|
if (result < 0)
|
|
break;
|
|
|
|
replaceCount++;
|
|
[ScintillaView directCall: self
|
|
message: SCI_REPLACETARGET
|
|
wParam: targetLength
|
|
lParam: (sptr_t) replacement];
|
|
|
|
// The replacement changes the target range to the replaced text. Continue after that till the end.
|
|
// The text length might be changed by the replacement so make sure the target end is the actual
|
|
// text end.
|
|
[self setGeneralProperty: SCI_SETTARGETSTART value: [self getGeneralProperty: SCI_GETTARGETEND]];
|
|
[self setGeneralProperty: SCI_SETTARGETEND value: [self getGeneralProperty: SCI_GETTEXTLENGTH]];
|
|
}
|
|
} else {
|
|
result = [ScintillaView directCall: self
|
|
message: SCI_SEARCHINTARGET
|
|
wParam: sourceLength
|
|
lParam: (sptr_t) textToSearch];
|
|
replaceCount = (result < 0) ? 0 : 1;
|
|
|
|
if (replaceCount > 0) {
|
|
[ScintillaView directCall: self
|
|
message: SCI_REPLACETARGET
|
|
wParam: targetLength
|
|
lParam: (sptr_t) replacement];
|
|
|
|
// For a single replace we set the new selection to the replaced text.
|
|
[self setGeneralProperty: SCI_SETSELECTIONSTART value: [self getGeneralProperty: SCI_GETTARGETSTART]];
|
|
[self setGeneralProperty: SCI_SETSELECTIONEND value: [self getGeneralProperty: SCI_GETTARGETEND]];
|
|
}
|
|
}
|
|
|
|
return replaceCount;
|
|
}
|
|
|
|
//--------------------------------------------------------------------------------------------------
|
|
|
|
- (void) setFontName: (NSString *) font
|
|
size: (int) size
|
|
bold: (BOOL) bold
|
|
italic: (BOOL) italic {
|
|
for (int i = 0; i < 128; i++) {
|
|
[self setGeneralProperty: SCI_STYLESETFONT
|
|
parameter: i
|
|
value: (sptr_t)font.UTF8String];
|
|
[self setGeneralProperty: SCI_STYLESETSIZE
|
|
parameter: i
|
|
value: size];
|
|
[self setGeneralProperty: SCI_STYLESETBOLD
|
|
parameter: i
|
|
value: bold];
|
|
[self setGeneralProperty: SCI_STYLESETITALIC
|
|
parameter: i
|
|
value: italic];
|
|
}
|
|
}
|
|
|
|
//--------------------------------------------------------------------------------------------------
|
|
|
|
@end
|
|
|