Get notifications about Kanzi Studio events and get access to the core Kanzi Studio operations, such as access to the Kanzi Studio project, get input from the user, and show notifications. More...

Public Member Functions
void	BeginEmphasize (EmphasizeFlag target)
	Starts emphasizing an ongoing operation. More...

bool	CanExecutePluginCommand (PluginCommand command, IEnumerable< ProjectItem > items)

bool	CanExecutePluginCommand (string commandName, IEnumerable< ProjectItem > items)

void	ExecutePluginCommand (PluginCommand command, IEnumerable< ProjectItem > items)

void	ExecutePluginCommand (string commandName, IEnumerable< ProjectItem > items)

void	FinishEmphasize (EmphasizeFlag type)
	Ends emphasizing an ongoing operation and allows Kanzi Studio to return to the normal state. More...

string	GetFolderPathFromUser (string dialogTitle, string initialPath)

string	GetFolderPathFromUser (string dialogTitle, string initialDirectory, string userPreferencesSetting)
	Prompts the user to provide a path to a directory. More...

string	GetPathFromUser (string dialogTitle, string initialDirectory, string userPreferencesSetting, string defaultExtension, string filter, PathDialogType pathDialogType, bool multiselect)
	Opens a Windows dialog that allows the user to browse their computer to select a path. More...

string	GetUserInput (string title, string prompt)
	Creates a dialog box which prompts the user to provide input. More...

string	GetUserInput (string title, string prompt, string initialValue)
	Creates a dialog box which prompts the user to provide input. More...

string	GetUserInput (string title, string prompt, IEnumerable< string > options, string initialValue)
	Displays a dialog box which prompts the user to select a value from one of the predefined options using a drop-down menu. More...

MessageBoxResult	GetUserInput (string title, string prompt, MessageBoxButton messageBoxButton)

string	GetUserInput (string title, string prompt, MessageBoxButton messageBoxButton, string extraOptionText)

void	Log (string message, LogLevel logLevel)
	Writes to the Kanzi Studio Log window. More...

void	Log (string message, Exception exception)
	Writes information about an exception to the Kanzi Studio Log window. More...

void	Log (string message)
	Writes to the Kanzi Studio Log window. More...

void	Redo ()

bool	RegisterPropertyRouter (PropertyRouter router)
	Registers a property router. More...

void	SendPreviewCommand (string name, object[] args)
	Sends commands to the Kanzi Studio Preview. More...

void	ShowMessageBox (string text, bool isModal)
	Creates a window with a message. More...

void	ShowMessageBox (string text, string caption, bool isModal)
	Displays a window with a title and a message. More...

void	SubscribeToPropertyValueChanges (string projectItemPath, string propertyName)
	Tracks property changes in the Kanzi Studio Preview for the project item you set in this function. More...

void	Undo ()

bool	UnregisterPropertyRouter (PropertyRouter router)
	Unregisters a property router. More...

void	UnsubscribeFromPropertyValueChanges (string projectItemPath, string propertyName)
	Stops tracking the property changes in the Kanzi Studio Preview for the project item you set in this function. More...

Properties
IEnumerable< ProjectItem >	ClipboardItems `[get]`

Commands	Commands `[get]`

DirectoryInfo	KanziWorkspaceDirectory `[get]`

Project	Project `[get]`

IEnumerable< ProjectItem >	SelectedItems `[get]`

string	StatusBarText `[get, set]`

IGenericUtilities	Utilities `[get]`

Version	Version `[get]`
	Gets the version of Kanzi Studio where you run the plugin. More...

Events
EventHandler	BinaryExported
	Occurs when the .kzb binary of the project is exported. More...

EventHandler	PreviewExited
	Occurs when the Kanzi Studio Preview closes. More...

EventHandler< PreviewPropertyChangedEventArgs >	PreviewPropertyChanged

EventHandler	PreviewStarted
	Occurs when the Kanzi Studio Preview starts. More...

EventHandler	ProjectClosed
	Occurs when the project is closed. More...

EventHandler< ProjectEventArgs >	ProjectOpened
	Occurs when the project is opened. More...

EventHandler	ProjectSaved
	Occurs when the project is saved. More...

EventHandler	SelectionChanged
	Occurs when the selection of a node or a resource in Kanzi Studio changes. More...

EventHandler< StatusEventArgs >	StatusChanged

Detailed Description

Get notifications about Kanzi Studio events and get access to the core Kanzi Studio operations, such as access to the Kanzi Studio project, get input from the user, and show notifications.

Member Function Documentation

void BeginEmphasize ( EmphasizeFlag target )

Starts emphasizing an ongoing operation.

Parameters

target Target location, for example a preview window.

See also: FinishEmphasize

void FinishEmphasize ( EmphasizeFlag type )

Ends emphasizing an ongoing operation and allows Kanzi Studio to return to the normal state.

Parameters

type	Target location, for example a preview window.

See also: BeginEmphasize

string GetFolderPathFromUser	(	string	dialogTitle,
		string	initialDirectory,
		string	userPreferencesSetting
	)

Prompts the user to provide a path to a directory.

Parameters

dialogTitle	The title of the dialog box.
initialDirectory	Initial directory where the folder dialog is opened.
userPreferencesSetting	A key to be used for storing the last selected folder in the user preferences. Set as null not to save the path. If an existing value is found from user preferences, that is used over the value supplied in initialDirectory parameter.

Returns: The select folder path or null if cancelled.

string GetPathFromUser	(	string	dialogTitle,
		string	initialDirectory,
		string	userPreferencesSetting,
		string	defaultExtension,
		string	filter,
		PathDialogType	pathDialogType,
		bool	multiselect
	)

Opens a Windows dialog that allows the user to browse their computer to select a path.

You can use this function to get a path to either open or save a file.

Parameters

dialogTitle	The title of the dialog box.
initialDirectory	The initial directory where to open the dialog.
userPreferencesSetting	The user preferences key to use to store the last selected directory. Set as null not to save the path. If an existing value is found from user preferences, that is used over the value supplied in initialDirectory parameter.
defaultExtension	The default file extension to use to open or save the file.
filter	The filter definition that sets which file extensions the dialog allows the user to select.
pathDialogType	The type of the dialog. Use PathDialogType.OPEN for the open file dialog and PathDialogType.SAVE for the save file dialog.
multiselect	When opening files, sets whether the user is allowed to select multiple files.

Returns: The absolute path to the selected file. If user cancels the operation, the function returns null.

See also: GetUserInput(string, string)

Examples

To open a Windows dialog which allows the user to browse their computer and select a path:

        public void Execute(PluginCommandParameter parameter)
        {
            // Opens the open file windows dialog with these settings:
            // - Set the title of the dialog to "Select the file you want to open".
            // - Open the dialog in the current directory.
            // - Store the path to the selected directory in the GetPathFromUser key in the Kanzi Studio user preferences.
            // - Use .xml as the default extension for opening the file.
            // - Allow the user to select only files with .xml and .txt extensions.
            // - Create an open dialog.
            // - Allow selection of multiple files in the dialog.
            studio.GetPathFromUser(
                "Select the file you want to open", 
                ".", 
                "GetPathFromUser", 
                ".xml", 
                "XML files (*.xml)|*.xml|Plain text files (*.txt)|*.txt", 
                PathDialogType.OPEN, 
                true);
        }

string GetUserInput	(	string	title,
		string	prompt
	)

Creates a dialog box which prompts the user to provide input.

For example, you can use this function to get the path of a node where you want your plugin to start executing its commands.

Parameters

title	The title of the dialog box.
prompt	The message you want to show in the dialog box.

Returns: The user input. If user cancels the operation, the function returns null.

Examples

To create a dialog box with a title and prompt:

        public void Execute(PluginCommandParameter parameter)
        {
            // Displays a dialog box with:
            // - Title "Where do you want to create the node?"
            // - Prompt message "Enter the path where you want to create the node"
            studio.GetUserInput(
                "Where do you want to create the node?", 
                "Enter the path where you want to create the node");
        }

string GetUserInput	(	string	title,
		string	prompt,
		string	initialValue
	)

Creates a dialog box which prompts the user to provide input.

For example, you can use this function to get the path of a node where you want your plugin to start executing its commands.

Parameters

title	The title of the dialog box.
prompt	The message you want to show in the dialog box.
initialValue	The predefined value entered in the prompt.

Returns: The user input. If user cancels the operation, the function returns null.

See also: GetPathFromUser

Examples

To create a dialog box with a title, a prompt, and a text box with a predefined value:

        public void Execute(PluginCommandParameter parameter)
        {
            // Displays a dialog box with:
            // - Title "Where do you want to create the node?"
            // - Prompt message "Enter the path where you want to create the node"
            // - Text box with a predefined value set to "Screen/Screens/RootPage"
            studio.GetUserInput(
                "Where do you want to create the node?", 
                "Enter the path where you want to create the node", 
                "Screen/Screens/RootPage");
        }

string GetUserInput	(	string	title,
		string	prompt,
		IEnumerable< string >	options,
		string	initialValue
	)

Displays a dialog box which prompts the user to select a value from one of the predefined options using a drop-down menu.

Parameters

title	The title of the dialog box.
prompt	The message you want to show in the dialog box.
options	The options shown in a drop-down box from which the user can select.
initialValue	The value preselected in the drop-down menu.

Returns: The user input. If user cancels the operation, the function returns null.

void Log	(	string	message,
		LogLevel	logLevel
	)

Writes to the Kanzi Studio Log window.

For example, you can use this function to inform the user about the plugin progress in the Log window.

Parameters

message	The message you want to print to the Log window.
logLevel	The level of the message you want to print to the Log window.

Examples

To print a message to the Log window as a regular notification:

        public void Execute(PluginCommandParameter parameter)
        {
            // Prints "Hello world!" to the Log window.
            studio.Log("Hello world!", LogLevel.INFO);
        }

To print a message to the Log window as a warning:

        public void Execute(PluginCommandParameter parameter)
        {
            // Prints "Warning!" with a yellow background to the Log window.
            studio.Log("Warning!", LogLevel.WARNING);
        }

void Log	(	string	message,
		Exception	exception
	)

Writes information about an exception to the Kanzi Studio Log window.

Parameters

message	The message you want to print to the Log window before the exception information.
exception	The exception to be logged.

void Log ( string message )

Writes to the Kanzi Studio Log window.

For example, you can use this function to inform the user about the plugin progress in the Log window.

Parameters

message The message you want to print to the Log window.

Examples

To print a message to the Kanzi Studio Log window:

        public void Execute(PluginCommandParameter parameter)
        {
            // Prints "Success!" to the Kanzi Studio Log window.
            studio.Log("Success!");
        }

bool RegisterPropertyRouter ( PropertyRouter router )

Registers a property router.

A property router can interfere when a user edits properties in Kanzi Studio.

Parameters

router The router to register.

Returns: True, if router was registered. False, if the router is already registered.

See also: UnregisterPropertyRouter

void SendPreviewCommand	(	string	name,
		object[]	args
	)

Sends commands to the Kanzi Studio Preview.

Parameters

name	The name of the command you want to send to the Preview.
args	The command arguments you want to send (must be serializable.)

void ShowMessageBox	(	string	text,
		bool	isModal
	)

Creates a window with a message.

For example, you can use this function to show a message to the user.

Parameters

text	The message you want to show in the window.
isModal	Whether the window is modal. When set to `true` you cannot use the main Kanzi Studio window until you confirm the message in this window.

Examples

To create a modal window which displays a message:

        public void Execute(PluginCommandParameter parameter)
        {
            // Displays a modal window with the message "All nodes created".
            studio.ShowMessageBox("All nodes created.", true);
        }

void ShowMessageBox	(	string	text,
		string	caption,
		bool	isModal
	)

Displays a window with a title and a message.

For example, you can use this function to show a message to the user.

Parameters

text	The message you want to show in the window.
caption	The title of the window.
isModal	Whether the window is modal. When set to `true` you cannot use the main Kanzi Studio window until you confirm the message in this window.

Examples

To create a modal window with a title and which displays a message:

        public void Execute(PluginCommandParameter parameter)
        {
            // Displays a modal window with the title "Success!" and the message "All nodes created".
            studio.ShowMessageBox("All nodes created.", "Success!", true);
        }

void SubscribeToPropertyValueChanges	(	string	projectItemPath,
		string	propertyName
	)

Tracks property changes in the Kanzi Studio Preview for the project item you set in this function.

Triggers change events in project item and in this class.

Parameters

projectItemPath	The path to the project item for which you want to track property changes.
propertyName	The name of the property the changes of which you want to track.

See also: UnsubscribeFromPropertyValueChanges

bool UnregisterPropertyRouter ( PropertyRouter router )

Unregisters a property router.

A property router can interfere when a user edits properties in Kanzi Studio.

Parameters

router The router to unregister.

Returns: True, if the router was successfully unregistered. False, if no such router was registered.

See also: RegisterPropertyRouter

void UnsubscribeFromPropertyValueChanges	(	string	projectItemPath,
		string	propertyName
	)

Stops tracking the property changes in the Kanzi Studio Preview for the project item you set in this function.

Parameters

projectItemPath	The path to the project item for which you want to stop tracking property changes.
propertyName	The name of the property the changes of which you want to stop tracking.

See also: SubscribeToPropertyValueChanges

Property Documentation

Version Version

get

Gets the version of Kanzi Studio where you run the plugin.

The version of Kanzi Studio.

Examples

To get the major, minor, revision, and build numbers of the Kanzi Studio where you run the plugin:

        public void Execute(PluginCommandParameter parameter)
        {
            // Print the Kanzi Studio version in the format Major.Minor.Revision.Build to the Log window.
            studio.Log(
                studio.Version.Major + "." + 
                studio.Version.Minor + "." + 
                studio.Version.Revision + "." + 
                studio.Version.Build);
        }

Event Documentation

EventHandler BinaryExported

Occurs when the .kzb binary of the project is exported.

Examples

To subscribe to the BinaryExported event:

        // Create the event handler and subscribe to the BinaryExported event to get 
        // notified when the .kzb binary of the project is exported.
        public void Execute(PluginCommandParameter parameter)
        {
            // Create the event handler that is set off when the .kzb binary of the project is exported.
            studio.BinaryExported += Studio_BinaryExported;
        }
        private void Studio_BinaryExported(object sender, EventArgs e)
        {
            // When the .kzb binary of the project is exported, print 
            // "The .kzb binary of the project is exported." to the Log window.
            studio.Log("The .kzb binary of the project is exported.");
        }

EventHandler PreviewExited

Occurs when the Kanzi Studio Preview closes.

See also: PreviewStarted

Examples

To subscribe to the PreviewExited event:

        // Create the event handler and subscribe to the PreviewExited event to get notified when the Preview closes.
        public void Execute(PluginCommandParameter parameter)
        {
            // Create the event handler that is set off when the Preview closes.
            studio.PreviewExited += Studio_PreviewExited;
        }
        private void Studio_PreviewExited(object sender, EventArgs e)
        {
            // When the Preview closes, print "The Preview closed." to the Log window.
            studio.Log("The Preview closed.");
        }

EventHandler PreviewStarted

Occurs when the Kanzi Studio Preview starts.

See also: PreviewExited

Examples

To subscribe to the PreviewStarted event:

        // Create the event handler and subscribe to the PreviewStarted event to get notified when the Preview starts.
        public void Execute(PluginCommandParameter parameter)
        {
            // Create the event handler that is set off when the Preview starts.
            studio.PreviewStarted += Studio_PreviewStarted;
        }
        private void Studio_PreviewStarted(object sender, EventArgs e)
        {
            // When the Preview starts, print "The Preview started." to the Log window.
            studio.Log("The Preview started.");
        }

EventHandler ProjectClosed

Occurs when the project is closed.

See also: ProjectOpened, ProjectSaved

Examples

To subscribe to the ProjectClosed event:

        // Create the event handler and subscribe to the ProjectClosed event to get notified when a project is closed.
        public void Execute(PluginCommandParameter parameter)
        {
            // Create the event handler that is set off when a project is closed.
            studio.ProjectClosed += Studio_ProjectClosed;
        }
        private void Studio_ProjectClosed(object sender, EventArgs e)
        {
            // When the project is closed, show a dialog box with a message "The project is closed."
            studio.ShowMessageBox("The project is closed.", false);
        }

EventHandler<ProjectEventArgs> ProjectOpened

Occurs when the project is opened.

See also: ProjectClosed, ProjectSaved

Examples

To subscribe to the ProjectOpened event:

        // Create the event handler and subscribe to the ProjectOpened event to get notified when a project is opened.
        public void Execute(PluginCommandParameter parameter)
        {
            // Create the event handler that is set off when a project is opened.
            studio.ProjectOpened += Studio_ProjectOpened;
        }
        private void Studio_ProjectOpened(object sender, EventArgs e)
        {
            // When the project is opened, show a dialog box with a message "The project is opened."
            studio.Log("The project is opened.");
        }

EventHandler ProjectSaved

Occurs when the project is saved.

See also: ProjectOpened, ProjectClosed

Examples

To subscribe to the ProjectSaved event:

        // Create the event handler and subscribe to the ProjectSaved event to get notified when a project is saved.
        public void Execute(PluginCommandParameter parameter)
        {
            // Create the event handler that is set off when a project is saved.
            studio.ProjectSaved += Studio_ProjectSaved;
        }
        private void Studio_ProjectSaved(object sender, EventArgs e)
        {
            // When the project is saved, print "The project is saved." to the Log window.
            studio.Log("The project is saved.");
        }

EventHandler SelectionChanged

Occurs when the selection of a node or a resource in Kanzi Studio changes.

For example, Kanzi Studio sets off this event when you select a node in a Project or Nodes windows, when you select a library, a directory, or a resource in the Library, or any of the resource windows.

Examples

To subscribe to the SelectionChanged event:

        // Create the event handler and subscribe to the SelectionChanged event to get notified 
        // when the selection of a node or a resource in Kanzi Studio changes.
        public void Execute(PluginCommandParameter parameter)
        {
            // Create the event handler that is set off when the selection of a node or a resource in Kanzi Studio changes.
            studio.BinaryExported += Studio_SelectionChanged;
        }
        private void Studio_SelectionChanged(object sender, EventArgs e)
        {
            // When the selection of a node or a resource in Kanzi Studio changes, 
            // print "The node or resource selection changed." to the Log window.
            studio.Log("The node or resource selection changed.");
        }

Public Member Functions

Properties

Events

Detailed Description

Member Function Documentation

Property Documentation

Event Documentation