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

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

System.object AddControl2( 
   System.int ID,
   System.short ControlType,
   System.string Caption,
   System.short LeftAlign,
   System.int Options,
   System.string Tip
)

System.Object^ AddControl2( 
&   System.int ID,
&   System.short ControlType,
&   System.String^ Caption,
&   System.short LeftAlign,
&   System.int Options,
&   System.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 alignment 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. Any controls added to a tab using IPropertyManagerPage2::AddControl2 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::AddControl2, 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 swAddControlOptions_e.swControlOptions_SmallGapAbove for the Options parameter, the gap created between a new control and the previous control is smaller than the typical gap. Also, the control is hidden unless you specify swAddControlOptions_e.swControlOptions_Visible for the Options parameter. In the previous versions of this method, IPropertyManagerPageTab::AddControl and IPropertyManagerPageTab::IAddControl, the control was visible regardless if the Options parameter was set or not set to swAddControlOptions_e.swControlOptions_Visible.