CreateParams 类
封装创建控件时所需的信息。
**命名空间:**System.Windows.Forms
**程序集:**System.Windows.Forms（在 system.windows.forms.dll 中）
语法
声明
Public Class CreateParams
用法
Dim instance As CreateParams
public class CreateParams
public ref class CreateParams
public class CreateParams
public class CreateParams
备注
CreateParams 中的信息可用于传递有关控件的初始状态和外观的信息。多数 Control 派生控件重写 CreateParams 属性以传递适当的值或在 CreateParams 中包含附加信息。
有关创建控件参数的更多信息，请参见 MSDN Library 中的 Windows Platform SDK 参考中的 CreateWindow 函数、CreateWindowEx 函数以及 CREATESTRUCT 结构文档。
提示
用于设置 Style、ExStyle 和 ClassStyle 属性的常数在 Winuser.h 头文件中定义。由 Platform SDK 或 Visual Studio .NET 安装该文件。
示例
下面的代码示例创建一个名为 MyIconButton 的 Button 派生类，并为该按钮提供显示图标而非图像所需的实现。CreateParams 属性被扩展，并且向可使按钮显示 Icon 而非 Image 的 Style 属性中添加了一个值。
import System.*;
import System.Drawing.*;
import System.Windows.Forms.*;
import System.Runtime.InteropServices.*;
import System.Diagnostics.*;
import System.IO.*;
import System.Security.Permissions.*;
/** @attribute SecurityPermission(SecurityAction.Demand, Flags = SecurityPermissionFlag.UnmanagedCode)
*/
public class MyIconButton extends Button
{
private Icon icon;
public MyIconButton()
{
// Set the button's FlatStyle property.
set_FlatStyle(get_FlatStyle().System);
} //MyIconButton
public MyIconButton(Icon ButtonIcon)
{
// Assign the icon to the private field.
this.icon = ButtonIcon;
// Size the button to 4 pixels larger than the icon.
this.set_Height(icon.get_Height() + 4);
this.set_Width(icon.get_Width() + 4);
} //MyIconButton
/** @property
*/
protected CreateParams get_CreateParams()
{
// Extend the CreateParams property of the Button class.
CreateParams cp = super.get_CreateParams();
// Update the button Style.
cp.set_Style(cp.get_Style() | 0x40); // BS_ICON value
return cp;
} //get_CreateParams
/** @property
*/
public Icon get_Icon()
{
return icon;
} //get_Icon
/** @property
*/
public void set_Icon(Icon value)
{
icon = value;
UpdateIcon();
// Size the button to 4 pixels larger than the icon.
this.set_Height(icon.get_Height() + 4);
this.set_Width(icon.get_Width() + 4);
} //set_Icon
protected void OnHandleCreated(EventArgs e)
{
super.OnHandleCreated(e);
// Update the icon on the button if there is currently an icon assigned
// to the icon field.
if (icon != null) {
UpdateIcon();
}
} //OnHandleCreated
private void UpdateIcon()
{
IntPtr iconHandle = IntPtr.Zero;
// Get the icon's handle.
if (icon != null) {
iconHandle = icon.get_Handle();
}
// Send Windows the message to update the button.
SendMessage(get_Handle(), 0x00F7 /*BM_SETIMAGE value*/,
1 /*IMAGE_ICON value*/, (iconHandle.ToInt32()));
} //UpdateIcon
// Import the SendMessage method of the User32 DLL.
/** @attribute DllImport("user32.dll", CharSet = CharSet.Auto)
*/
public static native IntPtr SendMessage(IntPtr hWnd, int msg,
int wParam, int lParam);
} //MyIconButton
下面的代码示例创建标准 Button 控件的实例和在上面的示例中创建的名为 MyIconButton 的派生控件的实例。此示例要求在与应用程序相同的位置有一个名为 Default.ico 的 Icon 文件。当应用程序启动时，Default 图标显示在 MyIconButton 按钮上。如果 Default 图标不存在，则按钮表面为空白。当单击标准 Button 时，将出现 OpenFileDialog 框，您可以选择要在 MyIconButton 上显示的新图标。
public class MyApplication extends Form
{
private MyIconButton myIconButton;
private Button stdButton;
private OpenFileDialog openDlg;
public static void main(String[] args)
{
Application.Run(new MyApplication());
} //main
public MyApplication()
{
try {
// Create the button with the default icon.
myIconButton = new MyIconButton(new Icon(Application.
get_StartupPath() + "\\Default.ico"));
}
catch (System.Exception ex) {
// If the default icon does not exist,
// create the button without an icon.
myIconButton = new MyIconButton();
Debug.WriteLine(ex.ToString());
}
finally {
stdButton = new Button();
// Add the Click event handlers.
myIconButton.add_Click(new EventHandler(this.myIconButton_Click));
stdButton.add_Click(new EventHandler(this.stdButton_Click));
// Set the location, text and width of the standard button.
stdButton.set_Location(new Point(myIconButton.get_Location().
get_X(), myIconButton.get_Location().get_Y()
+ myIconButton.get_Height() + 20));
stdButton.set_Text("Change Icon");
stdButton.set_Width(100);
// Add the buttons to the Form.
this.get_Controls().Add(stdButton);
this.get_Controls().Add(myIconButton);
}
} //MyApplication
private void myIconButton_Click(Object Sender, EventArgs e)
{
// Make sure MyIconButton works.
MessageBox.Show("MyIconButton was clicked!");
} //myIconButton_Click
private void stdButton_Click(Object Sender, EventArgs e)
{
// Use an OpenFileDialog to allow the user to assign a new image to
// the derived button.
openDlg = new OpenFileDialog();
openDlg.set_InitialDirectory(Application.get_StartupPath());
openDlg.set_Filter("Icon files (*.ico)|*.ico");
openDlg.set_Multiselect(false);
openDlg.ShowDialog();
if (!(openDlg.get_FileName().Equals(""))) {
myIconButton.set_Icon(new Icon(openDlg.get_FileName()));
}
} //stdButton_Click
} //MyApplication
继承层次结构
System.Object
System.Windows.Forms.CreateParams
线程安全
此类型的任何公共静态（Visual Basic 中的 Shared）成员都是线程安全的，但不保证所有实例成员都是线程安全的。
平台
Windows 98、Windows 2000 SP4、Windows CE、Windows Millennium Edition、Windows Mobile for Pocket PC、Windows Mobile for Smartphone、Windows Server 2003、Windows XP Media Center Edition、Windows XP Professional x64 Edition、Windows XP SP2、Windows XP Starter Edition
.NET Framework 并不是对每个平台的所有版本都提供支持。有关受支持版本的列表，请参见系统要求。
版本信息
.NET Framework
受以下版本支持：2.0、1.1、1.0
请参见
参考
CreateParams 成员
System.Windows.Forms 命名空间
Control.CreateParams 属性