IDesignerOptionService.GetOptionValue(String, String) 方法
定義
重要
部分資訊涉及發行前產品,在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊,不做任何明確或隱含的瑕疵擔保。
取得指定之 [Windows Form 設計工具] 選項的值。
public:
System::Object ^ GetOptionValue(System::String ^ pageName, System::String ^ valueName);
public object GetOptionValue (string pageName, string valueName);
public object? GetOptionValue (string pageName, string valueName);
abstract member GetOptionValue : string * string -> obj
Public Function GetOptionValue (pageName As String, valueName As String) As Object
參數
- pageName
- String
定義選項的頁面名稱。
- valueName
- String
選項屬性的名稱。
傳回
指定的選項值。
範例
下列程式代碼範例示範如何使用 GetOptionValue 方法來查詢 選項的值 GridSize
。
// Obtains and shows the size of the standard design-mode grid square.
System::Drawing::Size size = *dynamic_cast<System::Drawing::Size^>(designerOptionService->GetOptionValue( "WindowsFormsDesigner\\General", "GridSize" ));
// Obtains and shows the size of the standard design-mode grid square.
Size size = (Size)designerOptionService.GetOptionValue("WindowsFormsDesigner\\General", "GridSize");
' Obtains and shows the size of the standard design-mode grid square.
Dim size As Size = CType(designerOptionService.GetOptionValue("WindowsFormsDesigner\General", "GridSize"), Size)
備註
參數 pageName
應該包含 「WindowsFormsDesigner\CategoryName」。,其中 CategoryName 是選項類別名稱,不含任何空格符。 類別名稱通常是 「General」。 因此,您可以使用英文頁面名稱 「WindowsFormsDesigner\General」 來存取 [一般] 設計工具選項類別。
注意
頁面和值名稱一律會以英文表示。 因此,下表提供來協助您存取所需的選項。
下表指出英文值名稱、其數據格式,以及每個名稱的描述:
值名稱 | 值格式 | 描述 |
---|---|---|
GridSize | Size | 每個方格方形的大小。 |
GridSize.Width | Int32 | 每個方格方形的寬度。 透過設計工具選項服務存取時,這個巢狀屬性是只讀屬性。 |
GridSize.Height | Int32 | 每個方格方塊的高度。 透過設計工具選項服務存取時,這個巢狀屬性是只讀屬性。 |
ShowGrid | Boolean | true 如果應該顯示方格,則為 ; false 如果不應該顯示方格,則為 。 |
SnapToGrid | Boolean | true 如果元件的位置應該對齊方格,則為 ; false 如果位置不一定對齊,則為 。 |
LayoutMode | Microsoft.VisualStudio.Windows.Forms.LayoutMode |
SnapLines 表示使用對齊線,或 SnapToGrid 對齊網格線的控件 |
ObjectBoundSmartTagAutoShow | Boolean | true 表示允許元件的智慧標籤面板在建立後自動開啟,否則為 false 。 |
AutoToolboxPopulate | Boolean | true 將方案的自定義控件和元件自動新增至 工具箱;否則為 false 。 |
UseOptimizedCodeGeneration | Boolean | 如果啟用元件快取,則為 true ,否則為 false 。 |