Класс CWinFormsControl

Предоставляет базовую функцию для размещения элементов управления Windows Forms.

Синтаксис

template<class TManagedControl>
class CWinFormsControl : public CWnd

Параметры

TManagedControl
Элемент управления платформа .NET Framework Windows Forms, отображаемый в приложении MFC.

Участники

Открытые конструкторы

Имя	Описание
CWinFormsControl::CWinFormsControl	Создает объект оболочки элемента управления MFC Windows Forms.

Открытые методы

Имя	Описание
CWinFormsControl::CreateManagedControl	Создает элемент управления Windows Forms в контейнере MFC.
CWinFormsControl::GetControl	Извлекает указатель на элемент управления Windows Forms.
CWinFormsControl::GetControlHandle	Извлекает дескриптор элемента управления Windows Forms.

Открытые операторы

Имя	Описание
CWinFormsControl::operator ->	Заменяет CWinFormsControl::GetControl в выражениях.
CWinFormsControl::operator TManagedControl^	Приведение типа в качестве указателя на элемент управления Windows Forms.

Замечания

Класс CWinFormsControl предоставляет основные функции для размещения элемента управления Windows Forms.

Дополнительные сведения об использовании Windows Forms см. в разделе "Использование пользовательского элемента управления Windows Form" в MFC.

Код MFC не должен кэшировать дескриптор окна (обычно хранится в m_hWnd). Для некоторых свойств элемента управления Windows Forms требуется, чтобы базовый win32 Window был уничтожен и повторно создан с помощью DestroyWindow и CreateWindow. Реализация Windows Forms MFC обрабатывает Destroy и Create события элементов управления для обновления m_hWnd элемента.

Примечание.

Интеграция Windows Forms MFC работает только в проектах, которые динамически связываются с MFC (в котором определен AFXDLL).

Требования

Заголовок: afxwinforms.h

CWinFormsControl::CreateManagedControl

Создает элемент управления Windows Forms в контейнере 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);

Параметры

pType
Тип данных создаваемого элемента управления. Должен быть типом данных Type .

dwStyle
Стиль окна, применяемый к элементу управления. Укажите сочетание стилей окон. В настоящее время поддерживаются только следующие стили: WS_TABSTOP, WS_VISIBLE, WS_DISABLED и WS_GROUP.

rect
Структура RECT, определяющая координаты левого и нижнего углов элемента управления (только первая перегрузка).

nPlaceHolderID
Дескриптор элемента управления держателя статического места, помещенного в редактор ресурсов. Созданный элемент управления Windows Forms заменяет статический элемент управления, предполагая его положение, z-порядок и стили (только вторая перегрузка).

pParentWnd
Указатель на родительское окно.

Nid
Номер идентификатора ресурса, назначенный только что созданному элементу управления.

pControl
Экземпляр элемента управления Windows Forms, связанный с объектом CWinFormsControl (только четвертая перегрузка).

Возвращаемое значение

В случае успешного выполнения возвращает ненулевое значение. В случае неудачи возвращается ноль.

Замечания

Этот метод создает экземпляр элемента управления платформа .NET Framework Windows Forms в контейнере MFC.

Первая перегрузка метода принимает pType типа данных платформа .NET Framework, чтобы MFC может создать экземпляр нового объекта этого типа. pType должен быть типом данных типа .

Вторая перегрузка метода создает элемент управления Windows Forms на TManagedControl основе параметра CWinFormsControl шаблона класса. Размер и положение элемента управления основаны на RECT структуре, переданной методу. Только dwStyle имеет значение для стилей.

Третья перегрузка метода создает элемент управления Windows Forms, заменяющий статический элемент управления, уничтожая его и предполагая его положение, z-порядок и стили. Статический элемент управления служит только заполнителем для элемента управления Windows Forms. При создании элемента управления эта перегрузка объединяет стили из dwStyle с стилями ресурсов статического элемента управления.

Четвертая перегрузка метода позволяет передавать уже созданный элемент управления Windows Forms pControl , который MFC будет упаковывать. Он должен иметь тот же тип, что TManagedControl и параметр CWinFormsControl шаблона класса.

Сведения об использовании пользовательского элемента управления Windows Form в MFC см. в примерах с помощью элементов управления Windows Form.

CWinFormsControl::CWinFormsControl

Создает объект оболочки элемента управления MFC Windows Forms.

CWinFormsControl();

Замечания

Элемент управления Windows Forms создается при вызове CWinFormsControl::CreateManagedControl.

CWinFormsControl::GetControl

Извлекает указатель на элемент управления Windows Forms.

inline TManagedControl^ GetControl() const;

Возвращаемое значение

Возвращает указатель на элемент управления Windows Forms.

Пример

См. раздел CWinFormsControl::CreateManagedControl.

CWinFormsControl::GetControlHandle

Извлекает дескриптор элемента управления Windows Forms.

inline HWND GetControlHandle() const;

Возвращаемое значение

Возвращает дескриптор элемента управления Windows Forms.

Замечания

GetControlHandle— вспомогательный метод, который возвращает дескриптор окна, хранящийся в свойствах элемента управления платформа .NET Framework. Значение дескриптора окна копируется в CWnd::m_hWnd во время вызова CWnd::Attach.

CWinFormsControl::operator ->

Заменяет CWinFormsControl::GetControl в выражениях.

inline TManagedControl^  operator->() const;

Замечания

Этот оператор предоставляет удобный синтаксис, который заменяет GetControl выражения.

Дополнительные сведения о Windows Forms см. в разделе "Использование пользовательского элемента управления Windows Form" в MFC.

CWinFormsControl::operator TManagedControl^

Приведение типа в качестве указателя на элемент управления Windows Forms.

inline operator TManagedControl^() const;

Замечания

Этот оператор передает CWinFormsControl<TManagedControl> функции, принимаюющие указатель на элемент управления Windows Forms.

См. также

Класс CWinFormsDialog
Класс CWinFormsView