Skip to main content
Version: 2025

stdole_Picture

Namespace: PPJ.Runtime.Com

Assembly: PPJ.Web.50 (5.0.0.0)

Wraps the standard OLE picture automation interface using SAL values.

public class stdole_Picture : SalObject

Attach an appropriate COM object before accessing interface properties.

Example:

using PPJ.Runtime.Com;

using (var value = new stdole_StdPicture())
{
if (value.Create())
System.Console.WriteLine(value.IsDispatchValid());
}

Constructors

Instance member stdole_Picture()

Initializes a new instance of stdole_Picture.

Fields

NameTypeDescriptionValue
_InterfaceCOMInterfaceThe typed OLE automation interface attached to this wrapper.

Methods

Instance member PropGetHandle(returnValue)

Reads the native picture handle from the attached OLE interface.

ParameterTypeDescription
returnValue by referenceSalNumberReceives the native picture handle.

Returns: SalBoolean. True on success; false when a COM error is recorded with AutoErrorMode disabled.

Instance member PropGetHeight(returnValue)

Reads the picture height in HIMETRIC units from the attached OLE interface.

ParameterTypeDescription
returnValue by referenceSalNumberReceives the picture height in HIMETRIC units.

Returns: SalBoolean. True on success; false when a COM error is recorded with AutoErrorMode disabled.

Instance member PropGethPal(returnValue)

Reads the palette handle from the attached OLE interface.

ParameterTypeDescription
returnValue by referenceSalNumberReceives the palette handle.

Returns: SalBoolean. True on success; false when a COM error is recorded with AutoErrorMode disabled.

Instance member PropGetType(returnValue)

Reads the picture type code from the attached OLE interface.

ParameterTypeDescription
returnValue by referenceSalNumberReceives the picture type code.

Returns: SalBoolean. True on success; false when a COM error is recorded with AutoErrorMode disabled.

Instance member PropGetWidth(returnValue)

Reads the picture width in HIMETRIC units from the attached OLE interface.

ParameterTypeDescription
returnValue by referenceSalNumberReceives the picture width in HIMETRIC units.

Returns: SalBoolean. True on success; false when a COM error is recorded with AutoErrorMode disabled.

Instance member PropSetHandle(Handle)

Assigns the native picture handle on the attached OLE interface.

ParameterTypeDescription
HandleSalNumberThe native picture handle to assign.

Returns: SalBoolean. True on success; false when a COM error is recorded with AutoErrorMode disabled.

Instance member PropSetHeight(Height)

Assigns the picture height in HIMETRIC units on the attached OLE interface.

ParameterTypeDescription
HeightSalNumberThe picture height in HIMETRIC units to assign.

Returns: SalBoolean. True on success; false when a COM error is recorded with AutoErrorMode disabled.

Instance member PropSethPal(hPal)

Assigns the palette handle on the attached OLE interface.

ParameterTypeDescription
hPalSalNumberThe palette handle to assign.

Returns: SalBoolean. True on success; false when a COM error is recorded with AutoErrorMode disabled.

Instance member PropSetType(Type)

Assigns the picture type code on the attached OLE interface.

ParameterTypeDescription
TypeSalNumberThe picture type code to assign.

Returns: SalBoolean. True on success; false when a COM error is recorded with AutoErrorMode disabled.

Instance member PropSetWidth(Width)

Assigns the picture width in HIMETRIC units on the attached OLE interface.

ParameterTypeDescription
WidthSalNumberThe picture width in HIMETRIC units to assign.

Returns: SalBoolean. True on success; false when a COM error is recorded with AutoErrorMode disabled.

Instance member Render(hdc, x, y, cx, cy, xSrc, ySrc, cxSrc, cySrc, prcWBounds)

Renders a source region of the OLE picture into a destination device context.

ParameterTypeDescription
hdcSalNumberThe destination device context handle.
xSalNumberThe destination left coordinate in device-context units.
ySalNumberThe destination top coordinate in device-context units.
cxSalNumberThe destination width in device-context units.
cySalNumberThe destination height in device-context units.
xSrcSalNumberThe source left coordinate in HIMETRIC units.
ySrcSalNumberThe source top coordinate in HIMETRIC units.
cxSrcSalNumberThe source width in HIMETRIC units.
cySrcSalNumberThe source height in HIMETRIC units.
prcWBoundsSalNumberThe bounds pointer value passed to the COM interface as a 32-bit integer.

Returns: SalBoolean. True after the COM call succeeds; false when a COM error is recorded with automatic error propagation disabled.

Inherited By

NameDescription
stdole_StdPictureWraps the standard OLE picture coclass for activation and SAL-compatible access.