IDesignerOptionService.GetOptionValue(String, String) Methode

Referenz

Definition

Namespace:: System.ComponentModel.Design

Assembly:: System.ComponentModel.TypeConverter.dll

Assembly:: System.dll

Assembly:: netstandard.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

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

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 lautet in der Regel "Allgemein". Daher können Sie auf die Designeroptionenkategorie "Allgemein" 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 englischen Wertnamen, ihr Datenformat und eine Beschreibung der einzelnen Werte angegeben:

Wertname	Wertformat	BESCHREIBUNG
GridSize	Size	Die Größe jedes Rasterquadrats.
GridSize.Width	Int32	Die Breite jedes Rasterquadrat. Diese geschachtelte Eigenschaft ist schreibgeschützt, wenn über den Designeroptionsdienst darauf zugegriffen wird.
GridSize.Height	Int32	Die Höhe jedes Rasterquadrat. Diese geschachtelte Eigenschaft ist schreibgeschützt, wenn über den Designeroptionsdienst darauf 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` , um Ausrichtungslinien zu verwenden oder `SnapToGrid` Steuerelemente am Raster auszurichten,
ObjectBoundSmartTagAutoShow	Boolean	`true`, damit der Smarttagbereich einer Komponente bei der Erstellung automatisch geöffnet wird; andernfalls `false`.
AutoToolboxPopulate	Boolean	`true` , um der Toolbox automatisch die benutzerdefinierten Steuerelemente und Komponenten einer Lösung hinzuzufügen; `false`andernfalls .
UseOptimizedCodeGeneration	Boolean	`true`, wenn der Komponentencache aktiviert wird, andernfalls `false`.

Gilt für: