NativeWindow.CreateHandle(CreateParams) Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Cria uma janela e sua alça com os parâmetros de criação especificados.
public:
virtual void CreateHandle(System::Windows::Forms::CreateParams ^ cp);public virtual void CreateHandle (System.Windows.Forms.CreateParams cp);abstract member CreateHandle : System.Windows.Forms.CreateParams -> unit
override this.CreateHandle : System.Windows.Forms.CreateParams -> unitPublic Overridable Sub CreateHandle (cp As CreateParams)Parâmetros
- cp
- CreateParams
Um CreateParams que especifica os parâmetros de criação para essa janela.
Exceções
O sistema operacional ficou sem recursos ao tentar criar a janela nativa.
A API do Windows nativa não pôde criar a janela especificada.
A alça da janela nativa atual já foi atribuída. A explicação é que a propriedade Handle não é igual a Zero.
Exemplos
O exemplo de código a seguir demonstra a criação de uma janela com um nome de classe de janela do sistema operacional específico. O exemplo cria uma classe que herda de NativeWindow para fazer isso.
A MyNativeWindow classe cria uma nova janela com o ClassName definido BUTTONcomo . Isso cria uma janela de botão do Win32. O local e o tamanho do botão são definidos, juntamente com a especificação de estilos de janela adicionais. A classe demonstra como usar o CreateHandle método e substituir o WndProc método para interceptar mensagens de janela recebidas. Embora o exemplo procure a mensagem WM_ACTIVATEAPP, isso pode ser substituído em um programa real por mensagens de janela específicas para o tipo criado.
Observação
Alguns tipos de controle enviam suas mensagens de janela para o pai da janela em vez da janela. Consulte o SDK da Plataforma Windows para obter mais informações.
// MyNativeWindow class to create a window given a class name.
ref class MyNativeWindow: public NativeWindow
{
private:
// Constant values were found in the S"windows.h" header file.
literal int WS_CHILD = 0x40000000,WS_VISIBLE = 0x10000000,WM_ACTIVATEAPP = 0x001C;
int windowHandle;
public:
MyNativeWindow( Form^ parent )
{
CreateParams^ cp = gcnew CreateParams;
// Fill in the CreateParams details.
cp->Caption = "Click here";
cp->ClassName = "Button";
// Set the position on the form
cp->X = 100;
cp->Y = 100;
cp->Height = 100;
cp->Width = 100;
// Specify the form as the parent.
cp->Parent = parent->Handle;
// Create as a child of the specified parent
cp->Style = WS_CHILD | WS_VISIBLE;
// Create the actual window
this->CreateHandle( cp );
}
protected:
// Listen to when the handle changes to keep the variable in sync
virtual void OnHandleChange() override
{
windowHandle = (int)this->Handle;
}
virtual void WndProc( Message % m ) override
{
// Listen for messages that are sent to the button window. Some messages are sent
// to the parent window instead of the button's window.
switch ( m.Msg )
{
case WM_ACTIVATEAPP:
// Do something here in response to messages
break;
}
NativeWindow::WndProc( m );
}
};
// MyNativeWindow class to create a window given a class name.
internal class MyNativeWindow : NativeWindow
{
// Constant values were found in the "windows.h" header file.
private const int WS_CHILD = 0x40000000,
WS_VISIBLE = 0x10000000,
WM_ACTIVATEAPP = 0x001C;
private int windowHandle;
public MyNativeWindow(Form parent)
{
CreateParams cp = new CreateParams();
// Fill in the CreateParams details.
cp.Caption = "Click here";
cp.ClassName = "Button";
// Set the position on the form
cp.X = 100;
cp.Y = 100;
cp.Height = 100;
cp.Width = 100;
// Specify the form as the parent.
cp.Parent = parent.Handle;
// Create as a child of the specified parent
cp.Style = WS_CHILD | WS_VISIBLE;
// Create the actual window
this.CreateHandle(cp);
}
// Listen to when the handle changes to keep the variable in sync
protected override void OnHandleChange()
{
windowHandle = (int)this.Handle;
}
protected override void WndProc(ref Message m)
{
// Listen for messages that are sent to the button window. Some messages are sent
// to the parent window instead of the button's window.
switch (m.Msg)
{
case WM_ACTIVATEAPP:
// Do something here in response to messages
break;
}
base.WndProc(ref m);
}
}
' MyNativeWindow class to create a window given a class name.
<System.Security.Permissions.PermissionSetAttribute(System.Security.Permissions.SecurityAction.Demand, Name:="FullTrust")> _
Friend Class MyNativeWindow
Inherits NativeWindow
' Constant values were found in the "windows.h" header file.
Private Const WS_CHILD As Integer = &H40000000, _
WS_VISIBLE As Integer = &H10000000, _
WM_ACTIVATEAPP As Integer = &H1C
Private windowHandle As Integer
Public Sub New(ByVal parent As Form)
Dim cp As CreateParams = New CreateParams()
' Fill in the CreateParams details.
cp.Caption = "Click here"
cp.ClassName = "Button"
' Set the position on the form
cp.X = 100
cp.Y = 100
cp.Height = 100
cp.Width = 100
' Specify the form as the parent.
cp.Parent = parent.Handle
' Create as a child of the specified parent
cp.Style = WS_CHILD Or WS_VISIBLE
' Create the actual window
Me.CreateHandle(cp)
End Sub
' Listen to when the handle changes to keep the variable in sync
<System.Security.Permissions.PermissionSetAttribute(System.Security.Permissions.SecurityAction.Demand, Name:="FullTrust")> _
Protected Overrides Sub OnHandleChange()
windowHandle = Me.Handle.ToInt32()
End Sub
<System.Security.Permissions.PermissionSetAttribute(System.Security.Permissions.SecurityAction.Demand, Name:="FullTrust")> _
Protected Overrides Sub WndProc(ByRef m As Message)
' Listen for messages that are sent to the button window. Some messages are sent
' to the parent window instead of the button's window.
Select Case (m.Msg)
Case WM_ACTIVATEAPP
' Do something here in response to messages
End Select
MyBase.WndProc(m)
End Sub
End Class
Comentários
O cp parâmetro especifica os valores que são passados para o método Win32 CreateWindowEx nativo para criar uma janela e seu identificador.
Quando o ClassName campo não nullé , o identificador de janela recém-criado herda da classe especificada. Por exemplo, se ClassName for definido BUTTONcomo , a janela recém-criada será baseada na classe de janela Win32 BUTTON . A Param propriedade do ClassName objeto deve ser null ou referenciar uma instância de uma classe que foi declarada como uma estrutura.
Esse código é um trecho do exemplo mostrado na visão geral da NativeWindow classe. Alguns códigos não são mostrados para fins de brevidade. Consulte NativeWindow para obter a listagem de código inteira.
Observação
O nome da classe fornecido é registrado no sistema operacional.
