IVsStatusbar.SetInsMode(Object) Method
Definition
Important
Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.
Sets the mode of the editor in the status bar to either insert or overwrite.
public:
int SetInsMode(System::Object ^ % pvInsMode);
int SetInsMode(winrt::Windows::Foundation::IInspectable const & & pvInsMode);
public int SetInsMode (ref object pvInsMode);
abstract member SetInsMode : obj -> int
Public Function SetInsMode (ByRef pvInsMode As Object) As Integer
Parameters
- pvInsMode
- Object
[in] Pointer to a VARIANT indicating the insert mode.
Returns
If the method succeeds, it returns S_OK. If it fails, it returns an error code.
Remarks
COM Signature
From vsshell.idl:
HRESULT IVsStatusbar::SetInsMode(
[in]VARIANT *pvInsMode
);
The insert or overwrite information is displayed in a specific panel of the editor information area of the status bar, which is used only by this method.
The VARIANT must be a VT_I4 or VT_BSTR. A VT_BSTR refers to the actual text that will be placed in the status bar to indicate the insert or overwrite mode of the editor window. A VT_I4 refers to the following enumeration:
enum
{
UIE_TEXTINSMODE_INSERT= 0, /* Writes "INS" in the status bar */
UIE_TEXTINSMODE_OVERSTRIKE = 1/* Writes "OVR" in the status bar */
};
When the VARIANT is a VT_I4, the method tests for UIE_TEXTINSMODE_INSERT
; anything else is interpreted as UIE_TEXTINSMODE_OVERSTRIKE
.
For more information about the VARIANT structure, refer to the Automation documentation in the Platform SDK of the MSDN Library.