DomainUpDown 類別
定義
重要
部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。
表示會顯示字串值的 Windows 微調方塊 (也稱為上下按鈕控制項)。
public ref class DomainUpDown : System::Windows::Forms::UpDownBasepublic class DomainUpDown : System.Windows.Forms.UpDownBase[System.ComponentModel.DefaultBindingProperty("SelectedItem")]
[System.Runtime.InteropServices.ClassInterface(System.Runtime.InteropServices.ClassInterfaceType.AutoDispatch)]
[System.Runtime.InteropServices.ComVisible(true)]
public class DomainUpDown : System.Windows.Forms.UpDownBase[System.ComponentModel.DefaultBindingProperty("SelectedItem")]
public class DomainUpDown : System.Windows.Forms.UpDownBasetype DomainUpDown = class
inherit UpDownBase[<System.ComponentModel.DefaultBindingProperty("SelectedItem")>]
[<System.Runtime.InteropServices.ClassInterface(System.Runtime.InteropServices.ClassInterfaceType.AutoDispatch)>]
[<System.Runtime.InteropServices.ComVisible(true)>]
type DomainUpDown = class
inherit UpDownBase[<System.ComponentModel.DefaultBindingProperty("SelectedItem")>]
type DomainUpDown = class
inherit UpDownBasePublic Class DomainUpDown
Inherits UpDownBase- 繼承
- 屬性
範例
下列程式代碼範例會建立和初始化 DomainUpDown 控件。 此範例可讓您設定其部分屬性，並建立字串集合，以在微調方塊中顯示。 程式代碼假設 TextBox、 CheckBox和 Button 已在表單上具現化。 此範例也假設您在類別層級宣告為名為 myCounter的32位帶正負號整數的成員變數。 您可以在文字框中輸入字串，並在按下按鈕時將其新增至 Items 集合。 按兩下複選框，您可以切換 屬性， Sorted 並觀察微調方塊中專案集合的差異。
protected:
DomainUpDown^ domainUpDown1;
private:
void MySub()
{
// Create and initialize the DomainUpDown control.
domainUpDown1 = gcnew System::Windows::Forms::DomainUpDown;
// Add the DomainUpDown control to the form.
Controls->Add( domainUpDown1 );
}
void button1_Click( System::Object^ sender,
System::EventArgs^ e )
{
// Add the text box contents and initial location in the collection
// to the DomainUpDown control.
domainUpDown1->Items->Add( String::Concat(
(textBox1->Text->Trim()), " - ", myCounter.ToString() ) );
// Increment the counter variable.
myCounter = myCounter + 1;
// Clear the TextBox.
textBox1->Text = "";
}
void checkBox1_Click( Object^ sender, EventArgs^ e )
{
// If Sorted is set to true, set it to false;
// otherwise set it to true.
if ( domainUpDown1->Sorted )
{
domainUpDown1->Sorted = false;
}
else
{
domainUpDown1->Sorted = true;
}
}
void domainUpDown1_SelectedItemChanged( Object^ sender, EventArgs^ e )
{
// Display the SelectedIndex and SelectedItem property values in a MessageBox.
MessageBox::Show( String::Concat( "SelectedIndex: ",
domainUpDown1->SelectedIndex.ToString(), "\n", "SelectedItem: ",
domainUpDown1->SelectedItem->ToString() ) );
}
protected DomainUpDown domainUpDown1;
private void MySub()
{
// Create and initialize the DomainUpDown control.
domainUpDown1 = new System.Windows.Forms.DomainUpDown();
// Add the DomainUpDown control to the form.
Controls.Add(domainUpDown1);
}
private void button1_Click(System.Object sender,
System.EventArgs e)
{
// Add the text box contents and initial location in the collection
// to the DomainUpDown control.
domainUpDown1.Items.Add((textBox1.Text.Trim()) + " - " + myCounter);
// Increment the counter variable.
myCounter = myCounter + 1;
// Clear the TextBox.
textBox1.Text = "";
}
private void checkBox1_Click(System.Object sender,
System.EventArgs e)
{
// If Sorted is set to true, set it to false;
// otherwise set it to true.
if (domainUpDown1.Sorted)
{
domainUpDown1.Sorted = false;
}
else
{
domainUpDown1.Sorted = true;
}
}
private void domainUpDown1_SelectedItemChanged(System.Object sender,
System.EventArgs e)
{
// Display the SelectedIndex and SelectedItem property values in a MessageBox.
MessageBox.Show("SelectedIndex: " + domainUpDown1.SelectedIndex.ToString()
+ "\n" + "SelectedItem: " + domainUpDown1.SelectedItem.ToString());
}
Protected domainUpDown1 As DomainUpDown
Private Sub MySub()
' Create and initialize the DomainUpDown control.
domainUpDown1 = New System.Windows.Forms.DomainUpDown()
' Add the DomainUpDown control to the form.
Controls.Add(domainUpDown1)
End Sub
Private Sub button1_Click(sender As System.Object, e As System.EventArgs)
' Add the text box contents and initial location in the collection
' to the DomainUpDown control.
domainUpDown1.Items.Add((textBox1.Text.Trim() & " - " & myCounter))
' Increment the counter variable.
myCounter = myCounter + 1
' Clear the TextBox.
textBox1.Text = ""
End Sub
Private Sub checkBox1_Click(sender As System.Object, e As System.EventArgs)
' If Sorted is set to true, set it to false;
' otherwise set it to true.
If domainUpDown1.Sorted Then
domainUpDown1.Sorted = False
Else
domainUpDown1.Sorted = True
End If
End Sub
Private Sub domainUpDown1_SelectedItemChanged _
(sender As System.Object, e As System.EventArgs)
' Display the SelectedIndex and SelectedItem property values in a MessageBox.
MessageBox.Show(("SelectedIndex: " & domainUpDown1.SelectedIndex.ToString() & _
ControlChars.Cr & "SelectedItem: " & domainUpDown1.SelectedItem.ToString()))
End Sub
備註
DomainUpDown控件會顯示從Object集合選取的單一字串值，方法是按兩下控件的向上或向下按鈕。 使用者也可以輸入 控件中的文字，除非 ReadOnly 屬性設定 true 為 (輸入的字串必須符合集合中要接受的專案) 。 選取專案時，物件會轉換成字串值，以便顯示在微調方塊中。
若要建立要顯示在 控件中的 DomainUpDown 物件集合，您可以使用 和 Remove 方法個別Add新增或移除專案。 這可以在事件處理程式中呼叫，例如 Click 按鈕的事件。 藉由將 Sorted 屬性設定為 true，即可依字母順序排序物件集合。
Wrap當 屬性設定true為 時，如果您捲動到集合中的最後一個或第一個對象之後，清單會分別以第一個或最後一個對象開始，並顯示為在連續清單中變換。
UpButton呼叫 或 DownButton 方法時，會在程式代碼中或按下向上或向下按鈕，UpdateEditText呼叫 以使用新的字串更新控制件。 如果 UserEdit 設定為 true，則字串會在更新控件的文字顯示之前，與集合中的其中一個值相符。
從 .NET Framework 4.6 開始，當 app.config 檔案包含下列專案時，DomainUpDown控件將會根據系統 DPI 設定來重設大小：
<appSettings>
<add key="EnableWindowsFormsHighDpiAutoResizing" value="true" />
</appSettings>
建構函式
| DomainUpDown() |
初始化 DomainUpDown 類別的新執行個體。 |
欄位
| ScrollStateAutoScrolling |
判斷 AutoScroll 屬性值。 (繼承來源 ScrollableControl) |
| ScrollStateFullDrag |
判斷使用者是否已啟用完整的視窗拖曳。 (繼承來源 ScrollableControl) |
| ScrollStateHScrollVisible |
判斷 HScroll 屬性值是否設定為 |
| ScrollStateUserHasScrolled |
判斷使用者是否已捲動 ScrollableControl 控制項。 (繼承來源 ScrollableControl) |
| ScrollStateVScrollVisible |
判斷 VScroll 屬性值是否設定為 |
屬性
| AccessibilityObject |
取得指定給控制項的 AccessibleObject。 (繼承來源 Control) |
| AccessibleDefaultActionDescription |
取得或設定協助用戶端應用程式所使用的控制項的預設動作描述。 (繼承來源 Control) |
| AccessibleDescription |
取得或設定協助工具用戶端應用程式使用之控制項的描述。 (繼承來源 Control) |
| AccessibleName |
取得或設定協助工具用戶端應用程式使用的控制項名稱。 (繼承來源 Control) |
| AccessibleRole |
取得或設定控制項的可存取角色。 (繼承來源 Control) |
| ActiveControl |
取得或設定容器控制項上的作用中控制項。 (繼承來源 ContainerControl) |
| AllowDrop |
取得或設定值，指出控制項是否能接受使用者拖放上來的資料。 (繼承來源 Control) |
| Anchor |
取得或設定控制項繫結至的容器邊緣，並決定控制項隨其父代重新調整大小的方式。 (繼承來源 Control) |
| AutoScaleDimensions |
取得或設定設計控制項的目標維度 (Dimension)。 (繼承來源 ContainerControl) |
| AutoScaleFactor |
取得目前與設計階段自動縮放維度之間的縮放比例。 (繼承來源 ContainerControl) |
| AutoScaleMode |
取得或設定控制項的自動縮放模式。 (繼承來源 ContainerControl) |
| AutoScroll |
取得值，指出容器 (Container) 是否允許使用者捲動至任何放置在可視界限以外的控制項。 (繼承來源 UpDownBase) |
| AutoScrollMargin |
取得或設定自動捲動邊界的大小。 (繼承來源 UpDownBase) |
| AutoScrollMinSize |
取得或設定自動捲動區域大小的最小值。 (繼承來源 UpDownBase) |
| AutoScrollOffset |
取得或設定此控制項在 ScrollControlIntoView(Control) 中要捲動到哪一個位置。 (繼承來源 Control) |
| AutoScrollPosition |
取得或設定自動捲動的位置。 (繼承來源 ScrollableControl) |
| AutoSize |
取得或設定值，指出控制項是否應根據其內容自動調整大小。 (繼承來源 UpDownBase) |
| AutoValidate |
取得或設定值，指出這個容器中的控制項是否會在焦點改變時自動進行驗證。 (繼承來源 ContainerControl) |
| BackColor |
取得或設定微調方塊 (也稱為上下按鈕控制項) 的文字方塊部分的背景色彩。 (繼承來源 UpDownBase) |
| BackgroundImage |
取得或設定 UpDownBase 的背景影像。 (繼承來源 UpDownBase) |
| BackgroundImageLayout |
取得或設定 BackgroundImage 之 UpDownBase 的配置。 (繼承來源 UpDownBase) |
| BindingContext |
取得或設定控制項的 BindingContext。 (繼承來源 ContainerControl) |
| BorderStyle |
取得或設定微調方塊 (也稱為上下按鈕控制項) 的框線樣式。 (繼承來源 UpDownBase) |
| Bottom |
取得控制項下邊緣和其容器工作區 (Client Area) 上邊緣之間的距離 (單位為像素)。 (繼承來源 Control) |
| Bounds |
取得或設定控制項 (包括其非工作區項目) 相對於父控制項之大小和位置 (單位為像素)。 (繼承來源 Control) |
| CanEnableIme |
取得值，這個值表示 ImeMode 屬性是否可以設定為使用中的值，以啟用 IME 支援。 (繼承來源 ContainerControl) |
| CanFocus |
取得指示控制項是否能取得焦點的值。 (繼承來源 Control) |
| CanRaiseEvents |
判斷是否可以在控制項上引發事件。 (繼承來源 Control) |
| CanSelect |
取得指示能否選取控制項的值。 (繼承來源 Control) |
| Capture |
取得或設定值，指出控制項是否捕捉住滑鼠。 (繼承來源 Control) |
| CausesValidation |
取得或設定值，指出控制項取得焦點時，是否會在任何需要驗證的控制項上執行驗證。 (繼承來源 Control) |
| ChangingText |
取得或設定值，指出文字屬性是否被它的父類別從內部變更。 (繼承來源 UpDownBase) |
| ClientRectangle |
取得表示控制項工作區的矩形。 (繼承來源 Control) |
| ClientSize |
取得或設定控制項工作區的高度和寬度。 (繼承來源 Control) |
| CompanyName |
取得包含控制項之應用程式的公司名稱或建立者。 (繼承來源 Control) |
| Container |
取得包含 IContainer 的 Component。 (繼承來源 Component) |
| ContainsFocus |
取得指示控制項 (或其子控制項之一) 目前是否擁有輸入焦點的值。 (繼承來源 Control) |
| ContextMenu |
取得或設定與微調方塊 (也稱為上下按鈕控制項) 相關聯的捷徑功能表。 (繼承來源 UpDownBase) |
| ContextMenuStrip |
取得或設定微調方塊 (也稱為上下按鈕控制項) 的捷徑功能表。 (繼承來源 UpDownBase) |
| Controls |
取得控制項中包含的控制項集合。 (繼承來源 Control) |
| Created |
取得值，指出是否已經建立控制項。 (繼承來源 Control) |
| CreateParams |
建立控制代碼時，取得必要的建立參數。 (繼承來源 UpDownBase) |
| CurrentAutoScaleDimensions |
取得螢幕目前的執行階段維度。 (繼承來源 ContainerControl) |
| Cursor |
取得或設定滑鼠指標移至控制項上時顯示的游標。 (繼承來源 Control) |
| DataBindings |
取得控制項的資料繫結 (Data Binding)。 (繼承來源 Control) |
| DataContext |
取得或設定數據系結用途的數據內容。 這是環境屬性。 (繼承來源 Control) |
| DefaultCursor |
取得或設定控制項的預設游標。 (繼承來源 Control) |
| DefaultImeMode |
取得控制項支援的預設輸入法 (IME) 模式。 (繼承來源 Control) |
| DefaultMargin |
取得控制項之間的預設指定間距 (單位為像素)。 (繼承來源 Control) |
| DefaultMaximumSize |
取得指定為控制項的預設大小之最大值的長度和高度 (單位為像素)。 (繼承來源 Control) |
| DefaultMinimumSize |
取得指定為控制項的預設大小之最小值的長度和高度 (單位為像素)。 (繼承來源 Control) |
| DefaultPadding |
取得控制項內容的預設內部間距，以像素為單位。 (繼承來源 Control) |
| DefaultSize |
取得控制項的預設大小。 (繼承來源 UpDownBase) |
| DesignMode |
取得值，指出 Component 目前是否處於設計模式。 (繼承來源 Component) |
| DeviceDpi |
取得目前顯示控制項的顯示裝置的 DPI 值。 (繼承來源 Control) |
| DisplayRectangle |
取得表示控制項之虛擬顯示區域的矩形。 (繼承來源 ScrollableControl) |
| Disposing |
取得值，指出基底 Control 類別是否正在處置的過程中。 (繼承來源 Control) |
| Dock |
取得或設定停駐在其父控制項的控制項框線，並決定控制項隨其父代重新調整大小的方式。 (繼承來源 Control) |
| DockPadding |
取得 UpDownBase 控制項所有邊緣的停駐填補設定。 (繼承來源 UpDownBase) |
| DoubleBuffered |
取得或設定值，指出這個控制項是否應使用次要緩衝區重繪其介面，以減少或防止重繪閃動 (Flicker)。 (繼承來源 Control) |
| Enabled |
取得或設定值，指出控制項是否可回應使用者互動。 (繼承來源 Control) |
| Events |
取得附加在這個 Component 上的事件處理常式清單。 (繼承來源 Component) |
| Focused |
取得指示控制項是否擁有輸入焦點的值。 (繼承來源 UpDownBase) |
| Font |
取得或設定控制項顯示之文字字型。 (繼承來源 Control) |
| FontHeight |
取得或設定控制項字型的高度。 (繼承來源 Control) |
| ForeColor |
取得或設定微調方塊 (也稱為上下按鈕控制項) 的前景色彩。 (繼承來源 UpDownBase) |
| Handle |
取得控制項要繫結的目標視窗控制代碼。 (繼承來源 Control) |
| HasChildren |
取得指示控制項是否包含一或多個子控制項的值。 (繼承來源 Control) |
| Height |
取得或設定控制項的高度。 (繼承來源 Control) |
| HorizontalScroll |
取得與水平捲軸相關聯的特性。 (繼承來源 ScrollableControl) |
| HScroll |
取得或設定值，指出水平捲軸是否為可見的。 (繼承來源 ScrollableControl) |
| ImeMode |
取得或設定控制項的輸入法 (IME) 模式。 (繼承來源 Control) |
| ImeModeBase |
取得或設定控制項的 IME 模式。 (繼承來源 Control) |
| InterceptArrowKeys |
取得或設定值，指出使用者是否能用向上鍵和向下鍵來選取值。 (繼承來源 UpDownBase) |
| InvokeRequired |
取得一個值。這個值會指示是否由於呼叫端是在建立控制項之執行緒以外的執行緒，因此在進行控制項的方法呼叫時，應呼叫叫用 (Invoke) 方法。 (繼承來源 Control) |
| IsAccessible |
取得或設定值，指出可及性應用程式是否見得到控制項。 (繼承來源 Control) |
| IsAncestorSiteInDesignMode |
指出這個控件的其中一個上階是否已月臺，以及該月臺在 DesignMode 中。 這是唯讀的屬性。 (繼承來源 Control) |
| IsDisposed |
取得指示控制項是否已經處置的值。 (繼承來源 Control) |
| IsHandleCreated |
取得指示控制項是否有相關控制代碼的值。 (繼承來源 Control) |
| IsMirrored |
取得值，指出是否左右反轉控制項。 (繼承來源 Control) |
| Items |
指派給微調方塊 (也稱為上下按鈕控制項) 的物件集合。 |
| LayoutEngine |
取得控制項之配置引擎的快取執行個體。 (繼承來源 Control) |
| Left |
取得或設定控制項左邊緣和其容器工作區 (Client Area) 左邊緣之間的距離 (單位為像素)。 (繼承來源 Control) |
| Location |
取得或設定對應至控制項容器左上角之控制項左上角的座標。 (繼承來源 Control) |
| Margin |
取得或設定控制項之間的空格。 (繼承來源 Control) |
| MaximumSize |
取得或設定微調方塊 (也稱為上下按鈕控制項) 的最大大小。 (繼承來源 UpDownBase) |
| MinimumSize |
取得或設定微調方塊 (也稱為上下按鈕控制項) 的最小大小。 (繼承來源 UpDownBase) |
| Name |
取得或設定控制項的名稱。 (繼承來源 Control) |
| Padding |
取得或設定 DomainUpDown 控制項內容與其邊緣之間的間距。 |
| Padding |
取得或設定控制項內的邊框間距。 (繼承來源 Control) |
| Parent |
取得或設定控制項的父容器。 (繼承來源 Control) |
| ParentForm |
取得被指派容器控制項的表單。 (繼承來源 ContainerControl) |
| PreferredHeight |
取得微調方塊 (也稱為上下按鈕控制項) 的高度。 (繼承來源 UpDownBase) |
| PreferredSize |
取得能夠容納控制項的矩形區域的大小。 (繼承來源 Control) |
| ProductName |
取得包含控制項的組件的產品名稱。 (繼承來源 Control) |
| ProductVersion |
取得包含控制項的組件的版本。 (繼承來源 Control) |
| ReadOnly |
取得或設定值，指出文字是否只能使用向上或向下按鈕變更。 (繼承來源 UpDownBase) |
| RecreatingHandle |
取得指示控制項目前是否正重新建立其控制代碼的值。 (繼承來源 Control) |
| Region |
取得或設定與控制項關聯的視窗區域。 (繼承來源 Control) |
| RenderRightToLeft |
已淘汰.
已淘汰.
此屬性現在已過時。 (繼承來源 Control) |
| ResizeRedraw |
取得或設定值，指出控制項重設大小時，是否會重繪本身。 (繼承來源 Control) |
| Right |
取得控制項右邊緣和其容器工作區 (Client Area) 左邊緣之間的距離 (單位為像素)。 (繼承來源 Control) |
| RightToLeft |
取得或設定值，指出控制項的項目是否對齊，以支援使用由右至左字型的地區設定。 (繼承來源 Control) |
| ScaleChildren |
取得值，以判斷子控制項的縮放。 (繼承來源 Control) |
| SelectedIndex |
取得或設定已選取項目的索引值。 |
| SelectedItem |
根據集合中已選取項目的索引值，取得或設定已選取項目。 |
| ShowFocusCues |
取得指示控制項是否應顯示焦點矩形 (Focus Rectangle) 的值。 (繼承來源 Control) |
| ShowKeyboardCues |
取得值，指出使用者介面是否處於可顯示或隱藏鍵盤快速鍵的適當狀態下。 (繼承來源 Control) |
| Site |
取得或設定控制項的站台。 (繼承來源 Control) |
| Size |
取得或設定控制項的高度和寬度。 (繼承來源 Control) |
| Sorted |
取得或設定值，指出是否排序項目集合。 |
| TabIndex |
取得或設定控制項容器中的控制項定位順序。 (繼承來源 Control) |
| TabStop |
取得或設定值，指出使用者是否能使用 TAB 鍵，將焦點 (Focus) 給予這個控制項。 (繼承來源 Control) |
| Tag |
取得或設定物件，其包含控制項相關資料。 (繼承來源 Control) |
| Text |
取得或設定微調方塊 (也稱為上下按鈕控制項) 中所顯示的文字。 (繼承來源 UpDownBase) |
| TextAlign |
取得或設定微調方塊 (也稱為上下按鈕控制項) 中的文字對齊。 (繼承來源 UpDownBase) |
| Top |
取得或設定控制項上邊緣和其容器工作區 (Client Area) 上邊緣之間的距離 (單位為像素)。 (繼承來源 Control) |
| TopLevelControl |
取得沒有其他 Windows Form 父控制項的父控制項。 通常，這會是內含控制項最外層的 Form。 (繼承來源 Control) |
| UpDownAlign |
取得或設定微調方塊 (也稱為上下按鈕控制項) 的向上和向下按鈕的對齊。 (繼承來源 UpDownBase) |
| UserEdit |
取得或設定值，指出使用者是否已經輸入值。 (繼承來源 UpDownBase) |
| UseWaitCursor |
取得或設定值，指出是否將等待游標用於目前控制項和所有子控制項。 (繼承來源 Control) |
| VerticalScroll |
取得與垂直捲軸相關聯的特性。 (繼承來源 ScrollableControl) |
| Visible |
取得或設定值，這個值指出是否顯示控制項及其所有子控制項。 (繼承來源 Control) |
| VScroll |
取得或設定值，指出垂直捲軸是否為可見的。 (繼承來源 ScrollableControl) |
| Width |
取得或設定控制項的寬度。 (繼承來源 Control) |
| WindowTarget |
這個屬性與這個類別無關。 (繼承來源 Control) |
| Wrap |
取得或設定值，指出如果使用者持續超過清單的結尾，項目集合是否持續為第一個或最後一個項目。 |
方法
事件
明確介面實作
| IContainerControl.ActivateControl(Control) |
啟動指定的控制項。 (繼承來源 ContainerControl) |
| IDropTarget.OnDragDrop(DragEventArgs) |
引發 DragDrop 事件。 (繼承來源 Control) |
| IDropTarget.OnDragEnter(DragEventArgs) |
引發 DragEnter 事件。 (繼承來源 Control) |
| IDropTarget.OnDragLeave(EventArgs) |
引發 DragLeave 事件。 (繼承來源 Control) |
| IDropTarget.OnDragOver(DragEventArgs) |
引發 DragOver 事件。 (繼承來源 Control) |
