Function AddControl( _
   ByVal ID As Integer, _
   ByVal ControlType As Short, _
   ByVal Caption As String, _
   ByVal LeftAlign As Short, _
   ByVal Options As Integer, _
   ByVal Tip As String _
) As Object

Dim instance As IPropertyManagerPageTab
Dim ID As Integer
Dim ControlType As Short
Dim Caption As String
Dim LeftAlign As Short
Dim Options As Integer
Dim Tip As String
Dim value As Object
 
value = instance.AddControl(ID, ControlType, Caption, LeftAlign, Options, Tip)

object AddControl( 
   int ID,
   short ControlType,
   string Caption,
   short LeftAlign,
   int Options,
   string Tip
)

Object^ AddControl( 
&   int ID,
&   short ControlType,
&   String^ Caption,
&   short LeftAlign,
&   int Options,
&   String^ Tip
) 

Parameters

ID

Resource ID of this control

ControlType

Type of control as defined in swPropertyManagerPageControlType_e

Caption

Caption of the control

LeftAlign

Left align property of this control as defined in swPropertyManagerPageControlLeftAlign_e

Options

Options as defined in swAddControlOptions_e (see Remarks)

Tip

Tool tip text for the control

Return Value

You can only use this method to set properties on the PropertyManager page before it is displayed or while it is closed. See IPropertyManagerPage2::Show2 and IPropertyManagerPage2::Close.

This method associates controls with a tab. When a user clicks a tab, controls associated with that tab are automatically shown and controls not associated with that tab are automatically hidden.

However, any controls added to a tab using IPropertyManagerPage2::AddControl or IPropertyManagerPage2::IAddControl are not associated with the tab; you must still hide and show those controls. But, because the name of this method and its parameters are identical to IPropertyManagerPage2::AddControl or IPropertyManagerPage2::IAddControl, switching to this method and cleaning up your handler code should be easy.

To add a control to a group box associated with a tab, add the controls from the group box. Only use this method to add controls not associated with group boxes.

When you specify swControlOptions_SmallGapAbove for the Options parameter, gap is used between a new control and the previous control that is smaller than the typical gap.