ColorDialog.AllowFullOpen プロパティ

.NET Framework クラス ライブラリ リファレンス

ColorDialog.AllowFullOpen プロパティ

ユーザーがダイアログ ボックスを使用してカスタム カラーを定義できるかどうかを示す値を取得または設定します。

名前空間: System.Windows.Forms
アセンブリ: System.Windows.Forms (system.windows.forms.dll 内)
構文

Visual Basic (宣言)

Public Overridable Property
 AllowFullOpen As Boolean

Visual Basic (使用法)

Dim instance As ColorDialog
Dim value As Boolean

value = instance.AllowFullOpen

instance.AllowFullOpen = value

C#

public virtual bool AllowFullOpen { get;
 set; }

C++

public:
virtual property bool AllowFullOpen {
    bool get ();
    void set (bool value);
}

J#

/** @property */
public boolean get_AllowFullOpen ()

/** @property */
public void set_AllowFullOpen (boolean value)

JScript

public function get AllowFullOpen
 () : boolean

public function set AllowFullOpen
 (value : boolean)

プロパティ値
ユーザーがカスタム カラーを定義できる場合は true。それ以外の場合は false。既定値は true です。

解説

false を設定すると、ダイアログ ボックスに関連付けられているボタンが無効になり、ユーザーはダイアログ ボックス上のカスタム カラー コントロールにアクセスできません。

使用例

新しい ColorDialog を作成する例を次に示します。この例では、TextBox と Button が配置されている既存のフォームからメソッドを呼び出す必要があります。

Visual Basic

Private Sub button1_Click(sender As
 Object, e As System.EventArgs)
    Dim MyDialog As New
 ColorDialog()
    ' Keeps the user from selecting a custom color.
    MyDialog.AllowFullOpen = False
    ' Allows the user to get help. (The default is false.)
    MyDialog.ShowHelp = True
    ' Sets the initial color select to the current text color,
    MyDialog.Color = textBox1.ForeColor

    ' Update the text box color if the user clicks OK 
    If (MyDialog.ShowDialog() = DialogResult.OK) Then
        textBox1.ForeColor =  MyDialog.Color
    End If

End Sub 'button1_Click

C#

private void button1_Click(object sender, System.EventArgs
 e)
 {
    ColorDialog MyDialog = new ColorDialog();
    // Keeps the user from selecting a custom color.
    MyDialog.AllowFullOpen = false ;
    // Allows the user to get help. (The default is false.)
    MyDialog.ShowHelp = true ;
    // Sets the initial color select to the current text color.
    MyDialog.Color = textBox1.ForeColor ;
    
    // Update the text box color if the user clicks OK 
    if (MyDialog.ShowDialog() == DialogResult.OK)
        textBox1.ForeColor =  MyDialog.Color;
 }
    

C++

private:
   void button1_Click( Object^ /*sender*/, System::EventArgs^
 /*e*/ )
   {
      ColorDialog^ MyDialog = gcnew ColorDialog;
      // Keeps the user from selecting a custom color.
      MyDialog->AllowFullOpen = false;
      // Allows the user to get help. (The default is false.)
      MyDialog->ShowHelp = true;
      // Sets the initial color select to the current text color.
      MyDialog->Color = textBox1->ForeColor;
      
      // Update the text box color if the user clicks OK 
      if ( MyDialog->ShowDialog() == ::DialogResult::OK )
      {
         textBox1->ForeColor = MyDialog->Color;
      }
   }

J#

protected void button1_Click(Object sender,
 System.EventArgs e)
{
    ColorDialog myDialog = new ColorDialog();
    // Keeps the user from selecting a custom color.
    myDialog.set_AllowFullOpen(false);
    // Allows the user to get help. (The default is false.)
    myDialog.set_ShowHelp(true);
    // Sets the initial color select to the current text color.
    myDialog.set_Color(textBox1.get_ForeColor());
    // Update the text box color if the user clicks OK 
    if (myDialog.ShowDialog().Equals(get_DialogResult().OK)) {
        textBox1.set_ForeColor(myDialog.get_Color());
    }
} //button1_Click

プラットフォーム

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

参照

関連項目
ColorDialog クラス
ColorDialog メンバ
System.Windows.Forms 名前空間
FullOpen