IDesignerOptionService.GetOptionValue メソッドとは何？わかりやすく解説 Weblio辞書

.NET Framework クラスライブラリリファレンス

索引トップ用語の索引ランキング

IDesignerOptionService.GetOptionValue メソッド

指定した Windows フォームデザイナ‏ オプションの値を取得します。

名前空間: System.ComponentModel.Design
アセンブリ: System (system.dll 内)
構文

Visual Basic (宣言)

Function GetOptionValue ( _
    pageName As String, _
    valueName As String _
) As Object

Visual Basic (使用法)

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
)

C++

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

Object GetOptionValue (
    String pageName, 
    String valueName
)

JScript

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

パラメータ

pageName: オプションを定義するページの名前。

valueName: オプションプロパティの名前。

戻り値
指定したオプションの値。

解説

pageName パラメータは、"WindowsFormsDesigner\CategoryName" で構成する必要があります。ここでの CategoryName は、空白文字を挿入しないオプションカテゴリ名です。多くの場合、カテゴリ名には "General" を指定します。つまり、デザイナオプションの "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。

使用例

GetOptionValue メソッドを使用して GridSize オプションの値を問い合わせるコード例を次に示します。

Visual Basic

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

C++

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