EditorZoneBase.ApplyVerb プロパティとは何？わかりやすく解説 Weblio辞書

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

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

EditorZoneBase.ApplyVerb プロパティ

メモ : このプロパティは、.NET Framework version 2.0 で新しく追加されたものです。

エンドユーザーが編集モードで編集結果をコントロールに適用できるようにする WebPartVerb オブジェクトへの参照を取得します。

名前空間: System.Web.UI.WebControls.WebParts
アセンブリ: System.Web (system.web.dll 内)
構文

Visual Basic (宣言)

Public Overridable ReadOnly
 Property ApplyVerb As WebPartVerb

Visual Basic (使用法)

Dim instance As EditorZoneBase
Dim value As WebPartVerb

value = instance.ApplyVerb

public virtual WebPartVerb ApplyVerb { get;
 }

C++

public:
virtual property WebPartVerb^ ApplyVerb {
    WebPartVerb^ get ();
}

/** @property */
public WebPartVerb get_ApplyVerb ()

JScript

public function get ApplyVerb
 () : WebPartVerb

プロパティ値
エンドユーザーが変更をコントロールに適用できるようにする WebPartVerb。

解説

Apply 動詞は、EditorZoneBase クラスから派生したコントロールの ApplyVerb プロパティによって参照されます。Apply 動詞は、編集ユーザーインターフェイス (UI) でエンドユーザーが行った編集結果を、現在編集中のサーバーコントロールに保存します。既定では、Apply 動詞は、Button コントロールとして UI に表示されます。ボタンの種類として、イメージ、リンク、または実際のボタンを選択できます。これは、継承された VerbButtonType プロパティをゾーンレベルで設定することにより、(個別のボタンに対してではなく) ゾーン内のすべての動詞ボタンに対して設定できます。

Apply 動詞は、ゾーンレベルのコントロールです。つまり、複数の EditorPart コントロールが存在し、各コントロールが、編集モードになっているサーバーコントロールの 1 つ以上のプロパティを編集する場合があります。この場合 Apply 動詞は、ゾーン内のすべての EditorPart コントロールに対する変更をすべて、サーバーコントロールに汎用的に適用します。

使用例

ApplyVerb プロパティへのアクセス方法を次のコード例に示します。宣言を使用した方法とプログラムを使用した方法の 2 とおりの方法を紹介します。例の実行に必要なコード全体については、EditorZoneBase クラスの概要のトピックで「例」を参照してください。

コード例の最初の部分は、Web ページで、宣言を使用して ApplyVerb プロパティにアクセスする方法を示しています。この例では、動詞のテキストをカスタマイズしています。

Visual Basic

<aspSample:MyEditorZone ID="EditorZone1" runat="server">
  <ApplyVerb Text="Apply Changes" />
  <CancelVerb Text="Cancel Changes" />
  <OKVerb Text="Finished" />
  <ZoneTemplate>
    <asp:AppearanceEditorPart ID="AppearanceEditorPart1"
 
      runat="server" />
    <asp:LayoutEditorPart ID="LayoutEditorPart1"
 
      runat="server" />
  </ZoneTemplate>
</aspSample:MyEditorZone>

<aspSample:MyEditorZone ID="EditorZone1" runat="server">
  <ApplyVerb Text="Apply Changes" />
  <CancelVerb Text="Cancel Changes" />
  <OKVerb Text="Finished" />
  <ZoneTemplate>
    <asp:AppearanceEditorPart ID="AppearanceEditorPart1" 
      runat="server" />
    <asp:LayoutEditorPart ID="LayoutEditorPart1" 
      runat="server" />
  </ZoneTemplate>
</aspSample:MyEditorZone>

コード例の 2 番目の部分は、ApplyVerb プロパティを有効または無効に切り替えるためのトグルボタンを使用して、プログラムからこのプロパティにアクセスする方法を示しています。

Visual Basic

Sub Button1_Click(ByVal sender As
 Object, ByVal e As EventArgs)
  If EditorZone1.ApplyVerb.Enabled Then
    EditorZone1.ApplyVerb.Enabled = False
  Else
    EditorZone1.ApplyVerb.Enabled = True
  End If
End Sub

void Button1_Click(object sender, EventArgs e)
{
  if (EditorZone1.ApplyVerb.Enabled)
    EditorZone1.ApplyVerb.Enabled = false;
  else
    EditorZone1.ApplyVerb.Enabled = true;
}

ブラウザでページを読み込む場合、ドロップダウンリストコントロールから [編集モード] を選択して、編集モードに切り替えることができます。コントロールのいずれかのタイトルバーで動詞メニュー (下向きの矢印) をクリックし、[編集] をクリックすることにより、選択されたコントロールを編集できます。EditorZone コントロールおよび編集 UI が表示されている場合、Apply 動詞を表すボタンを確認できます。次に [Toggle ApplyVerb Enabled] ボタンをクリックして、そのコントロールを有効または無効にできます。