VCOO0037

OmniOutliner: Item Handles

A set of commands for controlling the appearance of item handles. If no items are selected, the settings are applied to the document.

Scope and Syntax

Language: English (United States 🇺🇸 · Great Britain 🇬🇧 · Australia 🇦🇺 · Canada 🇨🇦)

Scope: OmniOutliner

Command phrase variations (words in [brackets] are optional):

• “Set Handles to Always”
• “Set Handles to Hover”
• “Set Handles to Never”

Requirements

• Application: OmniOutliner: 5.10 (macOS only)
• System: macOS 12

Video: Item Handles

A set of commands for controlling the appearance of item handles. If no items are selected, the settings are applied to the document.

PLAY (E) PAUSE BACK REWIND

Downloads

• ⇩ COMMANDS-FILE (OmniOutliner 5) (macOS)
• ⇩ SHORTCUT-LINK ("Always")(macOS)
• ⇩ SHORTCUT-LINK ("Hover")(macOS)
• ⇩ SHORTCUT-LINK ("Never")(macOS)

Script Code

Here is the script code:

Set Handles to Always Show
Copy

(async () => {
	try {
		function createUtterance(textToSpeak){
			AlexID = (
				(app.platformName === "macOS") ? 
				"com.apple.speech.synthesis.voice.Alex" : 
				"com.apple.speech.voice.Alex"
			)
			voiceObj = Speech.Voice.withIdentifier(AlexID)
			voiceRate = 0.4
			utterance = new Speech.Utterance(textToSpeak)
			utterance.voice = voiceObj
			utterance.rate = voiceRate
			return utterance
		}
		var synthesizer = new Speech.Synthesizer()
		
		var handleMode = "always" // "hover" "never"

		var items = document.editors[0].selection.items
		
		var targetAtt = styleAttributes.find(att => {
			return att.key === "item-handle-mode(com.omnigroup.OmniOutliner)"
		})
		
		if (items.length === 0){
			// NO SELECTION USE BASESTYLE
			 baseStyle.set(targetAtt, handleMode)
			 var response = "All handles set to always show."
		} else {
			items.forEach(item => {
				item.style.set(targetAtt, handleMode)
			})
			 var response = `${items.length} handles set to always show.`
		}
	
		utterance = createUtterance(response)
		synthesizer.speakUtterance(utterance)
	}
	catch(err){
		utterance = createUtterance(err.message)
		synthesizer.speakUtterance(utterance)
		//new Alert(err.name, err.message).show()	
	}
})();

Set Handles to Show on Hover
Copy

(async () => {
	try {
		function createUtterance(textToSpeak){
			AlexID = (
				(app.platformName === "macOS") ? 
				"com.apple.speech.synthesis.voice.Alex" : 
				"com.apple.speech.voice.Alex"
			)
			voiceObj = Speech.Voice.withIdentifier(AlexID)
			voiceRate = 0.4
			utterance = new Speech.Utterance(textToSpeak)
			utterance.voice = voiceObj
			utterance.rate = voiceRate
			return utterance
		}
		var synthesizer = new Speech.Synthesizer()
		
		var handleMode = "hover" // "always" "never"

		var items = document.editors[0].selection.items
		
		var targetAtt = styleAttributes.find(att => {
			return att.key === "item-handle-mode(com.omnigroup.OmniOutliner)"
		})
		
		if (items.length === 0){
			// NO SELECTION USE BASESTYLE
			 baseStyle.set(targetAtt, handleMode)
			 var response = "All handles set to show on hover."
		} else {
			items.forEach(item => {
				item.style.set(targetAtt, handleMode)
			})
			 var response = `${items.length} handles set to show on hover.`
		}
	
		utterance = createUtterance(response)
		synthesizer.speakUtterance(utterance)
	}
	catch(err){
		utterance = createUtterance(err.message)
		synthesizer.speakUtterance(utterance)
		//new Alert(err.name, err.message).show()	
	}
})();

Set Handles to Never Show
Copy

(async () => {
	try {
		function createUtterance(textToSpeak){
			AlexID = (
				(app.platformName === "macOS") ? 
				"com.apple.speech.synthesis.voice.Alex" : 
				"com.apple.speech.voice.Alex"
			)
			voiceObj = Speech.Voice.withIdentifier(AlexID)
			voiceRate = 0.4
			utterance = new Speech.Utterance(textToSpeak)
			utterance.voice = voiceObj
			utterance.rate = voiceRate
			return utterance
		}
		var synthesizer = new Speech.Synthesizer()
		
		var handleMode = "never" // "always" "hover"

		var items = document.editors[0].selection.items
		
		var targetAtt = styleAttributes.find(att => {
			return att.key === "item-handle-mode(com.omnigroup.OmniOutliner)"
		})
		
		if (items.length === 0){
			// NO SELECTION USE BASESTYLE
			 baseStyle.set(targetAtt, handleMode)
			 var response = "All handles set to never show."
		} else {
			items.forEach(item => {
				item.style.set(targetAtt, handleMode)
			})
			 var response = `${items.length} handles set to never show.`
		}
	
		utterance = createUtterance(response)
		synthesizer.speakUtterance(utterance)
	}
	catch(err){
		utterance = createUtterance(err.message)
		synthesizer.speakUtterance(utterance)
		//new Alert(err.name, err.message).show()	
	}
})();