Класс 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.