アプリケーション ドロワー (PRIM_MD.AppDrawer)

ナビゲーションのオプションを表示するポップアップ サイドバー

祖先 - パネル (PRIM_PANL) コンテナ (PRIM_CPST) コントロール (PRIM_CTRL) オブジェクト (PRIM_OBJT)

詳細

アプリケーションのドロワーは、一緒に作動する複数のコントロールのまとまりで、一般的なモバイル・アプリケーションのフレームワークを作ります。
 
通常ドロワーは左側に配置され、メニューとして使用されます。小さい画面サイズの場合は必要に応じて開いたり、閉じたりしますが、大きめの画面の場合は常に利用できるようにすることができます。
 
その他のコントロールとしては、次のようなものがあります。
 
アプリケーション タイトルバー: アプリケーションのヘッダーとして使用します。
 
ビューコンテナ: アプリケーション内の複数のビューの管理・整理に使用します。
 
アプリケーション ビュー: アプリケーション機能の表示に使用します。
 
アプリケーション ダイアログ: エディターとして使用します。
 
ナビゲーション ボタン: アプリケーション ドロー上のメニュー アイテムととして利用します。

以下は、様々なパーツがやり取りする様子を簡単に示したものです。
 
実際のアプリケーションでは、ビューが再利用可能パーツになります。
Begin_Com Role(*EXTENDS #PRIM_WEB) Theme(#SYS_THEME) LayoutManager(#LayoutMain)
 
   Define_Com Class(#PRIM_TBLO) Name(#LayoutMain)
   Define_Com Class(#PRIM_TBLO.Column) Name(#LayoutMainColumn1) DisplayPosition(1) Parent(#LayoutMain) Units(Content) Width(220)
   Define_Com Class(#PRIM_TBLO.Column) Name(#LayoutMainColumn2) DisplayPosition(2) Parent(#LayoutMain)
   Define_Com Class(#PRIM_TBLO.Row) Name(#LayoutMainRow1) DisplayPosition(1) Parent(#LayoutMain) Height(56) Units(Pixels)
   Define_Com Class(#PRIM_TBLO.Row) Name(#LayoutMainRow2) DisplayPosition(2) Parent(#LayoutMain)
   Define_Com Class(#PRIM_TBLO.Item) Name(#LayoutMainItem1) Column(#LayoutMainColumn1) Manage(#AppBar) Parent(#LayoutMain) Row(#LayoutMainRow1) ColumnSpan(2)
   Define_Com Class(#PRIM_TBLO.Item) Name(#LayoutMainItem2) Column(#LayoutMainColumn1) Manage(#AppDrawer) Parent(#LayoutMain) Row(#LayoutMainRow2) Sizing(FitToHeight)
   Define_Com Class(#PRIM_TBLO.Item) Name(#LayoutMainItem3) Column(#LayoutMainColumn2) Manage(#ViewContainer) Parent(#LayoutMain) Row(#LayoutMainRow2)
 
   Define_Com Class(#PRIM_TBLO) Name(#LayoutAppDrawer)
   Define_Com Class(#PRIM_TBLO.Column) Name(#LayoutAppDrawerColumn1) DisplayPosition(1) Parent(#LayoutAppDrawer)
   Define_Com Class(#PRIM_TBLO.Row) Name(#LayoutAppDrawerRow1) DisplayPosition(1) Parent(#LayoutAppDrawer)
   Define_Com Class(#PRIM_TBLO.Item) Name(#LayoutAppDrawerItem1) Alignment(TopCenter) Column(#LayoutAppDrawerColumn1) Flow(Down) Manage(#NavButton1) Parent(#LayoutAppDrawer) Row(#LayoutAppDrawerRow1) Sizing(FitToWidth)
   Define_Com Class(#PRIM_TBLO.Item) Name(#LayoutAppDrawerItem2) Alignment(TopCenter) Column(#LayoutAppDrawerColumn1) Flow(Down) Manage(#NavButton2) Parent(#LayoutAppDrawer) Row(#LayoutAppDrawerRow1) Sizing(FitToWidth)
 
   Define_Com Class(#PRIM_TBLO.Item) Name(#LayoutAppDrawerItem3) Alignment(TopCenter) Column(#LayoutAppDrawerColumn1) Flow(Down) Manage(#NavButton3) Parent(#LayoutAppDrawer) Row(#LayoutAppDrawerRow1) Sizing(FitToWidth)
 
   Define_Com Class(#PRIM_MD.AppBar) Name(#AppBar) DisplayPosition(1) Parent(#COM_OWNER) TabPosition(1) TabStop(False) Width(1200) ThemeDrawStyle('Heading1') CaptionMarginLeft(15) Caption('TITLE') CaptionMarginBottom(0) CaptionMarginRight(0) CaptionMarginTop(0) Icon('menu')
   Define_Com Class(#PRIM_MD.AppDrawer) Name(#AppDrawer) DisplayPosition(2) Parent(#COM_OWNER) TabPosition(2) TabStop(False) Top(56) Height(744) LayoutManager(#LayoutAppDrawer) ThemeDrawStyle('MediumTitle') Width(220)
   Define_Com Class(#PRIM_MD.ViewContainer) Name(#ViewContainer) DisplayPosition(3) Left(220) Parent(#COM_OWNER) TabPosition(3) TabStop(False) Top(56) Height(744) Width(980)
 
   Define_Com Class(#PRIM_MD.NavButton) Name(#NavButton1) Caption('View 1') CaptionAlignment(CenterLeft) CaptionMarginLeft(16) DisplayPosition(1) IconMarginLeft(16) Left(0) Parent(#AppDrawer) TabPosition(1) TabStop(False) Top(0) Width(219) Height(48) Icon('view_quilt') Manage(#View1)
   Define_Com Class(#PRIM_MD.NavButton) Name(#NavButton2) Caption('View 2') CaptionAlignment(CenterLeft) CaptionMarginLeft(16) DisplayPosition(2) IconMarginLeft(16) Left(0) Parent(#AppDrawer) TabPosition(3) TabStop(False) Top(48) Width(219) Height(48) Icon('view_quilt') Manage(#View2)
   Define_Com Class(#PRIM_MD.NavButton) Name(#NavButton3) Caption('View 3') CaptionAlignment(CenterLeft) CaptionMarginLeft(16) DisplayPosition(3) IconMarginLeft(16) Left(0) Parent(#AppDrawer) TabPosition(2) TabStop(False) Top(96) Width(219) Height(48) Icon('view_quilt') Manage(#View3)
 
   * Views
   Define_Com Class(#PRIM_View) Name(#View1) Height(744) Parent(#ViewContainer) TabStop(False) Width(980) DisplayPosition(1) TabPosition(1)
   Define_Com Class(#PRIM_View) Name(#View2) Height(744) Left(326) Parent(#ViewContainer) TabStop(False) Width(980) DisplayPosition(2) TabPosition(2)
   Define_Com Class(#PRIM_View) Name(#View3) Height(744) Parent(#ViewContainer) TabStop(False) Width(980) Left(652) DisplayPosition(3) TabPosition(3)
 
   Define_Com Class(#prim_md.Label) Name(#View1Text) Caption('View 1') Parent(#View1) DisplayPosition(1) TabPosition(1)
   Define_Com Class(#prim_md.Label) Name(#View2Text) Caption('View 2') Parent(#View2) DisplayPosition(1) TabPosition(1)
   Define_Com Class(#prim_md.Label) Name(#View3Text) Caption('View 3') Parent(#View3) DisplayPosition(1) TabPosition(1)
 
   Evtroutine Handling(#AppBar.IconClick)
 
      #AppDrawer.ToggleDrawer
 
   Endroutine
 
   Evtroutine Handling(#Sys_Web.DeviceChanged)
 
      If (#Sys_Web.Device = Mobile)
 
         #AppDrawer.DrawerStyle := SlideInLeft
 
      Else
 
         #AppDrawer.DrawerStyle := Permanent
 
      Endif
 
Endroutine
 
End_Com

プロパティ

名前記述
BusyUpdatesBusyUpdates はコントロールがそれ自身をどのようにしてアップデートするかを指定します。 コントロール (PRIM_CTRL) より継承
BusyUpdatesOfParentBusyUpdatesOfParent は親のコントロールが更新するかどうかを指定します。 コントロール (PRIM_CTRL) より継承
CanFocusCanFocus はコントロールがキーボード フォーカスを受け取れるかどうかを示す値を返します。 コントロール (PRIM_CTRL) より継承
ComponentClassNameコンポーネントのクラス名です。 オブジェクト (PRIM_OBJT) より継承
ComponentControlsComponentControls はコンポーネントに含まれるコントロールのコレクションです。 コンテナ (PRIM_CPST) より継承
ComponentMembersこのコンポーネントの全てにアクセスできるようにします。 オブジェクト (PRIM_OBJT) より継承
ComponentPatternNameコンポーネントのクラスを制限します。 オブジェクト (PRIM_OBJT) より継承
ComponentTagインスタンス用に値を格納できる汎用スペース オブジェクト (PRIM_OBJT) より継承
ComponentTypeComponentType ではコンポーネントのタイプ情報にアクセスできます。 オブジェクト (PRIM_OBJT) より継承
ComponentTypeNameComponentTypeName 十分適格なコンポーネントのクラス名です。 オブジェクト (PRIM_OBJT) より継承
CursorCursor のイメージを指定するためのプロパティです。 コントロール (PRIM_CTRL) より継承
DesignManagerこのパネル用のデザイン マネージャへの参照 パネル (PRIM_PANL) より継承
DisableNoScrollDisableNoScroll はスクロールバーの表示を制御します。 パネル (PRIM_PANL) より継承
DisplayPositionDisplayPosition に表示の位置を指定します。 コントロール (PRIM_CTRL) より継承
DragStyleDragStyle はどのようにコンポーネントがドラッグされるかを決めます。 コントロール (PRIM_CTRL) より継承
DrawerStyleドロワーの表示方法を指定します
EnableChildrenEnableChildren は、親が有効なプロパティを設定するかどうかを指定します。 コンテナ (PRIM_CPST) より継承
EnabledEnabled はコンポーネントを使用可能/使用不可にするためのプロパティです。 コントロール (PRIM_CTRL) より継承
FixedPosition親がスクールされても移動しないよう、コントロールを固定します コントロール (PRIM_CTRL) より継承
FocusFocus はコンポーネントにフォーカスがあるかどうかを判断するためのプロパティです。 コントロール (PRIM_CTRL) より継承
FocusedStyleコントロールにフォーカスがある時に適用するスタイルへの参照 コントロール (PRIM_CTRL) より継承
FocusedStylesコントロールにフォーカスがある時に適用するスタイルのコレクション コントロール (PRIM_CTRL) より継承
Handleデスクトップ アプリケーション内の Windows ハンドルを返します コントロール (PRIM_CTRL) より継承
HeightHeight コンポーネントの高さを設定するためのプロパティです。 コントロール (PRIM_CTRL) より継承
HintHint はコンポーネントの記述を設定するためのプロパティです。 コントロール (PRIM_CTRL) より継承
HintPopupHintPopup は省略値のポップアップ テキストの代わりに ポップアップパネル (#prim_ppnl) インスタンスが利用できるようにします。 コントロール (PRIM_CTRL) より継承
HintShowHintShow はヒントを表示するためのプロパティです。 コントロール (PRIM_CTRL) より継承
HintShowOfParentHintShowOfParent はコンテナの HintShow プロパティを参照するためのプロパティです。 コントロール (PRIM_CTRL) より継承
HintTitleHintTitle ヒント ウィンドウの上部に強調文字で表示されるテキストを指定します。 コントロール (PRIM_CTRL) より継承
HorizontalScrollHorizontalScroll は水平スクロールバーを表示するかどうかを設定するためのプロパティです。 パネル (PRIM_PANL) より継承
HorizontalScrollIncHorizontalScrollInc は、水平方向のスクロールバーのピクセル単位の増加量を指定します。 パネル (PRIM_PANL) より継承
HorizontalScrollPosHorizontalScrollPos 水平方向のスクロールバーの位置を設定します。 パネル (PRIM_PANL) より継承
HorizontalScrollRemainder現在のスクロール位置から右の残りをピクセル単位で指定します パネル (PRIM_PANL) より継承
ImageImage はコンポーネントに使用するイメージを設定するためのプロパティです。 パネル (PRIM_PANL) より継承
ImageAlignmentAlignment プロパティを指定してコンポーネントを整列します。 パネル (PRIM_PANL) より継承
IsAnimatingIsAnimating は現在コントロールがアニメーションで表示されていることを示します。 コントロール (PRIM_CTRL) より継承
IsRealizedデザイン インスタンスが実施されると TRUE になります。 コントロール (PRIM_CTRL) より継承
IsShowingアプリ ドロワーが表示されている場合 TRUE を返します
LayoutManager子コントロールの位置の制御に使用されるレイアウト マネージャへの参照 パネル (PRIM_PANL) より継承
LeftLeft はコンポーネントの左側の位置を設定するためのプロパティです。 コントロール (PRIM_CTRL) より継承
ModifiedModified はコントロールの内容が変更されていることを知らすためのプロパティです。 コントロール (PRIM_CTRL) より継承
MouseOverMouseOver マウスがコントロールの真上にあるかどうかを決定します。 コントロール (PRIM_CTRL) より継承
MouseOverPartカーソルが子コンポーネントの境界内にある場合 TRUE コンテナ (PRIM_CPST) より継承
MouseOverStyleMouseOverStyle マウスが真上にある時にコントロールに適用するスタイル (#Prim_vs.Style) を定義します。 コントロール (PRIM_CTRL) より継承
MouseOverStylesMouseOverStyles マウスが真上にある時にコントロールに適用するスタイル集 (#Prim_vs.Style)です。 コントロール (PRIM_CTRL) より継承
Nameコンポーネントの名前 オブジェクト (PRIM_OBJT) より継承
OpacityOpacity はコントロールと背景の表示関係を表します。 コントロール (PRIM_CTRL) より継承
Ownerコンポーネントのオーナーです。 オブジェクト (PRIM_OBJT) より継承
Parentこのコントロールがビジュアル的に位置しているコントロールへの参照 コントロール (PRIM_CTRL) より継承
PopupPopup は通常の右クリックのポップアップ メニューの代わりにポップアップパネル (#prim_ppnl) インスタンスが利用できるようにします。 コントロール (PRIM_CTRL) より継承
PopupMenu右クリックで表示されるポップアップ メニューへの参照 コントロール (PRIM_CTRL) より継承
PrivateStyleコントロールに適用されたが、子コントロールに継承されないスタイル コンテナ (PRIM_CPST) より継承
PrivateStylesコントロールに適用されたが、子コントロールに継承されないスタイルのコレクション コンテナ (PRIM_CPST) より継承
RenderStyleコントロールのレンダリングに DirectX、または Win32 を使用する、もしくは親に従うかを定義 パネル (PRIM_PANL) より継承
RotationRotation は指定の原点の周りをコントロールが回転できるようにします。 コントロール (PRIM_CTRL) より継承
RotationOriginLeftRotationOriginLeft はコントロールがその周りを回転する想定地点の左座標を指定します。 コントロール (PRIM_CTRL) より継承
RotationOriginTopRotationOriginTop はコントロールがその周りを回転する想定地点の上座標を指定します。 コントロール (PRIM_CTRL) より継承
ScaleHeightScaleHeight はコントロールのビジュアル表示で使用する高さをパーセントで示します。 コントロール (PRIM_CTRL) より継承
ScaleOriginLeftScaleOriginLeft はコントロールのサイズ調整時の想定開始地点の左座標を指定します。 コントロール (PRIM_CTRL) より継承
ScaleOriginTopScaleOriginTop はコントロールのサイズ調整時の想定開始地点の上座標を指定します。 コントロール (PRIM_CTRL) より継承
ScaleWidthScaleWidth はコントロールのビジュアル表示で使用する幅をパーセントで示します。 コントロール (PRIM_CTRL) より継承
ScreenLeftScreenLeft はスクリーンの左側からの距離を設定します。 コントロール (PRIM_CTRL) より継承
ScreenTopScreenTop はスクリーンの上部からの距離を設定します。 コントロール (PRIM_CTRL) より継承
ScrollLeftスクロールされた子コントロールの (親コントロールに対して) 左の位置 コントロール (PRIM_CTRL) より継承
ScrollTopスクロールされた子コントロールの (親コントロールに対して) 上の位置 コントロール (PRIM_CTRL) より継承
SkewLeftSkewLeft はコントロールを水平方向に傾ける角度を定義します。 コントロール (PRIM_CTRL) より継承
SkewOriginLeftSkewOriginLeft はコントロール傾斜時の想定開始地点の左座標を指定します。 コントロール (PRIM_CTRL) より継承
SkewOriginTopSkewOriginTop はコントロール傾斜時の想定開始地点の上座標を指定します。 コントロール (PRIM_CTRL) より継承
SkewTopSkewTop はコントロールを垂直方向に傾ける角度を定義します。 コントロール (PRIM_CTRL) より継承
StyleStyle はコントロールに適用するスタイル (#Prim_vs.Style) を定義します。 コントロール (PRIM_CTRL) より継承
Stylesコントロールに適用するスタイルのコレクション コントロール (PRIM_CTRL) より継承
TabPositionTabPosition はフォーカスの順番を指定するためのプロパティです。 コントロール (PRIM_CTRL) より継承
TabStopTabStop は Tab キーによってフォーカスをもつことを設定するためのプロパティです。 コントロール (PRIM_CTRL) より継承
ThemeBackgroundマテリアル デザイン テーマを持つアプリケーション用のテーマ背景 パネル (PRIM_PANL) より継承
ThemeDrawStyleテーマが使用された時にフォームをどのように表示するかを定義 パネル (PRIM_PANL) より継承
ThemeStyleテーマが使用された時にコントロールをどのように表示するかを定義 パネル (PRIM_PANL) より継承
TopTop はコンポーネントの上側の位置を設定するためのプロパティです。 コントロール (PRIM_CTRL) より継承
TouchMoveタッチ移動処理にコントロールがどう対応するかを決定します。 コントロール (PRIM_CTRL) より継承
TouchRotateタッチ回転にコントロールがどう対応するかを決定します。 コントロール (PRIM_CTRL) より継承
TouchScaleタッチ サイズ変更にコントロールがどう対応するかを決定します。 コントロール (PRIM_CTRL) より継承
TouchSizeコントロールをサイズ調整可能にするかどうかを決定します。 コントロール (PRIM_CTRL) より継承
VerticalScrollVerticalScroll 垂直スクロールバーを表示するかどうかを設定するためのプロパティです。 パネル (PRIM_PANL) より継承
VerticalScrollIncVerticalScrollInc は、垂直方向のスクロールバーのピクセル単位の増加量を指定します。 パネル (PRIM_PANL) より継承
VerticalScrollPosVerticalScrollPos は垂直方向のスクロールバーの位置を設定します。 パネル (PRIM_PANL) より継承
VerticalScrollRemainder現在のスクロール位置から左下までの残りをピクセル単位で指定します パネル (PRIM_PANL) より継承
VisibleVisible はコンポーネントを表示/非表示するためのプロパティです。 コントロール (PRIM_CTRL) より継承
VisualStyleVisualStyle はコンポーネントの表示構成を設定するためのプロパティです。 コントロール (PRIM_CTRL) より継承
VisualStyleOfParentVisualStyleOfParent はコンテナの VisualStyle プロパティを参照するためのプロパティです。 コントロール (PRIM_CTRL) より継承
WidthWidth はコンポーネントの幅を設定するためのプロパティです。 コントロール (PRIM_CTRL) より継承

イベント

名前記述
AnimationEndedアニメーション終了時に起動します コントロール (PRIM_CTRL) より継承
Cancelled
ClickClick イベントはマウスがクリックされた時に実行されます。 コントロール (PRIM_CTRL) より継承
Origin, Handled
CreateInstanceコンポーネントを作成する時に CreateInstance のイベントを実行します。 コントロール (PRIM_CTRL) より継承
DesignChangedデザインがアクティブ化されると起動されます コントロール (PRIM_CTRL) より継承
Design, DesignManager
DestroyInstanceコンポーネントが解除される前に DestroyInstance のイベントを実行します。 コントロール (PRIM_CTRL) より継承
DoubleClickDoubleClick イベントはマウスをタブル クリックした時に実行されます。 コントロール (PRIM_CTRL) より継承
Origin, Handled
DragDropDragDrop イベントはコンポーネントがドロップされる時に実行されます。 コントロール (PRIM_CTRL) より継承
PosX, PosY, Source, Payload, AggregatedSource, Origin, Handled, DragResult
DragOverカーソルがコントロールの上を移動するドラッグ アンド ドロップ処理中に起動されます。 コントロール (PRIM_CTRL) より継承
PosX, PosY, Source, Payload, DragState, AcceptDrop, DragCursor, ShowDropHilight, AggregatedSource, Origin, Handled
EndDragEndDrag はドラッグ アンド ドロップが完了した時に実行されます。 コントロール (PRIM_CTRL) より継承
Source, Payload, DragResult, AggregatedSource, Origin, Handled
Enterコントロールで Enter キーが押されると起動します コントロール (PRIM_CTRL) より継承
KeyCode, Char, IsAltDown, IsControlDown, IsShiftDown, Handled
InitializeInitialize はコンポーネントをロードする時に実行されます。 コントロール (PRIM_CTRL) より継承
KeyPressキーボードでキー押下時に起動します。 コントロール (PRIM_CTRL) より継承
KeyCode, Char, IsAltDown, IsControlDown, IsShiftDown, Handled
MouseEnterコントロールの境界内にマウスが入りました。 コントロール (PRIM_CTRL) より継承
MouseHoverマウスがコントロール上でホバリングしました。 コントロール (PRIM_CTRL) より継承
Origin, Handled
MouseLeaveマウスがコントロールの境界から出ました。 コントロール (PRIM_CTRL) より継承
ScrollChanged複合コントロール内のスクロールバーが移動されると起動されます。 コントロール (PRIM_CTRL) より継承
Orientation
SizeChangedパネルのサイズ変更時に起動されます コントロール (PRIM_CTRL) より継承
StartDragStartDrag はマウスをドラッグした時に実行されます。 コントロール (PRIM_CTRL) より継承
Source, Payload, Continue, DragList, AggregatedSource, Origin, Handled
TouchChangeTouchStart と TouchEnd の境界で繰り返し起動され、タッチ イベントの詳細を提供します。 コントロール (PRIM_CTRL) より継承
MoveLeft, MoveTop, ScaleWidth, ScaleHeight, Rotation, Continue
TouchEndユーザーのタッチが終了した時に起動します。 コントロール (PRIM_CTRL) より継承
TouchStartユーザーにより画面に物理的な接触が最初に行われた時に起動します。 コントロール (PRIM_CTRL) より継承
Origin, TouchMove, TouchRotate, TouchScale, TouchSize

メソッド

名前記述
CloseDrawerアプリ ドロワーを閉じます
FadeIn非表示から表示へのアニメーション コントロール (PRIM_CTRL) より継承
Duration, Delay
FadeOut表示から非表示へのアニメーション コントロール (PRIM_CTRL) より継承
Duration, Delay, Visible
HorizontalScrollTo子コントロールを使用して、水平スクロール位置を設定します。 パネル (PRIM_PANL) より継承
Control, ScrollPosition
MoveFromコントロールを指定位置から現在の位置に移動 コントロール (PRIM_CTRL) より継承
Left, Top, Duration, Delay
MoveTo指定されたピクセル数の移動をアニメーション化 コントロール (PRIM_CTRL) より継承
Left, Top, Duration, Delay
RealizeRealize は動的にコンポーネントを作成するためのメソッドです。 コントロール (PRIM_CTRL) より継承
Scaleサイズの変化をアニメーション化 コントロール (PRIM_CTRL) より継承
ScaleWidth, ScaleHeight, Duration, Delay
SetFocusSetFocus はコンポーネントにフォーカスをするためのメソッドです。 コントロール (PRIM_CTRL) より継承
ShowDrawerアプリ ドロワーを表示させます
ShowMessagesLANSA 内部専用 コントロール (PRIM_CTRL) より継承
SizeTo コントロール (PRIM_CTRL) より継承
Width, Height, Duration, Delay
ToggleDrawerアプリ ドロワーの表示または非表示
Transitionコントロール間の変遷をアニメーション化 コンテナ (PRIM_CPST) より継承
From, To, TransitionType, Duration, Delay
UnrealizeUnrealize メソッドはコンポーネントを削除するためのメソッドです。 コントロール (PRIM_CTRL) より継承
UpdateDisplayUpdateDisplay メソッドは画面を直ちに更新します。 コントロール (PRIM_CTRL) より継承
VerticalScrollTo子コントロールを使用して、垂直スクロール位置を設定します。 パネル (PRIM_PANL) より継承
Control, ScrollPosition

参照

すべてのコンポーネント クラス

テクニカルリファレンス

EPC142030 February 2019