IPanes​.Create [Method]

Adds a pane to this collection and returns a reference to it.

Defined As

• [VBA] Create(name as String) as Object

• [Cicode] OBJECT Create (STRING name)

• [C++] HRESULT Create(BSTR name, IPane** pane)

Parameters

name

[in] The name to give to the pane (0-250 characters).

Execution Result

If the method succeeds, the return value will be Success. If a pane of the same name exists, the return value will be InvalidArgument. If the panes collection is deleted, the return value will be GeneralFailure.

Remarks

When this method succeeds it will return a reference to the new IPane object.

Calling Syntax

This example assumes there is a valid Panes collection object to be passed into the example methods.

[VBA]

Sub Example(Panes As Object)
Dim pane As Object
Set pane = Panes.Create("Alarm Pane")
End Sub

[Cicode]

FUNCTION Example(OBJECT hPanes)
OBJECT hPane = _ObjectCallMethod(hPanes, "Create", "Alarm Pane");
END

See Also

IPanes Interface