IDesignerOptionService.GetOptionValue(String, String) Methode

Definition

Namespace:
System.ComponentModel.Design
Assembly:
System.dll
Assembly:
netstandard.dll

Ruft den Wert der angegebenen Windows Forms Designer-Option ab.

public:
 System::Object ^ GetOptionValue(System::String ^ pageName, System::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

Parameter

pageName
String

Der Name der Seite, die die Option definiert.

valueName
String

Der Name der Optionseigenschaft.

Gibt zurück

Object

Der Wert der angegebenen Option.

Beispiele

Im folgenden Codebeispiel wird die Verwendung der GetOptionValue Methode zum Abfragen des Werts der GridSize Option veranschaulicht.

// 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)

Hinweise

Der pageName Parameter sollte aus "WindowsFormsDesigner\CategoryName" bestehen, wobei CategoryName ein Optionskategoriename ohne Leerzeichen ist. Der Kategoriename ist in der Regel "Allgemein". Daher können Sie auf die Kategorie "Allgemeine" Designeroptionen mit dem englischen Seitennamen "WindowsFormsDesigner\General" zugreifen.

Hinweis

Die Seiten- und Wertnamen werden immer in Englisch erwartet. Daher wird die folgende Tabelle bereitgestellt, um Ihnen den Zugriff auf die gewünschten Optionen zu erleichtern.

In der folgenden Tabelle sind die namen der englischen Werte, deren Datenformat und eine Beschreibung der einzelnen Werte angegeben:

Wertname Wertformat Description
Rastergröße Size Die Größe jedes Rasterquadecks.
GridSize.Width Int32 Die Breite jedes Rasterquadecks. Diese geschachtelte Eigenschaft ist schreibgeschützt, wenn über den Designeroptionsdienst zugegriffen wird.
GridSize.Height Int32 Die Höhe jedes Rasterquadecks. Diese geschachtelte Eigenschaft ist schreibgeschützt, wenn über den Designeroptionsdienst zugegriffen wird.
ShowGrid Boolean true wenn das Raster angezeigt werden soll; false wenn das Raster nicht angezeigt werden soll.
SnapToGrid Boolean true wenn die Positionen der Komponenten am Raster ausgerichtet werden sollen; false wenn die Positionen nicht unbedingt ausgerichtet werden sollen.
LayoutMode Microsoft.VisualStudio.Windows.Forms.LayoutMode SnapLines zum Verwenden von Andocklinien oder SnapToGrid zum Ausrichten von Steuerelementen am Raster
ObjectBoundSmartTagAutoShow Boolean truedas automatische Öffnen des Smarttagpanels einer Komponente bei der Erstellung zu ermöglichen; andernfalls . false
AutoToolboxPopulate Boolean trueautomatisch die benutzerdefinierten Steuerelemente und Komponenten einer Lösung zur Toolbox hinzuzufügen; andernfalls . false
UseOptimizedCodeGeneration Boolean truewenn der Komponentencache aktiviert ist; andernfalls . false

Gilt für:

Weitere Informationen