CWinFormsControl – třída
Poskytuje základní funkce pro hostování ovládacího prvku model Windows Forms.
Syntaxe
template<class TManagedControl>
class CWinFormsControl : public CWnd
Parametry
TManagedControl
Ovládací prvek model Windows Forms rozhraní .NET Framework, který se má zobrazit v aplikaci MFC.
Členové
Veřejné konstruktory
Název | Popis |
---|---|
CWinFormsControl::CWinFormsControl | Vytvoří objekt obálky ovládacího prvku MFC model Windows Forms. |
Veřejné metody
Název | Popis |
---|---|
CWinFormsControl::CreateManagedControl | Vytvoří ovládací prvek model Windows Forms v kontejneru MFC. |
CWinFormsControl::GetControl | Načte ukazatel na ovládací prvek model Windows Forms. |
CWinFormsControl::GetControlHandle | Načte popisovač do ovládacího prvku model Windows Forms. |
Veřejné operátory
Název | Popis |
---|---|
CWinFormsControl::operator -> |
Nahradí CWinFormsControl::GetControl ve výrazech. |
CWinFormsControl::operator TManagedControl^ | Přetypuje typ jako ukazatel na ovládací prvek model Windows Forms. |
Poznámky
Třída CWinFormsControl
poskytuje základní funkce pro hostování model Windows Forms ovládacího prvku.
Další informace o používání model Windows Forms naleznete v tématu Použití uživatelského ovládacího prvku Windows Form v prostředí MFC.
Kód MFC by neměl ukládat popisovače oken do mezipaměti (obvykle uložené v m_hWnd
). Některé model Windows Forms vlastnosti ovládacího prvku vyžadují, aby základní Win32 Window
bylo zničeno a znovu vytvořeno pomocí DestroyWindow
a CreateWindow
. Mfc model Windows Forms implementace zpracovává Destroy
události ovládacích prvků a Create
aktualizuje členam_hWnd
.
Poznámka:
Integrace model Windows Forms MFC funguje jenom v projektech, které dynamicky propojuje s mfc (ve kterém je definovánA AFXDLL).
Požadavky
Hlavička: afxwinforms.h
CWinFormsControl::CreateManagedControl
Vytvoří ovládací prvek model Windows Forms v kontejneru MFC.
inline BOOL CreateManagedControl(
System::Type^ pType,
DWORD dwStyle,
const RECT& rect,
CWnd* pParentWnd,
int nID)
inline BOOL CreateManagedControl(
DWORD dwStyle,
const RECT& rect,
CWnd* pParentWnd,
int nID);
inline BOOL CreateManagedControl(
DWORD dwStyle,
int nPlaceHolderID,
CWnd* pParentWnd);
inline BOOL CreateManagedControl(
typename TManagedControl^ pControl,
DWORD dwStyle,
const RECT& rect,
CWnd* pParentWnd,
int nID);
Parametry
pType
Datový typ ovládacího prvku, který se má vytvořit. Musí to být datový typ.
dwStyle
Styl okna, který se má použít u ovládacího prvku. Zadejte kombinaci stylů oken. V současné době jsou podporovány pouze následující styly: WS_TABSTOP, WS_VISIBLE, WS_DISABLED a WS_GROUP.
Rect
STRUKTURA RECT, která definuje souřadnice levého horního a pravého dolního rohu ovládacího prvku (pouze první přetížení).
nPlaceHolderID
Popisovač ovládacího prvku statického držáku místa umístěný v Editoru prostředků. Nově vytvořený model Windows Forms ovládací prvek nahradí statický ovládací prvek za předpokladu, že má pozici, pořadí vykreslování a styly (pouze druhé přetížení).
pParentWnd
Ukazatel na nadřazené okno.
Nid
Číslo ID prostředku, které se má přiřadit k nově vytvořenému ovládacímu prvku.
pControl
Instance model Windows Forms ovládacího prvku, který má být přidružen k CWinFormsControl objekt (čtvrté přetížení pouze).
Návratová hodnota
V případě úspěchu vrátí nenulovou hodnotu. V případě neúspěchu vrátí hodnotu nula.
Poznámky
Tato metoda vytvoří instanci ovládacího prvku .NET Framework model Windows Forms v kontejneru MFC.
První přetížení metody přijímá datový typ rozhraní .NET Framework pType , aby MFC mohl vytvořit instanci nového objektu tohoto typu. pType musí být datový typ typu .
Druhé přetížení metody vytvoří model Windows Forms ovládací prvek na TManagedControl
základě parametru CWinFormsControl
šablony třídy. Velikost a umístění ovládacího prvku je založená na RECT
struktuře předané metodě. Jen dwStyle záleží na stylech.
Třetí přetížení metody vytvoří model Windows Forms ovládací prvek, který nahradí statický ovládací prvek, zničí ho a za předpokladu, že jeho pozice, pořadí z a styly. Statický ovládací prvek slouží pouze jako zástupný symbol pro ovládací prvek model Windows Forms. Při vytváření ovládacího prvku toto přetížení kombinuje styly z dwStyle se styly prostředků statického ovládacího prvku.
Čtvrté přetížení metody umožňuje předat již vytvoření instance model Windows Forms ovládací prvek pControl, který MFC zabalí. Musí být stejného typu jako TManagedControl
parametr CWinFormsControl
šablony třídy.
Viz Použití uživatelského ovládacího prvku Windows Form v prostředí MFC pro ukázky použití ovládacích prvků Windows Form.
CWinFormsControl::CWinFormsControl
Vytvoří objekt obálky ovládacího prvku MFC model Windows Forms.
CWinFormsControl();
Poznámky
Při volání CWinFormsControl::CreateManagedControl se vytvoří instance ovládacího prvku model Windows Forms.
CWinFormsControl::GetControl
Načte ukazatel na ovládací prvek model Windows Forms.
inline TManagedControl^ GetControl() const;
Návratová hodnota
Vrátí ukazatel na ovládací prvek model Windows Forms.
Příklad
Viz CWinFormsControl::CreateManagedControl.
CWinFormsControl::GetControlHandle
Načte popisovač do ovládacího prvku model Windows Forms.
inline HWND GetControlHandle() const;
Návratová hodnota
Vrátí popisovač ovládacího prvku model Windows Forms.
Poznámky
GetControlHandle
je pomocná metoda, která vrací popisovač okna uložený ve vlastnostech ovládacího prvku rozhraní .NET Framework. Hodnota popisovače okna se zkopíruje do CWnd::m_hWnd během volání CWnd::Attach.
CWinFormsControl::operator ->
Nahradí CWinFormsControl::GetControl ve výrazech.
inline TManagedControl^ operator->() const;
Poznámky
Tento operátor poskytuje pohodlnou syntaxi, která nahrazuje GetControl
výrazy.
Další informace o model Windows Forms naleznete v tématu Použití uživatelského ovládacího prvku Windows Form v prostředí MFC.
CWinFormsControl::operator TManagedControl^
Přetypuje typ jako ukazatel na ovládací prvek model Windows Forms.
inline operator TManagedControl^() const;
Poznámky
Tento operátor předává CWinFormsControl<TManagedControl>
funkce, které přijímají ukazatel na ovládací prvek model Windows Forms.