Klasse „CStockPropImpl“

Diese Klasse bietet Methoden zur Unterstützung vordefinierter Eigenschaftswerte.

Wichtig

Diese Klasse und ihre Member können nicht in Anwendungen verwendet werden, die in der Windows-Runtime ausgeführt werden.

Syntax

template <
    class T,
    class InterfaceName,
    const IID* piid = &_ATL_IIDOF(InterfaceName),
    const GUID* plibid = &CComModule::m_libid,
    WORD wMajor = 1,
    WORD wMinor = 0,
    class tihclass = CcomTypeInfoHolder>
class ATL_NO_VTABLE CStockPropImpl :
    public IDispatchImpl<InterfaceName, piid, plibid, wMajor, wMinor, tihclass>

Parameter

T
Die Klasse, die das Steuerelement implementiert und von CStockPropImpl abgeleitet wird.

InterfaceName
Eine Schnittstelle, die die vordefinierten Eigenschaften verfügbar machen kann.

piid
Ein Zeiger auf die IID von InterfaceName.

plibid
Ein Zeiger auf die LIBID der Typbibliothek, die die Definition von InterfaceName enthält.

wMajor
Die Hauptversion der Typbibliothek Der Standardwert ist 1.

wMinor
Die Nebenversion der Typbibliothek Der Standardwert ist 0.

tihclass
Die Klasse, die zum Verwalten der Typinformationen für T verwendet wird. Der Standardwert ist CComTypeInfoHolder.

Member

Öffentliche Methoden

Name Beschreibung
get_Appearance Diese Methode gibt den vom Steuerelement verwendeten Farbstil zurück, z. B. flach oder 3D.
get_AutoSize Diese Methode gibt den Status des Flags zurück, das angibt, ob das Steuerelement keine andere Größe haben kann.
get_BackColor Diese Methode gibt die Hintergrundfarbe des Steuerelements zurück.
get_BackStyle Diese Methode gibt den Hintergrundstil des Steuerelements zurück, entweder transparent oder opak.
get_BorderColor Diese Methode gibt die Rahmenfarbe des Steuerelements zurück.
get_BorderStyle Diese Methode gibt den Rahmenstil des Steuerelements zurück.
get_BorderVisible Diese Methode gibt den Status des Flags zurück, das angibt, ob der Rahmen des Steuerelements sichtbar ist.
get_BorderWidth Diese Methode gibt die Breite (in Pixel) des Rahmens des Steuerelements zurück.
get_Caption Diese Methode gibt den in der Beschriftung eines Objekts angegebenen Text zurück.
get_DrawMode Diese Methode gibt den Zeichnungsmodus des Steuerelements zurück, z. B. XOR-Stift oder Farben umkehren.
get_DrawStyle Diese Methode gibt den Zeichnungsstil des Steuerelements zurück, z. B. durchgezogen, gestrichelt oder gepunktet.
get_DrawWidth Diese Methode gibt die Zeichnungsbreite (in Pixel) zurück, die von den Zeichnungsmethoden des Steuerelements verwendet wird.
get_Enabled Diese Methode gibt den Status des Flags zurück, das angibt, ob das Steuerelement aktiviert ist.
get_FillColor Diese Methode gibt die Füllfarbe des Steuerelements zurück.
get_FillStyle Diese Methode gibt den Füllstil des Steuerelements zurück, z. B. Volltonfarbe, transparent oder schraffiert.
get_Font Diese Methode gibt einen Zeiger auf die Schriftarteigenschaften des Steuerelements zurück.
get_ForeColor Diese Methode gibt die Vordergrundfarbe des Steuerelements zurück.
get_HWND Diese Methode gibt das Fensterhandle zurück, das dem Steuerelement zugeordnet ist.
get_MouseIcon Diese Methode gibt die Bildeigenschaften der Grafik (Symbol, Bitmap oder Metadatei) zurück, die angezeigt werden soll, wenn sich der Mauszeiger über dem Steuerelement befindet.
get_MousePointer Diese Methode gibt den Typ des Mauszeigers zurück, der angezeigt wird, wenn sich die Maus über dem Steuerelement befindet, z. B. Pfeil, Kreuz oder Sanduhr.
get_Picture Diese Methode gibt einen Zeiger auf die Bildeigenschaften einer Grafik (Symbol, Bitmap oder Metadatei) zurück, die angezeigt werden soll.
get_ReadyState Diese Methode gibt den Bereitheitszustand des Steuerelements zurück, z. B. ladend oder geladen.
get_TabStop Diese Methode gibt das Flag zurück, das angibt, ob das Steuerelement ein Tabstopp ist.
get_Text Diese Methode gibt den Text zurück, der mit dem Steuerelement angezeigt wird.
getvalid Diese Methode gibt den Status des Flags zurück, das angibt, ob das Steuerelement gültig ist.
get_Window Diese Methode gibt das Fensterhandle zurück, das dem Steuerelement zugeordnet ist. Identisch mit CStockPropImpl::get_HWND.
put_Appearance Diese Methode legt den vom Steuerelement verwendeten Farbstil fest, z. B. flach oder 3D.
put_AutoSize Diese Methode legt den Wert des Flags fest, das angibt, ob das Steuerelement keine andere Größe haben kann.
put_BackColor Diese Methode legt die Hintergrundfarbe des Steuerelements fest.
put_BackStyle Diese Methode legt den Hintergrundstil des Steuerelements fest.
put_BorderColor Diese Methode legt die Rahmenfarbe des Steuerelements fest.
put_BorderStyle Diese Methode legt die Rahmenfarbe des Steuerelements fest.
put_BorderVisible Diese Methode legt den Wert des Flags fest, das angibt, ob der Rahmen des Steuerelements sichtbar ist.
put_BorderWidth Diese Methode legt die Rahmenbreite des Steuerelements fest.
put_Caption Diese Methode legt den Text fest, der mit dem Steuerelement angezeigt wird.
put_DrawMode Diese Methode legt den Zeichnungsmodus des Steuerelements fest, z. B. XOR-Stift oder Farben umkehren.
put_DrawStyle Diese Methode legt den Zeichnungsstil des Steuerelements fest, z. B. durchgezogen, gestrichelt oder gepunktet.
put_DrawWidth Diese Methode legt die Zeichnungsbreite (in Pixel) fest, die von den Zeichnungsmethoden des Steuerelements verwendet wird.
put_Enabled Diese Methode legt den Status des Flags fest, das angibt, ob das Steuerelement aktiviert ist.
put_FillColor Diese Methode legt die Füllfarbe des Steuerelements fest.
put_FillStyle Diese Methode legt den Füllstil des Steuerelements fest, z. B. Volltonfarbe, transparent oder schraffiert.
put_Font Diese Methode legt die Schriftarteigenschaften des Steuerelements fest.
put_ForeColor Diese Methode legt die Vordergrundfarbe des Steuerelements fest.
put_HWND Diese Methode gibt E_FAIL zurück.
put_MouseIcon Diese Methode legt die Bildeigenschaften der Grafik (Symbol, Bitmap oder Metadatei) fest, die angezeigt werden soll, wenn sich der Mauszeiger über dem Steuerelement befindet.
put_MousePointer Diese Methode legt den Typ des Mauszeigers fest, der angezeigt wird, wenn sich die Maus über dem Steuerelement befindet, z. B. Pfeil, Kreuz oder Sanduhr.
put_Picture Diese Methode legt einen Zeiger auf die Bildeigenschaften einer Grafik (Symbol, Bitmap oder Metadatei) fest, die angezeigt werden soll.
put_ReadyState Diese Methode legt den Bereitheitszustand des Steuerelements fest, z. B. ladend oder geladen.
put_TabStop Diese Methode legt den Status des Flags fest, das angibt, ob das Steuerelement ein Tabstopp ist.
put_Text Diese Methode legt den Text fest, der mit dem Steuerelement angezeigt wird.
putvalid Diese Methode legt den Status des Flags fest, das angibt, ob das Steuerelement gültig ist.
put_Window Diese Methode ruft CStockPropImpl::put_HWND auf, die E_FAIL zurückgibt.
putref_Font Diese Methode legt die Schriftarteigenschaften des Steuerelements fest und hat einen Referenzzähler.
putref_MouseIcon Diese Methode legt die Bildeigenschaften der Grafik (Symbol, Bitmap oder Metadatei) fest, die angezeigt werden soll, wenn sich der Mauszeiger über dem Steuerelement befindet und hat einen Referenzzähler.
putref_Picture Diese Methode legt einen Zeiger auf die Bildeigenschaften einer Grafik (Symbol, Bitmap oder Metadatei) fest, die angezeigt werden soll und hat einen Referenzzähler.

Hinweise

CStockPropImpl stellt put- and get-Methoden für alle vordefinierten Eigenschaften bereit. Diese Methoden stellen den Code zum Festlegen oder Abrufen des Datenmembers bereit, der der jeweiligen Eigenschaft zugeordnet ist, sowie zum Benachrichtigen und Synchronisieren mit dem Container, wenn sich eine Eigenschaft ändert.

Visual Studio bietet mittels Assistenten Unterstützung für vordefinierte Eigenschaften. Weitere Informationen zum Hinzufügen von Bestandseigenschaften zu einem Steuerelement finden Sie im ATL-Tutorial.

Aus Gründen der Abwärtskompatibilität macht CStockPropImpl auch die Methoden get_Window und put_Window verfügbar, die einfach get_HWND bzw. put_HWND aufrufen. Die Standardimplementierung von put_HWND gibt E_FAIL zurück, da HWND eine schreibgeschützte Eigenschaft sein sollte.

Die folgenden Eigenschaften verfügen auch über eine putref-Implementierung:

  • Font

  • MouseIcon

  • Bild

Die gleichen drei vordefinierten Eigenschaften erfordern, dass ihr jeweiliger Datenmember vom Typ CComPtr oder eine andere Klasse ist, die eine korrekte Schnittstellenreferenzzählung durch den Zuweisungsoperator bietet.

Vererbungshierarchie

T

IDispatchImpl

CStockPropImpl

Anforderungen

Header: atlctl.h

CStockPropImpl::get_Appearance

Diese Methode gibt den vom Steuerelement verwendeten Farbstil zurück, z. B. flach oder 3D.

HRESULT STDMETHODCALLTYPE get_Appearance(SHORT pnAppearance);

Parameter

pnAppearance
Variable für den Farbstil des Steuerelements.

Rückgabewert

S_OK bei Erfolg, ein HRESULT-Fehler bei einem Fehlschlag.

.CStockPropImpl::get_AutoSize

Diese Methode gibt den Status des Flags zurück, das angibt, ob das Steuerelement keine andere Größe haben kann.

HRESULT STDMETHODCALLTYPE get_Autosize(VARIANT_BOOL* pbAutoSize);

Parameter

pbAutoSize
Variable für den Flag-Status. TRUE gibt an, dass das Steuerelement keine andere Größe haben darf.

Rückgabewert

S_OK bei Erfolg, ein HRESULT-Fehler bei einem Fehlschlag.

CStockPropImpl::get_BackColor

Diese Methode gibt die Hintergrundfarbe des Steuerelements zurück.

HRESULT STDMETHODCALLTYPE get_BackColor(OLE_COLOR* pclrBackColor);

Parameter

pclrBackColor
Variable für die Hintergrundfarbe des Steuerelements.

Rückgabewert

S_OK bei Erfolg, ein HRESULT-Fehler bei einem Fehlschlag.

CStockPropImpl::get_BackStyle

Diese Methode gibt den Hintergrundstil des Steuerelements zurück, entweder transparent oder opak.

HRESULT STDMETHODCALLTYPE get_BackStyle(LONG* pnBackStyle);

Parameter

pnBackStyle
Variable für den Hintergrundstil des Steuerelements.

Rückgabewert

S_OK bei Erfolg, ein HRESULT-Fehler bei einem Fehlschlag.

CStockPropImpl::get_BorderColor

Diese Methode gibt die Rahmenfarbe des Steuerelements zurück.

HRESULT STDMETHODCALLTYPE get_BorderColor(OLE_COLOR* pclrBorderColor);

Parameter

pclrBorderColor
Variable für die Rahmenfarbe des Steuerelements.

Rückgabewert

S_OK bei Erfolg, ein HRESULT-Fehler bei einem Fehlschlag.

CStockPropImpl::get_BorderStyle

Diese Methode gibt den Rahmenstil des Steuerelements zurück.

HRESULT STDMETHODCALLTYPE get_BorderStyle(LONG* pnBorderStyle);

Parameter

pnBorderStyle
Variable für den Rahmenstil des Steuerelements.

Rückgabewert

S_OK bei Erfolg, ein HRESULT-Fehler bei einem Fehlschlag.

CStockPropImpl::get_BorderVisible

Diese Methode gibt den Status des Flags zurück, das angibt, ob der Rahmen des Steuerelements sichtbar ist.

HRESULT STDMETHODCALLTYPE get_BorderVisible(VARIANT_BOOL* pbBorderVisible);

Parameter

pbBorderVisible
Variable für den Flag-Status. TRUE gibt an, dass der Rahmen des Steuerelements sichtbar ist.

Rückgabewert

S_OK bei Erfolg, ein HRESULT-Fehler bei einem Fehlschlag.

CStockPropImpl::get_BorderWidth

Diese Methode gibt die Breite des Rahmens des Steuerelements zurück.

HRESULT STDMETHODCALLTYPE get_BorderWidth(LONG* pnBorderWidth);

Parameter

pnBorderWidth
Variable für die Rahmenbreite des Steuerelements.

Rückgabewert

S_OK bei Erfolg, ein HRESULT-Fehler bei einem Fehlschlag.

CStockPropImpl::get_Caption

Diese Methode gibt den in der Beschriftung eines Objekts angegebenen Text zurück.

HRESULT STDMETHODCALLTYPE get_Caption(BSTR* pbstrCaption);

Parameter

pbstrCaption
Der Text, der mit dem Steuerelement angezeigt werden soll.

Rückgabewert

S_OK bei Erfolg, ein HRESULT-Fehler bei einem Fehlschlag.

CStockPropImpl::get_DrawMode

Diese Methode gibt den Zeichnungsmodus des Steuerelements zurück, z. B. XOR-Stift oder Farben umkehren.

HRESULT STDMETHODCALLTYPE get_DrawMode(LONG* pnDrawMode);

Parameter

pnDrawMode
Variable für den Zeichnungsmodus des Steuerelements.

Rückgabewert

S_OK bei Erfolg, ein HRESULT-Fehler bei einem Fehlschlag.

CStockPropImpl::get_DrawStyle

Diese Methode gibt den Zeichnungsstil des Steuerelements zurück, z. B. durchgezogen, gestrichelt oder gepunktet.

HRESULT STDMETHODCALLTYPE get_DrawStyle(LONG* pnDrawStyle);

Parameter

pnDrawStyle
Variable für den Zeichnungsstil des Steuerelements.

Rückgabewert

S_OK bei Erfolg, ein HRESULT-Fehler bei einem Fehlschlag.

CStockPropImpl::get_DrawWidth

Diese Methode gibt die Zeichnungsbreite (in Pixel) zurück, die von den Zeichnungsmethoden des Steuerelements verwendet wird.

HRESULT STDMETHODCALLTYPE get_DrawWidth(LONG* pnDrawWidth);

Parameter

pnDrawWidth
Variable für den Breitenwert des Steuerelements in Pixeln.

Rückgabewert

S_OK bei Erfolg, ein HRESULT-Fehler bei einem Fehlschlag.

CStockPropImpl::get_Enabled

Diese Methode gibt den Status des Flags zurück, das angibt, ob das Steuerelement aktiviert ist.

HRESULT STDMETHODCALLTYPE get_Enabled(VARIANT_BOOL* pbEnabled);

Parameter

pbEnabled
Variable für den Flag-Status. TRUE gibt an, dass das Steuerelement aktiviert ist.

Rückgabewert

S_OK bei Erfolg, ein HRESULT-Fehler bei einem Fehlschlag.

CStockPropImpl::get_FillColor

Diese Methode gibt die Füllfarbe des Steuerelements zurück.

HRESULT STDMETHODCALLTYPE get_FillColor(OLE_COLOR* pclrFillColor);

Parameter

pclrFillColor
Variable für die Füllfarbe des Steuerelements.

Rückgabewert

S_OK bei Erfolg, ein HRESULT-Fehler bei einem Fehlschlag.

CStockPropImpl::get_FillStyle

Diese Methode gibt den Füllstil des Steuerelements zurück, z. B. Volltonfarbe, transparent oder schraffiert.

HRESULT STDMETHODCALLTYPE get_FillStyle(LONG* pnFillStyle);

Parameter

pnFillStyle
Variable für den Füllstil des Steuerelements.

Rückgabewert

S_OK bei Erfolg, ein HRESULT-Fehler bei einem Fehlschlag.

CStockPropImpl::get_Font

Diese Methode gibt einen Zeiger auf die Schriftarteigenschaften des Steuerelements zurück.

HRESULT STDMETHODCALLTYPE get_Font(IFontDisp** ppFont);

Parameter

ppFont
Variable für einen Zeiger auf die Schriftarteigenschaften des Steuerelements.

Rückgabewert

S_OK bei Erfolg, ein HRESULT-Fehler bei einem Fehlschlag.

CStockPropImpl::get_ForeColor

Diese Methode gibt die Vordergrundfarbe des Steuerelements zurück.

HRESULT STDMETHODCALLTYPE get_ForeColor(OLE_COLOR* pclrForeColor);

Parameter

pclrForeColor
Variable für die Vordergrundfarbe des Steuerelements.

Rückgabewert

S_OK bei Erfolg, ein HRESULT-Fehler bei einem Fehlschlag.

CStockPropImpl::get_HWND

Diese Methode gibt das Fensterhandle zurück, das dem Steuerelement zugeordnet ist.

HRESULT STDMETHODCALLTYPE get_HWND(LONG_PTR* phWnd);

Parameter

phWnd
Das dem Steuerelement zugeordnete Fensterhandle.

Rückgabewert

S_OK bei Erfolg, ein HRESULT-Fehler bei einem Fehlschlag.

CStockPropImpl::get_MouseIcon

Diese Methode gibt die Bildeigenschaften der Grafik (Symbol, Bitmap oder Metadatei) zurück, die angezeigt werden soll, wenn sich der Mauszeiger über dem Steuerelement befindet.

HRESULT STDMETHODCALLTYPE get_MouseIcon(IPictureDisp** ppPicture);

Parameter

ppPicture
Variable für einen Zeiger auf die Bildeigenschaften der Grafik.

Rückgabewert

S_OK bei Erfolg, ein HRESULT-Fehler bei einem Fehlschlag.

CStockPropImpl::get_MousePointer

Diese Methode gibt den Typ des Mauszeigers zurück, der angezeigt wird, wenn sich die Maus über dem Steuerelement befindet, z. B. Pfeil, Kreuz oder Sanduhr.

HRESULT STDMETHODCALLTYPE get_MousePointer(LONG* pnMousePointer);

Parameter

pnMousePointer
Variable für den Typ des Mauszeigers.

Rückgabewert

S_OK bei Erfolg, ein HRESULT-Fehler bei einem Fehlschlag.

CStockPropImpl::get_Picture

Diese Methode gibt einen Zeiger auf die Bildeigenschaften einer Grafik (Symbol, Bitmap oder Metadatei) zurück, die angezeigt werden soll.

HRESULT STDMETHODCALLTYPE get_Picture(IPictureDisp** ppPicture);

Parameter

ppPicture
Variable für einen Zeiger auf die Eigenschaften des Bilds. Weitere Informationen finden Sie unter IPictureDisp.

Rückgabewert

S_OK bei Erfolg, ein HRESULT-Fehler bei einem Fehlschlag.

CStockPropImpl::get_ReadyState

Diese Methode gibt den Bereitheitszustand des Steuerelements zurück, z. B. ladend oder geladen.

HRESULT STDMETHODCALLTYPE get_ReadyState(LONG* pnReadyState);

Parameter

pnReadyState
Variable für den Bereitheitszustand des Steuerelements.

Rückgabewert

S_OK bei Erfolg, ein HRESULT-Fehler bei einem Fehlschlag.

CStockPropImpl::get_TabStop

Diese Methode gibt den Status des Flags zurück, das angibt, ob das Steuerelement ein Tabstopp ist.

HRESULT STDMETHODCALLTYPE get_TabStop(VARIANT_BOOL* pbTabStop);

Parameter

pbTabStop
Variable für den Flag-Status. TRUE gibt an, dass das Steuerelement ein Tabstopp ist.

Rückgabewert

S_OK bei Erfolg, ein HRESULT-Fehler bei einem Fehlschlag.

CStockPropImpl::get_Text

Diese Methode gibt den Text zurück, der mit dem Steuerelement angezeigt wird.

HRESULT STDMETHODCALLTYPE get_Text(BSTR* pbstrText);

Parameter

pbstrText
Der Text, der mit dem Steuerelement angezeigt wird.

Rückgabewert

S_OK bei Erfolg, ein HRESULT-Fehler bei einem Fehlschlag.

CStockPropImpl::getvalid

Diese Methode gibt den Status des Flags zurück, das angibt, ob das Steuerelement gültig ist.

HRESULT STDMETHODCALLTYPE getvalid(VARIANT_BOOL* pbValid);

Parameter

pbValid
Variable für den Flag-Status. TRUE gibt an, dass das Steuerelement gültig ist.

Rückgabewert

S_OK bei Erfolg, ein HRESULT-Fehler bei einem Fehlschlag.

CStockPropImpl::get_Window

Diese Methode gibt das Fensterhandle zurück, das dem Steuerelement zugeordnet ist. Identisch mit CStockPropImpl::get_HWND.

HRESULT STDMETHODCALLTYPE get_Window(LONG_PTR* phWnd);

Parameter

phWnd
Das dem Steuerelement zugeordnete Fensterhandle.

Rückgabewert

S_OK bei Erfolg, ein HRESULT-Fehler bei einem Fehlschlag.

CStockPropImpl::put_Appearance

Diese Methode legt den vom Steuerelement verwendeten Farbstil fest, z. B. flach oder 3D.

HRESULT STDMETHODCALLTYPE put_Appearance(SHORT nAppearance);

Parameter

nAppearance
Der neue Farbstil, der vom Steuerelement verwendet werden soll.

Rückgabewert

S_OK bei Erfolg, ein HRESULT-Fehler bei einem Fehlschlag.

CStockPropImpl::put_AutoSize

Diese Methode legt den Wert des Flags fest, das angibt, ob das Steuerelement keine andere Größe haben kann.

HRESULT STDMETHODCALLTYPE put_AutoSize(VARIANT_BOOL bAutoSize,);

Parameter

bAutoSize
TRUE, wenn das Steuerelement keine andere Größe haben kann.

Rückgabewert

S_OK bei Erfolg, ein HRESULT-Fehler bei einem Fehlschlag.

CStockPropImpl::put_BackColor

Diese Methode legt die Hintergrundfarbe des Steuerelements fest.

HRESULT STDMETHODCALLTYPE put_BackColor(OLE_COLOR clrBackColor);

Parameter

clrBackColor
Die neue Hintergrundfarbe des Steuerelements.

Rückgabewert

S_OK bei Erfolg, ein HRESULT-Fehler bei einem Fehlschlag.

CStockPropImpl::put_BackStyle

Diese Methode legt den Hintergrundstil des Steuerelements fest.

HRESULT STDMETHODCALLTYPE put_BackStyle(LONG nBackStyle);

Parameter

nBackStyle
Der neue Hintergrundstil des Steuerelements.

Rückgabewert

S_OK bei Erfolg, ein HRESULT-Fehler bei einem Fehlschlag.

CStockPropImpl::put_BorderColor

Diese Methode legt die Rahmenfarbe des Steuerelements fest.

HRESULT STDMETHODCALLTYPE put_BorderColor(OLE_COLOR clrBorderColor);

Parameter

clrBorderColor
Die neue Rahmenfarbe. Der Datentyp OLE_COLOR wird intern als 32-Bit-Long Integer dargestellt.

Rückgabewert

S_OK bei Erfolg, ein HRESULT-Fehler bei einem Fehlschlag.

CStockPropImpl::put_BorderStyle

Diese Methode legt die Rahmenfarbe des Steuerelements fest.

HRESULT STDMETHODCALLTYPE put_BorderStyle(LONG nBorderStyle);

Parameter

nBorderStyle
Der neue Rahmenstil.

Rückgabewert

S_OK bei Erfolg, ein HRESULT-Fehler bei einem Fehlschlag.

CStockPropImpl::put_BorderVisible

Diese Methode legt den Wert des Flags fest, das angibt, ob der Rahmen des Steuerelements sichtbar ist.

HRESULT STDMETHODCALLTYPE put_BorderVisible(VARIANT_BOOL bBorderVisible);

Parameter

bBorderVisible
TRUE, wenn der Rahmen sichtbar sein soll.

Rückgabewert

S_OK bei Erfolg, ein HRESULT-Fehler bei einem Fehlschlag.

CStockPropImpl::put_BorderWidth

Diese Methode legt die Rahmenbreite des Steuerelements fest.

HRESULT STDMETHODCALLTYPE put_BorderWidth(LONG nBorderWidth);

Parameter

nBorderWidth
Die neue Breite des Rahmens des Steuerelements.

Rückgabewert

S_OK bei Erfolg, ein HRESULT-Fehler bei einem Fehlschlag.

CStockPropImpl::put_Caption

Diese Methode legt den Text fest, der mit dem Steuerelement angezeigt wird.

HRESULT STDMETHODCALLTYPE put_Caption(BSTR bstrCaption);

Parameter

bstrCaption
Der Text, der mit dem Steuerelement angezeigt werden soll.

Rückgabewert

S_OK bei Erfolg, ein HRESULT-Fehler bei einem Fehlschlag.

CStockPropImpl::put_DrawMode

Diese Methode legt den Zeichnungsmodus des Steuerelements fest, z. B. XOR-Stift oder Farben umkehren.

HRESULT STDMETHODCALLTYPE put_DrawMode(LONG nDrawMode);

Parameter

nDrawMode
Der neue Zeichnungsmodus für das Steuerelement.

Rückgabewert

S_OK bei Erfolg, ein HRESULT-Fehler bei einem Fehlschlag.

CStockPropImpl::put_DrawStyle

Diese Methode legt den Zeichnungsstil des Steuerelements fest, z. B. durchgezogen, gestrichelt oder gepunktet.

HRESULT STDMETHODCALLTYPE put_DrawStyle(LONG pnDrawStyle);

Parameter

nDrawStyle
Der neue Zeichnungsstil für das Steuerelement.

Rückgabewert

S_OK bei Erfolg, ein HRESULT-Fehler bei einem Fehlschlag.

CStockPropImpl::put_DrawWidth

Diese Methode legt die Zeichnungsbreite (in Pixel) fest, die von den Zeichnungsmethoden des Steuerelements verwendet wird.

HRESULT STDMETHODCALLTYPE put_DrawWidth(LONG nDrawWidth);

Parameter

nDrawWidth
Die neue Breite, die von den Zeichnungsmethoden des Steuerelements verwendet werden soll.

Rückgabewert

S_OK bei Erfolg, ein HRESULT-Fehler bei einem Fehlschlag.

CStockPropImpl::put_Enabled

Diese Methode legt den Wert des Flags fest, das angibt, ob das Steuerelement aktiviert ist.

HRESULT STDMETHODCALLTYPE put_Enabled(VARIANT_BOOL bEnabled);

Parameter

bEnabled
TRUE, wenn das Steuerelement aktiviert ist.

Rückgabewert

S_OK bei Erfolg, ein HRESULT-Fehler bei einem Fehlschlag.

CStockPropImpl::put_FillColor

Diese Methode legt die Füllfarbe des Steuerelements fest.

HRESULT STDMETHODCALLTYPE put_FillColor(OLE_COLOR clrFillColor);

Parameter

clrFillColor
Die neue Füllfarbe für das Steuerelement.

Rückgabewert

S_OK bei Erfolg, ein HRESULT-Fehler bei einem Fehlschlag.

CStockPropImpl::put_FillStyle

Diese Methode legt den Füllstil des Steuerelements fest, z. B. Volltonfarbe, transparent oder schraffiert.

HRESULT STDMETHODCALLTYPE put_FillStyle(LONG nFillStyle);

Parameter

nFillStyle
Der neue Füllstil für das Steuerelement.

Rückgabewert

S_OK bei Erfolg, ein HRESULT-Fehler bei einem Fehlschlag.

CStockPropImpl::put_Font

Diese Methode legt die Schriftarteigenschaften des Steuerelements fest.

HRESULT STDMETHODCALLTYPE put_Font(IFontDisp* pFont);

Parameter

pFont
Ein Zeiger auf die Schriftarteigenschaften des Steuerelements.

Rückgabewert

S_OK bei Erfolg, ein HRESULT-Fehler bei einem Fehlschlag.

CStockPropImpl::put_ForeColor

Diese Methode legt die Vordergrundfarbe des Steuerelements fest.

HRESULT STDMETHODCALLTYPE put_ForeColor(OLE_COLOR clrForeColor);

Parameter

clrForeColor
Die neue Vordergrundfarbe des Steuerelements.

Rückgabewert

S_OK bei Erfolg, ein HRESULT-Fehler bei einem Fehlschlag.

CStockPropImpl::put_HWND

Diese Methode gibt E_FAIL zurück.

HRESULT STDMETHODCALLTYPE put_HWND(LONG_PTR /* hWnd */);

Parameter

hWnd
Reserviert.

Rückgabewert

Gibt E_FAIL zurück.

Hinweise

Das Fensterhandle ist ein schreibgeschützter Wert.

CStockPropImpl::put_MouseIcon

Diese Methode legt die Bildeigenschaften der Grafik (Symbol, Bitmap oder Metadatei) fest, die angezeigt werden soll, wenn sich der Mauszeiger über dem Steuerelement befindet.

HRESULT STDMETHODCALLTYPE put_MouseIcon(IPictureDisp* pPicture);

Parameter

pPicture
Ein Zeiger auf die Bildeigenschaften der Grafik.

Rückgabewert

S_OK bei Erfolg, ein HRESULT-Fehler bei einem Fehlschlag.

CStockPropImpl::put_MousePointer

Diese Methode legt den Typ des Mauszeigers fest, der angezeigt wird, wenn sich die Maus über dem Steuerelement befindet, z. B. Pfeil, Kreuz oder Sanduhr.

HRESULT STDMETHODCALLTYPE put_MousePointer(LONG nMousePointer);

Parameter

nMousePointer
Der Typ des Mauszeigers.

Rückgabewert

S_OK bei Erfolg, ein HRESULT-Fehler bei einem Fehlschlag.

CStockPropImpl::put_Picture

Diese Methode legt einen Zeiger auf die Bildeigenschaften einer Grafik (Symbol, Bitmap oder Metadatei) fest, die angezeigt werden soll.

HRESULT STDMETHODCALLTYPE put_Picture(IPictureDisp* pPicture);

Parameter

pPicture
Ein Zeiger auf die Eigenschaften des Bilds. Weitere Informationen finden Sie unter IPictureDisp.

Rückgabewert

S_OK bei Erfolg, ein HRESULT-Fehler bei einem Fehlschlag.

CStockPropImpl::put_ReadyState

Diese Methode legt den Bereitheitszustand des Steuerelements fest, z. B. ladend oder geladen.

HRESULT STDMETHODCALLTYPE put_ReadyState(LONG nReadyState);

Parameter

nReadyState
Der Bereitschaftszustand des Steuerelements.

Rückgabewert

S_OK bei Erfolg, ein HRESULT-Fehler bei einem Fehlschlag.

CStockPropImpl::put_TabStop

Diese Methode legt das Flag fest, das angibt, ob das Steuerelement ein Tabstopp ist.

HRESULT STDMETHODCALLTYPE put_TabStop(VARIANT_BOOL bTabStop);

Parameter

bTabStop
TRUE, wenn das Steuerelement ein Tabstopp ist.

Rückgabewert

S_OK bei Erfolg, ein HRESULT-Fehler bei einem Fehlschlag.

CStockPropImpl::put_Text

Diese Methode legt den Text fest, der mit dem Steuerelement angezeigt wird.

HRESULT STDMETHODCALLTYPE put_Text(BSTR bstrText);

Parameter

bstrText
Der Text, der mit dem Steuerelement angezeigt wird.

Rückgabewert

S_OK bei Erfolg, ein HRESULT-Fehler bei einem Fehlschlag.

CStockPropImpl::putvalid

Diese Methode legt den Status des Flags fest, das angibt, ob das Steuerelement gültig ist.

HRESULT STDMETHODCALLTYPE getvalid(VARIANT_BOOL bValid);

Parameter

bValid
TRUE, wenn das Steuerelement gültig ist.

Rückgabewert

S_OK bei Erfolg, ein HRESULT-Fehler bei einem Fehlschlag.

CStockPropImpl::put_Window

Diese Methode ruft CStockPropImpl::put_HWND auf, die E_FAIL zurückgibt.

HRESULT STDMETHODCALLTYPE put_Window(LONG_PTR hWnd);

Parameter

hWnd
Das Fensterhandle.

Rückgabewert

Gibt E_FAIL zurück.

Hinweise

Das Fensterhandle ist ein schreibgeschützter Wert.

CStockPropImpl::putref_Font

Diese Methode legt die Schriftarteigenschaften des Steuerelements fest und hat einen Referenzzähler.

HRESULT STDMETHODCALLTYPE putref_Font(IFontDisp* pFont);

Parameter

pFont
Ein Zeiger auf die Schriftarteigenschaften des Steuerelements.

Rückgabewert

S_OK bei Erfolg, ein HRESULT-Fehler bei einem Fehlschlag.

Hinweise

Identisch mit CStockPropImpl::put_Font, jedoch mit einem Referenzzähler.

CStockPropImpl::putref_MouseIcon

Diese Methode legt die Bildeigenschaften der Grafik (Symbol, Bitmap oder Metadatei) fest, die angezeigt werden soll, wenn sich der Mauszeiger über dem Steuerelement befindet und hat einen Referenzzähler.

HRESULT STDMETHODCALLTYPE putref_MouseIcon(IPictureDisp* pPicture);

Parameter

pPicture
Ein Zeiger auf die Bildeigenschaften der Grafik.

Rückgabewert

S_OK bei Erfolg, ein HRESULT-Fehler bei einem Fehlschlag.

Hinweise

Identisch mit CStockPropImpl::put_MouseIcon, jedoch mit einem Referenzzähler.

CStockPropImpl::putref_Picture

Diese Methode legt einen Zeiger auf die Bildeigenschaften einer Grafik (Symbol, Bitmap oder Metadatei) fest, die angezeigt werden soll und hat einen Referenzzähler.

HRESULT STDMETHODCALLTYPE putref_Picture(IPictureDisp* pPicture);

Parameter

pPicture
Ein Zeiger auf die Eigenschaften des Bilds. Weitere Informationen finden Sie unter IPictureDisp.

Rückgabewert

S_OK bei Erfolg, ein HRESULT-Fehler bei einem Fehlschlag.

Hinweise

Identisch mit CStockPropImpl::put_Picture, jedoch mit einem Referenzzähler.

Siehe auch

Klassenübersicht
IDispatchImpl-Klasse