IDesignerOptionService.GetOptionValue-Methode

Artikel
08/20/2007

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

Namespace: System.ComponentModel.Design
Assembly: System (in system.dll)

Syntax

'Declaration
Function GetOptionValue ( _
    pageName As String, _
    valueName As String _
) As Object
'Usage
Dim instance As IDesignerOptionService
Dim pageName As String
Dim valueName As String
Dim returnValue As Object

returnValue = instance.GetOptionValue(pageName, valueName)

Object GetOptionValue (
    string pageName,
    string valueName
)

Object^ GetOptionValue (
    String^ pageName, 
    String^ valueName
)

Object GetOptionValue (
    String pageName, 
    String valueName
)

function GetOptionValue (
    pageName : String, 
    valueName : String
) : Object

Parameter

pageName
Der Name der Seite, die die Option definiert.

valueName
Der Name der Optionseigenschaft.

Rückgabewert

Der Wert der angegebenen Option.

Hinweise

Der pageName-Parameter muss aus "WindowsFormsDesigner\CategoryName" bestehen, wobei CategoryName dem Kategorienamen einer Option ohne Leerraumzeichen entspricht. Der Kategoriename lautet normalerweise "General". Daher können Sie mit dem englischen Seitennamen "WindowsFormsDesigner\General" auf die Designeroptionskategorie "General" zugreifen.

Hinweis

Für die Seiten- und Wertnamen wird immer eine Eingabe in englischer Sprache erwartet. Daher steht die folgende Tabelle zur Verfügung, um Ihnen den Zugriff auf die gewünschten Optionen zu erleichtern.

In der folgenden Tabelle werden die englischen Wertnamen jeweils mit dem entsprechenden Datenformat und einer Beschreibung aufgeführt:

Wertname	Wertformat	Beschreibung
GridSize	Size	Die Größe der einzelnen Rasterquadrate.
GridSize.Width	Int32	Die Breite der einzelnen Rasterquadrate. Diese geschachtelte Eigenschaft ist schreibgeschützt, wenn über den Designeroptionsdienst darauf zugegriffen wird.
GridSize.Height	Int32	Die Höhe der einzelnen Rasterquadrate. 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 zwingend ausgerichtet werden sollen.
LayoutMode	Microsoft.VisualStudio.Windows.Forms.LayoutMode	SnapLines, um Ausrichtungslinien zu verwenden, oder SnapToGrid, um Steuerelemente zum Raster auszurichten.
ObjectBoundSmartTagAutoShow	Boolean	true, um den Smarttagbereich einer Komponente nach Erstellung automatisch zu öffnen; andernfalls false.
AutoToolboxPopulate	Boolean	true, um die benutzerdefinierten Steuerelemente und Komponenten einer Projektmappe automatisch der Toolbox hinzuzufügen; andernfalls false.
UseOptimizedCodeGeneration	Boolean	true, wenn der Komponentencache aktiviert ist, andernfalls false.

Beispiel

Im folgenden Codebeispiel wird veranschaulicht, wie mit der GetOptionValue-Methode der Wert der GridSize-Option abgefragt wird.

' Obtains and shows the size of the standard design-mode grid square.
Dim size As Size = CType(designerOptionService.GetOptionValue("WindowsFormsDesigner\General", "GridSize"), Size)

// 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.
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")));

Plattformen

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.

Versionsinformationen

.NET Framework

Unterstützt in: 2.0, 1.1, 1.0

Siehe auch

Referenz

IDesignerOptionService-Schnittstelle
IDesignerOptionService-Member
System.ComponentModel.Design-Namespace
SetOptionValue
DesignerOptionService-Klasse

Freigeben über