Freigeben über


ITfLangBarItemButton::GetIcon-Methode (ctfutb.h)

Ruft das Symbol ab, das für die Schaltfläche der Sprachleiste angezeigt werden soll.

Syntax

HRESULT GetIcon(
  [out] HICON *phIcon
);

Parameter

[out] phIcon

Zeiger auf einen HICON-Wert , der das Symbolhandle empfängt. Empfängt NULL , wenn die Schaltfläche kein Symbol enthält. Der Aufrufer muss dieses Symbol freigeben, wenn es nicht mehr benötigt wird, indem DestroyIcon aufgerufen wird.

Rückgabewert

Diese Methode kann einen dieser Werte zurückgeben.

Wert BESCHREIBUNG
S_OK
Die Methode war erfolgreich.
E_INVALIDARG
phIcon ist ungültig.

Hinweise

Die ideale Größe des Symbols kann durch Aufrufen von GetSystemMetrics(SM_CXSMICON) für die Symbolbreite und GetSystemMetrics(SM_CYSMICON) für die Symbolhöhe abgerufen werden.

Wenn die Schaltfläche über das TF_LBI_STYLE_TEXTCOLORICON-Format verfügt, sollte das von dieser Methode abgerufene Symbol ein monochromes Symbol sein.

Anforderungen

   
Unterstützte Mindestversion (Client) Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows 2000 Server [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile ctfutb.h
DLL Msctf.dll
Verteilbare Komponente TSF 1.0 unter Windows 2000 Professional