IDesignerOptionService.GetOptionValue(String, String) Método

Definição

Espaço de Nomes:
System.ComponentModel.Design
Assemblagem:
System.dll
Assemblagem:
netstandard.dll

Obtém o valor da opção Windows Forms Designer especificada.

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

Parâmetros

pageName
String

O nome da página que define a opção.

valueName
String

O nome da propriedade da opção.

Devoluções

Object

O valor da opção especificada.

Exemplos

O exemplo de código seguinte demonstra a utilização do GetOptionValue método para consultar o valor da GridSize opção.

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

Observações

O pageName parâmetro deve consistir em "WindowsFormsDesigner\CategoryName", onde CategoryName é um nome de categoria de opções sem quaisquer caracteres de espaço em branco. O nome da categoria é tipicamente "General". Assim, pode aceder à categoria de opções de designer "Geral" com o nome da página em inglês "WindowsFormsDesigner\General".

Note

Os nomes das páginas e dos valores são sempre esperados em inglês. Por isso, a tabela seguinte é fornecida para o ajudar a aceder às opções que deseja.

A tabela seguinte indica os nomes dos valores em inglês, o seu formato de dados e uma descrição de cada um:

Nome do valor Formato de Valor Description
GridSize Size O tamanho de cada quadrado da grelha.
GridSize.Width Int32 A largura de cada quadrado da grelha. Esta propriedade aninhada é apenas leitura quando acedida através do serviço de opções designer.
GridSize.Height Int32 A altura de cada quadrado da grelha. Esta propriedade aninhada é apenas leitura quando acedida através do serviço de opções designer.
ShowGrid Boolean true se a grelha deve ser mostrada; false se a grelha não deve ser mostrada.
SnapToGrid Boolean true se as posições dos componentes devem estar alinhadas com a grelha; false se as posições não devem necessariamente estar alinhadas.
LayoutMode Microsoft.VisualStudio.Windows.Forms.LayoutMode SnapLines para usar snaplines, ou SnapToGrid para alinhar os controlos à grelha,
ObjectBoundSmartTagAutoShow Boolean true para permitir que o painel de etiquetas inteligentes de um componente abra automaticamente após a criação; caso contrário, false.
AutoToolboxPopulate Boolean true adicionar automaticamente os controlos e componentes personalizados de uma solução à Toolbox; caso contrário, false.
UseOptimizedCodeGeneration Boolean true se a cache de componentes estiver ativada; caso contrário, false.

Aplica-se a

Ver também