Sdílet prostřednictvím


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.

Viz také

CWinFormsDialog – třída
CWinFormsView – třída