Difference between revisions of "Method create"

Revision as of 14:27, 14 March 2013

This section is under construction. Please do not rely on any information it contains.

Static factory method for rxCustomUI objects. A new context if created if required.

Parameter Name	Parameter Type	Default Value	Description
contextId	string	null	The context's unique string identifier
description	string	'Dynamic RibbonX'	The context's description
dispatchScope	rxDispatchScope	DispatchScope_local	(VBA-specific) The context's dispatch mode
customUIMode	rxCustomUIMode	CustomUIMode_dynamic	The context's mode

A new context is created if it doesn't already exist. If it does exist, the newly created rxCustomUI object joins the existing context.
Parameter description only takes effect when a new context is created.
Parameter customUIMode should be set to CustomUIMode_dynamic (the default value) for smoother UI rendering

' Create an rxCustomUI with global dispatch

Set myCustomUI = rxCustomUI.create("my_sample_context", "My Global Context", DispatchScope_global)

' Create a second rxCustomUI in the same context but with local dispatch

Set myCustomUI2 = rxCustomUI.create("my_sample_context", "My Global Context", DispatchScope_local)

' NOTE: Both objects now have access to the same state

' NOTE2: Notice that the dispatch scope is a property of rxCustomUI; not its context. i.e. rxCustomUI's

' with different dispatch scopes belong to the same context above.

// Create a new rxCustomUI in context 'cs_ribbon_context'

// The context doesn't exist at this point so it will get created

rxCustomUI myCustomUI = rxCustomUI.create("cs_ribbon_context", "C# Ribbon");

// Create another rxCustomUI in context 'cs_ribbon_context'

// The context already exitsts at this point, so the new rxCustomUI will

rxCustomUI myCustomUI2 = rxCustomUI.create("cs_ribbon_context", "C# Ribbon");

' Create a new rxCustomUI in context 'vb_ribbon_context'

' The context doesn't exist at this point so it will get created

Dim myCustomUI As rxCustomUI = rxCustomUI.create("vb_ribbon_context", "VB.NET context")

' Create another context in context 'vb_ribbon_context'

' The context already exists at this point, so the new rxCustomUI will

Dim myCustomUI2 As rxCustomUI = rxCustomUI.create("vb_ribbon_context", "VB.NET context")

@@ Line 15: / Line 15: @@
 == Remarks ==
 # A new context is created if it doesn't already exist. If it does exist, the newly created [[rxCustomUI]] object joins the existing context.
-# Parameter ''description'' only takes effect when a new context is being created.
+# Parameter ''description'' only takes effect when a new context is created.
 # Parameter ''customUIMode'' should be set to CustomUIMode_dynamic (the default value) for smoother UI rendering