KeyHandler // _handleCandidateState: Add comments.

Source/Modules/ControllerModules/KeyHandler_HandleCandidate.swift

@@ -39,38 +39,35 @@ import Cocoa
 		let charCode: UniChar = input.charCode
 		let ctlCandidateCurrent = delegate!.ctlCandidate(for: self) as! ctlCandidate
 
+		// MARK: Cancel Candidate
+
 		let cancelCandidateKey =
 			input.isBackSpace || input.isESC || input.isDelete
 			|| ((input.isCursorBackward || input.isCursorForward) && input.isShiftHold)
 
 		if cancelCandidateKey {
-			if state is InputState.AssociatedPhrases {
+			if (state is InputState.AssociatedPhrases)
-				clear()
+				|| mgrPrefs.useSCPCTypingMode
-				let empty = InputState.EmptyIgnoringPreviousState()
+				|| isBuilderEmpty()
-				stateCallback(empty)
+			{
-			} else if mgrPrefs.useSCPCTypingMode {
-				clear()
-				let empty = InputState.EmptyIgnoringPreviousState()
-				stateCallback(empty)
-			} else if isBuilderEmpty() {
 				// 如果此時發現當前組字緩衝區為真空的情況的話，
 				// 就將當前的組字緩衝區析構處理、強制重設輸入狀態。
 				// 否則，一個本不該出現的真空組字緩衝區會使前後方向鍵與 BackSpace 鍵失靈。
+				// 所以這裡需要對 isBuilderEmpty() 做判定。
 				clear()
-				let empty = InputState.EmptyIgnoringPreviousState()
+				stateCallback(InputState.EmptyIgnoringPreviousState())
-				stateCallback(empty)
 			} else {
-				let inputting = buildInputtingState()
+				stateCallback(buildInputtingState())
-				stateCallback(inputting)
 			}
 			return true
 		}
 
+		// MARK: Enter
+
 		if input.isEnter {
 			if state is InputState.AssociatedPhrases {
 				clear()
-				let empty = InputState.EmptyIgnoringPreviousState()
+				stateCallback(InputState.EmptyIgnoringPreviousState())
-				stateCallback(empty)
 				return true
 			}
 			delegate!.keyHandler(
@@ -81,10 +78,14 @@ import Cocoa
 			return true
 		}
 
+		// MARK: Tab
+
 		if input.isTab {
 			let updated: Bool =
 				mgrPrefs.specifyShiftTabKeyBehavior
-				? (input.isShiftHold ? ctlCandidateCurrent.showPreviousPage() : ctlCandidateCurrent.showNextPage())
+				? (input.isShiftHold
+					? ctlCandidateCurrent.showPreviousPage()
+					: ctlCandidateCurrent.showNextPage())
 				: (input.isShiftHold
 					? ctlCandidateCurrent.highlightPreviousCandidate()
 					: ctlCandidateCurrent.highlightNextCandidate())
@@ -95,6 +96,8 @@ import Cocoa
 			return true
 		}
 
+		// MARK: Space
+
 		if input.isSpace {
 			let updated: Bool =
 				mgrPrefs.specifyShiftSpaceKeyBehavior
@@ -111,6 +114,8 @@ import Cocoa
 			return true
 		}
 
+		// MARK: PgDn
+
 		if input.isPageDown || input.emacsKey == vChewingEmacsKey.nextPage {
 			let updated: Bool = ctlCandidateCurrent.showNextPage()
 			if !updated {
@@ -120,6 +125,8 @@ import Cocoa
 			return true
 		}
 
+		// MARK: PgUp
+
 		if input.isPageUp {
 			let updated: Bool = ctlCandidateCurrent.showPreviousPage()
 			if !updated {
@@ -129,6 +136,8 @@ import Cocoa
 			return true
 		}
 
+		// MARK: Left Arrow
+
 		if input.isLeft {
 			if ctlCandidateCurrent is ctlCandidateHorizontal {
 				let updated: Bool = ctlCandidateCurrent.highlightPreviousCandidate()
@@ -146,6 +155,8 @@ import Cocoa
 			return true
 		}
 
+		// MARK: EmacsKey Backward
+
 		if input.emacsKey == vChewingEmacsKey.backward {
 			let updated: Bool = ctlCandidateCurrent.highlightPreviousCandidate()
 			if !updated {
@@ -155,6 +166,8 @@ import Cocoa
 			return true
 		}
 
+		// MARK: Right Arrow
+
 		if input.isRight {
 			if ctlCandidateCurrent is ctlCandidateHorizontal {
 				let updated: Bool = ctlCandidateCurrent.highlightNextCandidate()
@@ -172,6 +185,8 @@ import Cocoa
 			return true
 		}
 
+		// MARK: EmacsKey Forward
+
 		if input.emacsKey == vChewingEmacsKey.forward {
 			let updated: Bool = ctlCandidateCurrent.highlightNextCandidate()
 			if !updated {
@@ -181,6 +196,8 @@ import Cocoa
 			return true
 		}
 
+		// MARK: Up Arrow
+
 		if input.isUp {
 			if ctlCandidateCurrent is ctlCandidateHorizontal {
 				let updated: Bool = ctlCandidateCurrent.showPreviousPage()
@@ -198,6 +215,8 @@ import Cocoa
 			return true
 		}
 
+		// MARK: Down Arrow
+
 		if input.isDown {
 			if ctlCandidateCurrent is ctlCandidateHorizontal {
 				let updated: Bool = ctlCandidateCurrent.showNextPage()
@@ -215,6 +234,8 @@ import Cocoa
 			return true
 		}
 
+		// MARK: Home Key
+
 		if input.isHome || input.emacsKey == vChewingEmacsKey.home {
 			if ctlCandidateCurrent.selectedCandidateIndex == 0 {
 				IME.prtDebugIntel("9B6EDE8D")
@@ -234,6 +255,8 @@ import Cocoa
 			candidates = (state as! InputState.AssociatedPhrases).candidates
 		}
 
+		// MARK: End Key
+
 		if candidates.isEmpty {
 			return false
 		} else {  // 這裡不用「count > 0」，因為該整數變數只要「!isEmpty」那就必定滿足這個條件。
@@ -248,6 +271,8 @@ import Cocoa
 			}
 		}
 
+		// MARK: - Associated Phrases
+
 		if state is InputState.AssociatedPhrases {
 			if !input.isShiftHold { return false }
 		}
@@ -276,6 +301,8 @@ import Cocoa
 
 		if state is InputState.AssociatedPhrases { return false }
 
+		// MARK: SCPC Mode Processing
+
 		if mgrPrefs.useSCPCTypingMode {
 			var punctuationNamePrefix = ""