MediaPlayerElement クラス
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
MediaPlayer を使用してオーディオとビデオをディスプレイにレンダリングするオブジェクトを表します。
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 196608)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class MediaPlayerElement : Control[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 196608)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public class MediaPlayerElement : ControlPublic Class MediaPlayerElement
Inherits Control<MediaPlayerElement .../>
- 継承
- 属性
Windows の要件
| デバイス ファミリ |
Windows 10 Anniversary Edition (10.0.14393.0 で導入)
|
| API contract |
Windows.Foundation.UniversalApiContract (v3.0 で導入)
|
例
先端
詳細、設計ガイダンス、およびコード例については、「メディア再生
WinUI 2 ギャラリー アプリがインストールされている場合は、ここをクリックしてアプリを開 、MediaPlayerElement の動作を確認します。
このコードでは、
<MediaPlayerElement Source="ms-appx:///Media/video1.mp4" AutoPlay="True" />
次の使用例は、トランスポート コントロールを有効にして MediaPlayerElement を作成します。
<MediaPlayerElement x:Name="mediaPlayer"
Source="ms-appx:///Media/video1.mp4"
AreTransportControlsEnabled="True" />
この例では、ポップアップで MediaPlayerElement を使用する方法を示します。
<Grid>
<Button Content="Show Popup" Click="ShowPopupClicked"/>
<Popup x:Name="mediaPlayerPopup">
<StackPanel Height="1400" Width="1400" Background="Blue">
<MediaPlayerElement x:Name="mediaPlayer"
AreTransportControlsEnabled="True"
Source="ms-appx:///Media/Intro.wmv"/>
<TextBlock Text="Simple Popup"/>
<Button Content="Close" Click="ClosePopupClicked"/>
</StackPanel>
</Popup>
</Grid>
long token;
protected override void OnNavigatedTo(NavigationEventArgs e)
{
token = mediaPlayer.RegisterPropertyChangedCallback(MediaPlayerElement.IsFullWindowProperty, OnMPEFullWindowChanged);
base.OnNavigatedTo(e);
}
protected override void OnNavigatedFrom(NavigationEventArgs e)
{
mediaPlayer.UnregisterPropertyChangedCallback(MediaPlayerElement.IsFullWindowProperty, token);
}
private void OnMPEFullWindowChanged(DependencyObject sender, DependencyProperty dp)
{
MediaPlayerElement mpe = (MediaPlayerElement)sender;
if (mpe != null && dp == MediaPlayerElement.IsFullWindowProperty)
{
if (mpe.IsFullWindow == true)
{
mediaPlayerPopup.Visibility = Visibility.Collapsed;
}
else
{
mediaPlayerPopup.Visibility = Visibility.Visible;
}
}
}
private void ClosePopupClicked(object sender, RoutedEventArgs e)
{
// If the Popup is open, then close it.
if (mediaPlayerPopup.IsOpen) { mediaPlayerPopup.IsOpen = false; }
}
// Handles the Click event on the Button on the page and opens the Popup.
private void ShowPopupClicked(object sender, RoutedEventArgs e)
{
// Open the Popup if it isn't open already.
if (!mediaPlayerPopup.IsOpen) { mediaPlayerPopup.IsOpen = true; }
}
注釈
先端
詳細、設計ガイダンス、およびコード例については、「メディア再生
MediaPlayerElement でサポートされるメディア形式については、「サポートされているコーデック
アーキテクチャの概要
MediaPlayerElement は、Windows.Media.Playback 名前空間の一部である堅牢な MediaPlayer クラスのレンダリング サーフェイスとして機能する軽量 XAML コントロールです。 メディア機能の大部分は、基になる MediaPlayer クラスにあり、MediaPlayerElement.MediaPlayer プロパティを介してアクセスできます。
MediaElement から MediaPlayerElement に移行する方法に関するガイドラインなど、MediaPlayer クラスの詳細については、「Media playback」ページを参照してください。
メディア ソースを設定する
MediaPlayerElement の Source プロパティを、オーディオ ファイルまたはビデオ ファイルを指すよう設定します。 これを、
既定では、Source プロパティで定義されているメディアは、MediaPlayerElement オブジェクトが読み込まれた直後には再生されません。 メディアの再生を自動的に開始するには、
アプリに含まれるビデオ ファイルのパスに
<MediaPlayerElement Source="ms-appx:///Media/video1.mp4" AutoPlay="True"/>
コードで MediaPlayerElement を作成する方法を次に示します。
MediaPlayerElement mediaPlayerElement1 = new MediaPlayerElement();
mediaPlayerElement1.Source = MediaSource.CreateFromUri(new Uri("ms-appx:///Media/video1.mp4"));
mediaPlayerElement1.AutoPlay = true;
基になるメディア プレーヤーを設定する
MediaPlayerElement で Source プロパティまたは AutoPlay プロパティを設定すると、基になる MediaPlayer がまだ存在しない場合は自動的に作成されます。 または、独自の MediaPlayer を作成し、SetMediaPlayer メソッドを使用して MediaPlayerElement に設定することもできます。 次に、基になる MediaPlayer をコードで設定する方法の例を示します。
<MediaPlayerElement x:Name="mpe"/>
MediaPlayer mediaPlayer = new MediaPlayer();
mpe.SetMediaPlayer(mediaPlayer);
mpe.Source = MediaSource.CreateFromUri(new Uri("ms-appx:///Media/video1.mp4"));
mpe.AutoPlay = true;
手記
MediaPlayerElement プロパティを設定すると、基になる MediaPlayerに対応するプロパティが設定されます。 MediaPlayerElement プロパティを使用する代わりに、基になる MediaPlayer を直接使用することもできます。
MediaPlayer を使用すると、同等の MediaPlayerElement プロパティを直接使用すると、予期しない動作が発生する可能性があることに注意してください。 これは、MediaPlayerElement が基になる MediaPlayerに発生するすべてのものを認識していないためです。 たとえば、mediaPlayerでソース
基になるメディア プレーヤーをデタッチする
SetMediaPlayerを使用して mediaPlayerElement で MediaPlayer が設定されている場合は、MediaPlayer が適切に閉じられているかどうかを確認する必要があります。 これを行わないと、mediaPlayerで致命的な再生エラー
<MediaPlayerElement x:Name="mpe"/>
MediaPlayer mediaPlayer = mpe.MediaPlayer;
IMediaPlaybackSource source = mpe.Source;
// 1. Pause playback if able.
if (mediaPlayer.PlaybackSession.CanPause)
{
mediaPlayer.Pause();
}
// 2. Disconnect the MediaPlayer from its source. This can be done by setting
// the MediaPlayerElement Source property to null or by directly setting the
// source to null on the underlying MediaPlayer.
mpe.Source = null;
// 3. Disconnect the MediaPlayer from MediaPlayerElement.
mpe.SetMediaPlayer(null);
// 4. Dispose of the MediaPlayer or Source if they're no longer needed.
if (source is MediaSource mediaSource)
{
mediaSource.Dispose();
}
mediaPlayer.Dispose();
メディア イベントの処理
MediaOpened、MediaEnded、MediaFailedなど、基になる MediaPlayer にある一般的なメディア イベントに応答できます。 ソースを
トランスポート コントロール
AreTransportControlsEnabled プロパティを設定して、MediaPlayerElement の組み込みトランスポート コントロールをプログラムで有効または無効にします。 組み込みのトランスポート コントロールには、メディアの再生、停止、一時停止、シークのための UI と、ボリューム、ミュート、フル ウィンドウ、トラック選択、クローズド キャプション、残り時間の UI が用意されています。
独自のメディア トランスポート コントロールを作成するには、AreTransportControlsEnabled
先端
パフォーマンスを向上させるには、頻繁な位置の更新 (進行状況バーなど) を反映するために、Position プロパティへのデータ バインディングを回避します。 代わりに、DispatcherTimer を使用して、Position プロパティに対してクエリを実行します。
詳細と例については、「カスタム トランスポート コントロールを作成する」を参照してください。
フル ウィンドウ再生
IsFullWindow プロパティを使用して、フル ウィンドウ レンダリングを有効または無効にします。 フル ウィンドウ モードの場合、ユーザーアクションが検出されなくなったときに、ディスプレイが自動的に非アクティブ化されなくなります。
手記
ポップアップ コントロールでは MediaPlayerElement を使用しないことをお勧めします。
ポップアップ でホストされている MediaPlayerElement がフル ウィンドウ モードに切り替えると、Popup が MediaPlayerElement の上にレンダリングされます。
ポップアップで MediaPlayerElement を使用する必要がある場合は、MediaPlayerElement がフル ウィンドウ モードになったときに ポップアップ を折りたたみ、MediaPlayerElement が全ウィンドウ モードを終了したときに ポップアップ を復元する必要があります。
メディアの再生を維持する
MediaPlayerElement がフル ウィンドウ モードでない場合に表示が非アクティブにならないように、DisplayRequest.RequestActive
表示要求を解放する必要がある状況を次に示します。
- ビデオの再生は、たとえば、帯域幅が制限されているため、ユーザーの操作、バッファリング、調整によって一時停止されます。
- 再生が停止します。 たとえば、ビデオの再生が完了しているか、プレゼンテーションが終了したとします。
- 再生エラーが発生しました。 たとえば、ネットワーク接続の問題やファイルの破損などです。
ここでは、PlaybackStateChanged イベントを使用して、これらの状況を検出します。 次に、MediaPlayer.PlaybackSession の NaturalVideoHeight プロパティを使用して、オーディオ ファイルまたはビデオ ファイルが再生されているかどうかを判断し、ビデオが再生されている場合にのみ画面をアクティブな状態に保ちます。
<MediaPlayerElement x:Name="mpe" Source="ms-appx:///Media/video1.mp4"/>
// Create this variable at a global scope. Set it to null.
private DisplayRequest appDisplayRequest = null;
protected override void OnNavigatedTo(NavigationEventArgs e)
{
mpe.MediaPlayer.PlaybackSession.PlaybackStateChanged += MediaPlayerElement_CurrentStateChanged;
base.OnNavigatedTo(e);
}
private void MediaPlayerElement_CurrentStateChanged(MediaPlaybackSession sender, object args)
{
MediaPlaybackSession playbackSession = sender as MediaPlaybackSession;
if (playbackSession != null && playbackSession.NaturalVideoHeight != 0)
{
if(playbackSession.PlaybackState == MediaPlaybackState.Playing)
{
if(appDisplayRequest == null)
{
// This call creates an instance of the DisplayRequest object
appDisplayRequest = new DisplayRequest();
appDisplayRequest.RequestActive();
}
}
else // PlaybackState is Buffering, None, Opening, or Paused.
{
if(appDisplayRequest != null)
{
// Deactivate the display request and set the var to null.
appDisplayRequest.RequestRelease();
appDisplayRequest = null;
}
}
}
}
ポスター ソース
PosterSource プロパティを使用すると、メディアが読み込まれる前またはオーディオのみのメディアの再生中に、MediaPlayerElement に視覚的な表現を提供できます。 . PosterSource は、スクリーン ショット、映画ポスター、アルバム カバーなどの画像であり、メディアの代わりに表示されます。 PosterSource は、次の状況で表示されます。
- 有効なソースが設定されていない場合。 たとえば、ソース が設定されていない
、ソース が nullを に設定された 、またはソースが無効です ( MediaFailed イベントが発生したときと同様)。 - メディアの読み込み中。 たとえば、有効なソースが設定されていても、MediaOpened イベントはまだ発生していません。
- メディアが別のデバイスにストリーミングされている場合。
- メディアがオーディオのみの場合。
コンストラクター
| MediaPlayerElement() |
MediaPlayerElement クラスの新しいインスタンスを初期化します。 |
プロパティ
| AccessKey |
この要素のアクセス キー (ニーモニック) を取得または設定します。 (継承元 UIElement) |
| AccessKeyScopeOwner |
ソース要素のビジュアル ツリーにない場合でも、この要素のアクセス キー スコープを提供するソース要素を取得または設定します。 (継承元 UIElement) |
| ActualHeight |
FrameworkElementのレンダリングされた高さを取得します。 「解説」を参照してください。 (継承元 FrameworkElement) |
| ActualOffset |
レイアウト プロセスの配置パス中に計算された、親を基準としたこの UIElement の位置を取得します。 (継承元 UIElement) |
| ActualSize |
レイアウト プロセスの配置パス中にこの UIElement が計算したサイズを取得します。 (継承元 UIElement) |
| ActualTheme |
要素によって現在使用されている UI テーマを取得します。これは、RequestedThemeとは異なる場合があります。 (継承元 FrameworkElement) |
| ActualWidth |
FrameworkElementのレンダリングされた幅を取得します。 「解説」を参照してください。 (継承元 FrameworkElement) |
| AllowDrop |
この UIElement をドラッグ アンド ドロップ操作の目的でドロップ 先にできるかどうかを決定する値を取得または設定します。 (継承元 UIElement) |
| AllowFocusOnInteraction |
ユーザーが要素を操作するときに要素が自動的にフォーカスを取得するかどうかを示す値を取得または設定します。 (継承元 FrameworkElement) |
| AllowFocusWhenDisabled |
無効なコントロールがフォーカスを受け取ることができるかどうかを取得または設定します。 (継承元 FrameworkElement) |
| AreTransportControlsEnabled |
標準トランスポート コントロールが有効かどうかを決定する値を取得または設定します。 |
| AreTransportControlsEnabledProperty |
AreTransportControlsEnabled 依存関係プロパティ |
| AutoPlay |
Source プロパティが設定されているときにメディアの再生を自動的に開始するかどうかを示す値を取得または設定します。 |
| AutoPlayProperty |
自動再生 依存関係プロパティを識別します。 |
| Background |
コントロールの背景を提供するブラシを取得または設定します。 (継承元 Control) |
| BackgroundSizing |
この要素の境界線に対する背景の延長距離を示す値を取得または設定します。 (継承元 Control) |
| BaseUri |
XAML の読み込み時に XAML で構築されたオブジェクトのベース Uri (Uniform Resource Identifier) を表す URI (Uniform Resource Identifier) を取得します。 このプロパティは、実行時の URI (Uniform Resource Identifier) 解決に役立ちます。 (継承元 FrameworkElement) |
| BorderBrush |
コントロールの境界線の塗りつぶしを記述するブラシを取得または設定します。 (継承元 Control) |
| BorderThickness |
コントロールの境界線の太さを取得または設定します。 (継承元 Control) |
| CacheMode |
レンダリングされたコンテンツを可能な限り複合ビットマップとしてキャッシュする必要があることを示す値を取得または設定します。 (継承元 UIElement) |
| CanBeScrollAnchor |
UIElement をスクロール アンカーの候補にできるかどうかを示す値を取得または設定します。 (継承元 UIElement) |
| CanDrag |
ドラッグ アンド ドロップ操作で要素をデータとしてドラッグできるかどうかを示す値を取得または設定します。 (継承元 UIElement) |
| CenterPoint |
要素の中心点 (回転またはスケーリングが行われる点) を取得または設定します。 要素のレンダリング位置に影響します。 (継承元 UIElement) |
| CharacterSpacing |
em の 1/1000 単位で文字間の均一な間隔を取得または設定します。 (継承元 Control) |
| Clip |
UIElementの内容のアウトラインを定義するために使用する RectangleGeometry を取得または設定します。 (継承元 UIElement) |
| CompositeMode |
親レイアウトとウィンドウ内の要素の代替コンポジションモードとブレンド モードを宣言するプロパティを取得または設定します。 これは、混合 XAML/Microsoft DirectX UI に関係する要素に関連します。 (継承元 UIElement) |
| ContextFlyout |
この要素に関連付けられているポップアップを取得または設定します。 (継承元 UIElement) |
| CornerRadius |
コントロールの境界線の角の半径を取得または設定します。 (継承元 Control) |
| DataContext |
FrameworkElementのデータ コンテキストを取得または設定します。 データ コンテキストの一般的な用途は、FrameworkElement が {Binding} マークアップ拡張機能を使用し、データ バインディングに参加する場合です。 (継承元 FrameworkElement) |
| DefaultStyleKey |
コントロールの既定のスタイルを参照するキーを取得または設定します。 カスタム コントロールの作成者は、このプロパティを使用して、コントロールが使用するスタイルの既定値を変更します。 (継承元 Control) |
| DefaultStyleResourceUri |
コントロールの既定のスタイルを含むリソース ファイルへのパスを取得または設定します。 (継承元 Control) |
| DesiredSize |
この UIElement レイアウト プロセスのメジャー パス中に計算されるサイズを取得します。 (継承元 UIElement) |
| Dispatcher |
このオブジェクトが関連付けられている CoreDispatcher を取得します。 CoreDispatcher は、コードが非 UI スレッドによって開始された場合でも、UI スレッド上の DependencyObject にアクセスできる機能を表します。 (継承元 DependencyObject) |
| ElementSoundMode |
サウンドを再生するかどうかのコントロールの設定を指定する値を取得または設定します。 (継承元 Control) |
| ExitDisplayModeOnAccessKeyInvoked |
アクセス キーの呼び出し時にアクセス キーの表示を閉じるかどうかを指定する値を取得または設定します。 (継承元 UIElement) |
| FlowDirection |
レイアウトを制御する任意の親要素内でテキストやその他の UI 要素が流れる方向を取得または設定します。 このプロパティは、LeftToRight |
| FocusState |
このコントロールにフォーカスがあるかどうかを示す値と、フォーカスが取得されたモードを取得します。 (継承元 Control) |
| FocusVisualMargin |
FrameworkElementのフォーカス ビジュアルの外側の余白を取得または設定します。 (継承元 FrameworkElement) |
| FocusVisualPrimaryBrush |
FrameworkElementの |
| FocusVisualPrimaryThickness |
FrameworkElementの |
| FocusVisualSecondaryBrush |
FrameworkElementの |
| FocusVisualSecondaryThickness |
FrameworkElementの |
| FontFamily |
コントロール内のテキストを表示するために使用するフォントを取得または設定します。 (継承元 Control) |
| FontSize |
このコントロール内のテキストのサイズを取得または設定します。 (継承元 Control) |
| FontStretch |
画面でフォントを縮小または展開する度合いを取得または設定します。 (継承元 Control) |
| FontStyle |
テキストをレンダリングするスタイルを取得または設定します。 (継承元 Control) |
| FontWeight |
指定したフォントの太さを取得または設定します。 (継承元 Control) |
| Foreground |
前景色を表すブラシを取得または設定します。 (継承元 Control) |
| Height |
FrameworkElementの推奨高さを取得または設定します。 (継承元 FrameworkElement) |
| HighContrastAdjustment |
ハイ コントラスト テーマが有効な場合に、フレームワークが要素のビジュアル プロパティを自動的に調整するかどうかを示す値を取得または設定します。 (継承元 UIElement) |
| HorizontalAlignment |
パネルや項目コントロールなどのレイアウト親で構成されている場合に FrameworkElement に適用される水平方向の配置特性を取得または設定します。 (継承元 FrameworkElement) |
| HorizontalContentAlignment |
コントロールのコンテンツの水平方向の配置を取得または設定します。 (継承元 Control) |
| IsAccessKeyScope |
要素が独自のアクセス キー スコープを定義するかどうかを示す値を取得または設定します。 (継承元 UIElement) |
| IsDoubleTapEnabled |
DoubleTapped イベントがその要素から発生するかどうかを決定する値を取得または設定します。 (継承元 UIElement) |
| IsEnabled |
ユーザーがコントロールを操作できるかどうかを示す値を取得または設定します。 (継承元 Control) |
| IsFocusEngaged |
コントロールの境界内でフォーカスが制限されているかどうかを示す値を取得または設定します (ゲーム パッド/リモート操作の場合)。 (継承元 Control) |
| IsFocusEngagementEnabled |
コントロールの境界内でフォーカスを制限できるかどうかを示す値を取得または設定します (ゲーム パッド/リモート操作の場合)。 (継承元 Control) |
| IsFullWindow |
MediaPlayerElement がフル ウィンドウ モードでレンダリングされるかどうかを示す値を取得または設定します。 |
| IsFullWindowProperty |
IsFullWindow 依存関係プロパティ |
| IsHitTestVisible |
この UIElement の包含領域がヒット テストの true 値を返すことができるかどうかを取得または設定します。 (継承元 UIElement) |
| IsHoldingEnabled |
Holding イベントがその要素から発生するかどうかを決定する値を取得または設定します。 (継承元 UIElement) |
| IsLoaded |
要素が要素ツリーに追加され、操作の準備ができているかどうかを示す値を取得します。 (継承元 FrameworkElement) |
| IsRightTapEnabled |
RightTapped イベントがその要素から発生するかどうかを決定する値を取得または設定します。 (継承元 UIElement) |
| IsTabStop |
コントロールがタブ ナビゲーションに含まれるかどうかを示す値を取得または設定します。 (継承元 Control) |
| IsTapEnabled |
Tapped イベントがその要素から発生するかどうかを決定する値を取得または設定します。 (継承元 UIElement) |
| IsTextScaleFactorEnabled |
システム テキスト サイズの設定を反映するために、自動テキスト拡大を有効にするかどうかを取得または設定します。 (継承元 Control) |
| KeyboardAcceleratorPlacementMode |
コントロール ツールヒント、関連付けられているキーボード アクセラレータのキーの組み合わせを表示するかどうかを示す値を取得または設定します。 (継承元 UIElement) |
| KeyboardAcceleratorPlacementTarget |
アクセラレータ キーの組み合わせを表示するツールヒント |
| KeyboardAccelerators |
キーボードを使用してアクションを呼び出すキーの組み合わせのコレクションを取得します。 アクセラレータは通常、ボタンまたはメニュー項目に割り当てられます。
|
| KeyTipHorizontalOffset |
UIElement に関連してキー ヒントを配置する距離を示す値を取得または設定します。 (継承元 UIElement) |
| KeyTipPlacementMode |
UIElement の境界に対してアクセス キー キー ヒントが配置される場所を示す値を取得または設定します。 (継承元 UIElement) |
| KeyTipTarget |
アクセス キーのキー ヒントの対象となる要素を示す値を取得または設定します。 (継承元 UIElement) |
| KeyTipVerticalOffset |
UI 要素に対してキー ヒントを配置する距離を示す値を取得または設定します。 (継承元 UIElement) |
| Language |
FrameworkElementに適用されるローカライズ/グローバリゼーション言語情報と、オブジェクト表現および UI 内の現在の FrameworkElement のすべての子要素に適用されるローカライズ/グローバリゼーション言語情報を取得または設定します。 (継承元 FrameworkElement) |
| Lights |
この要素にアタッチ XamlLight オブジェクトのコレクションを取得します。 (継承元 UIElement) |
| ManipulationMode |
UIElement の動作とジェスチャとの対話に使用される |
| Margin |
FrameworkElementの外部余白を取得または設定します。 (継承元 FrameworkElement) |
| MaxHeight |
FrameworkElementの最大高さ制約を取得または設定します。 (継承元 FrameworkElement) |
| MaxWidth |
FrameworkElementの最大幅制約を取得または設定します。 (継承元 FrameworkElement) |
| MediaPlayer |
メディアのレンダリングに使用 MediaPlayer インスタンスを取得します。 |
| MediaPlayerProperty |
MediaPlayer 依存関係プロパティを識別します。 |
| MinHeight |
FrameworkElementの最小高さの制約を取得または設定します。 (継承元 FrameworkElement) |
| MinWidth |
FrameworkElementの最小幅制約を取得または設定します。 (継承元 FrameworkElement) |
| Name |
オブジェクトの識別名を取得または設定します。 XAML プロセッサが XAML マークアップからオブジェクト ツリーを作成する場合、ランタイム コードはこの名前で XAML で宣言されたオブジェクトを参照できます。 (継承元 FrameworkElement) |
| Opacity |
オブジェクトの不透明度を取得または設定します。 (継承元 UIElement) |
| OpacityTransition |
Opacity プロパティへの変更をアニメーション化する ScalarTransition を取得または設定します。 (継承元 UIElement) |
| Padding |
コントロール内のパディングを取得または設定します。 (継承元 Control) |
| Parent |
オブジェクト ツリー内のこの FrameworkElement の親オブジェクトを取得します。 (継承元 FrameworkElement) |
| PointerCaptures |
ポインター 値として表される、キャプチャされたすべてのポインターのセットを取得します。 (継承元 UIElement) |
| PosterSource |
MediaPlayerElement 読み込み遷移状態の間にプレースホルダー イメージに使用されるイメージ ソースを取得または設定します。 |
| PosterSourceProperty |
PosterSource 依存関係プロパティを識別します。 |
| Projection |
この要素をレンダリングするときに適用するパースペクティブ プロジェクション (3-D 効果) を取得または設定します。 (継承元 UIElement) |
| RenderSize |
UIElementの最終的なレンダリング サイズを取得します。 使用は推奨されません。「解説」を参照してください。 (継承元 UIElement) |
| RenderTransform |
UIElementのレンダリング位置に影響する変換情報を取得または設定します。 (継承元 UIElement) |
| RenderTransformOrigin |
UIElementの境界を基準に RenderTransformによって宣言された、可能なレンダー変換の原点を取得または設定します。 (継承元 UIElement) |
| RequestedTheme |
リソースの決定に UIElement (およびその子要素) によって使用される UI テーマを取得または設定します。 RequestedTheme で指定した UI テーマは、RequestedTheme |
| RequiresPointer |
UI 要素がマウス モードをサポートするかどうかを取得または設定します。これは、ゲーム パッドやリモート コントロールなどのポインター以外の入力デバイスでポインターの操作エクスペリエンスをエミュレートします。 (継承元 Control) |
| Resources |
ローカルで定義されたリソース ディクショナリを取得します。 XAML では、XAML の暗黙的なコレクション構文を使用して、 |
| Rotation |
時計回りの回転角度を度単位で取得または設定します。 RotationAxis と CenterPoint を基準に回転します。 要素のレンダリング位置に影響します。 (継承元 UIElement) |
| RotationAxis |
要素を回転させる軸を取得または設定します。 (継承元 UIElement) |
| RotationTransition |
Rotation プロパティへの変更をアニメーション化する ScalarTransition を取得または設定します。 (継承元 UIElement) |
| Scale |
要素のスケールを取得または設定します。 要素の CenterPoint を基準にして拡大縮小します。 要素のレンダリング位置に影響します。 (継承元 UIElement) |
| ScaleTransition |
Scale プロパティへの変更をアニメーション化する Vector3Transition を取得または設定します。 (継承元 UIElement) |
| Shadow |
要素によってキャストされるシャドウ効果を取得または設定します。 (継承元 UIElement) |
| Source |
MediaPlayerElementのメディア ソースを取得または設定します。 |
| SourceProperty |
ソース 依存関係プロパティを識別します。 |
| Stretch |
MediaPlayerElement を拡張して目的の四角形を塗りつぶす方法を示す値を取得または設定します。 |
| StretchProperty |
Stretch 依存関係プロパティを識別します。 |
| Style |
レイアウトとレンダリング中にこのオブジェクトに適用されるインスタンス Style を取得または設定します。 (継承元 FrameworkElement) |
| TabFocusNavigation |
このコントロールの TabIndex のタブ移動と |
| TabIndex |
ユーザーが Tab キーを使用してアプリ UI 内を移動したときに要素がフォーカスを受け取る順序を示す値を取得または設定します。 (継承元 Control) |
| TabNavigation |
このコントロールの TabIndex のタブ移動と 手記 Windows 10 Creators Update (ビルド 10.0.15063) 以降では、ControlTemplateを使用しないオブジェクトをタブ シーケンスに含めるために、UIElement 基本クラスで TabFocusNavigation プロパティを使用できます。 |
| Tag |
このオブジェクトに関するカスタム情報を格納するために使用できる任意のオブジェクト値を取得または設定します。 (継承元 FrameworkElement) |
| Template |
コントロール テンプレートを取得または設定します。 コントロール テンプレートは、UI でコントロールの外観を定義し、XAML マークアップで定義します。 (継承元 Control) |
| Transform3D |
この要素をレンダリングするときに適用する 3-D 変換効果を取得または設定します。 (継承元 UIElement) |
| TransformMatrix |
要素に適用する変換行列を取得または設定します。 (継承元 UIElement) |
| Transitions |
UIElementに適用される Transition スタイル要素のコレクションを取得または設定します。 (継承元 UIElement) |
| Translation |
要素の x、y、z のレンダリング位置を取得または設定します。 (継承元 UIElement) |
| TranslationTransition |
Translation プロパティへの変更をアニメーション化する Vector3Transition を取得または設定します。 (継承元 UIElement) |
| TransportControls |
メディアのトランスポート コントロールを取得または設定します。 |
| Triggers |
FrameworkElementに対して定義されているアニメーションのトリガーのコレクションを取得します。 一般的には使用されません。 「解説」を参照してください。 (継承元 FrameworkElement) |
| UIContext |
要素のコンテキスト識別子を取得します。 (継承元 UIElement) |
| UseLayoutRounding |
オブジェクトとそのビジュアル サブツリーのレンダリングで、レンダリングをピクセル全体に合わせた丸め動作を使用するかどうかを決定する値を取得または設定します。 (継承元 UIElement) |
| UseSystemFocusVisuals |
システムによって描画されるフォーカス ビジュアルとコントロール テンプレートで定義されたフォーカス ビジュアルのどちらをコントロールが使用するかを示す値を取得または設定します。 (継承元 Control) |
| VerticalAlignment |
パネルや項目コントロールなどの親オブジェクトで構成されている場合に、FrameworkElement に適用される垂直方向の配置特性を取得または設定します。 (継承元 FrameworkElement) |
| VerticalContentAlignment |
コントロールのコンテンツの垂直方向の配置を取得または設定します。 (継承元 Control) |
| Visibility |
UIElementの可視性を取得または設定します。 表示されない UIElement はレンダリングされず、目的のサイズがレイアウトに伝達されません。 (継承元 UIElement) |
| Width |
FrameworkElementの幅を取得または設定します。 (継承元 FrameworkElement) |
| XamlRoot |
この要素が表示される |
| XYFocusDown |
ユーザーが方向パッド (D パッド) を押したときにフォーカスを取得するオブジェクトを取得または設定します。 (継承元 Control) |
| XYFocusDownNavigationStrategy |
ダウン ナビゲーションのターゲット要素を決定するために使用する戦略を指定する値を取得または設定します。 (継承元 UIElement) |
| XYFocusKeyboardNavigation |
キーボード方向矢印を使用してナビゲーションを有効または無効にする値を取得または設定します。 (継承元 UIElement) |
| XYFocusLeft |
ユーザーが方向パッド (D パッド) を左に押したときにフォーカスを取得するオブジェクトを取得または設定します。 (継承元 Control) |
| XYFocusLeftNavigationStrategy |
左ナビゲーションのターゲット要素を決定するために使用する戦略を指定する値を取得または設定します。 (継承元 UIElement) |
| XYFocusRight |
ユーザーが方向パッド (D パッド) を右に押したときにフォーカスを取得するオブジェクトを取得または設定します。 (継承元 Control) |
| XYFocusRightNavigationStrategy |
右ナビゲーションのターゲット要素を決定するために使用する戦略を指定する値を取得または設定します。 (継承元 UIElement) |
| XYFocusUp |
ユーザーが方向パッド (D パッド) を上に押したときにフォーカスを取得するオブジェクトを取得または設定します。 (継承元 Control) |
| XYFocusUpNavigationStrategy |
アップ ナビゲーションのターゲット要素を決定するために使用する戦略を指定する値を取得または設定します。 (継承元 UIElement) |
メソッド
イベント
| AccessKeyDisplayDismissed |
アクセス キーを表示しなくなったときに発生します。 (継承元 UIElement) |
| AccessKeyDisplayRequested |
ユーザーがアクセス キーの表示を要求したときに発生します。 (継承元 UIElement) |
| AccessKeyInvoked |
ユーザーがアクセス キー シーケンスを完了したときに発生します。 (継承元 UIElement) |
| ActualThemeChanged |
ActualTheme プロパティの値が変更されたときに発生します。 (継承元 FrameworkElement) |
| BringIntoViewRequested |
StartBringIntoView |
| CharacterReceived |
1 つの構成済み文字が入力キューで受信されたときに発生します。 (継承元 UIElement) |
| ContextCanceled |
コンテキスト入力ジェスチャが操作ジェスチャに続き、コンテキスト ポップアップを開くべきではないことを要素に通知するときに発生します。 (継承元 UIElement) |
| ContextRequested |
ユーザーが右クリックなどのコンテキスト入力ジェスチャを完了したときに発生します。 (継承元 UIElement) |
| DataContextChanged |
FrameworkElement.DataContext プロパティの値が変更されたときに発生します。 (継承元 FrameworkElement) |
| DoubleTapped |
それ以外の場合は、この要素のヒット テスト領域で DoubleTap の相互作用が発生 |
| DragEnter |
入力システムが、この要素をターゲットとして基になるドラッグ イベントを報告するときに発生します。 (継承元 UIElement) |
| DragLeave |
この要素を原点として基になるドラッグ イベントを入力システムが報告するときに発生します。 (継承元 UIElement) |
| DragOver |
この要素を潜在的なドロップ ターゲットとして使用して、基になるドラッグ イベントを入力システムが報告するときに発生します。 (継承元 UIElement) |
| DragStarting |
ドラッグ操作が開始されたときに発生します。 (継承元 UIElement) |
| Drop |
入力システムが、この要素をドロップ ターゲットとして持つ基になるドロップ イベントを報告するときに発生します。 (継承元 UIElement) |
| DropCompleted |
ソースが終了したときに、この要素を使用したドラッグ アンド ドロップ操作が発生します。 (継承元 UIElement) |
| EffectiveViewportChanged |
|
| FocusDisengaged |
コントロールの境界からフォーカスが離されたときに発生します (ゲーム パッド/リモート操作の場合)。 (継承元 Control) |
| FocusEngaged |
コントロールの境界内でフォーカスが制限されている場合に発生します (ゲーム パッド/リモート操作の場合)。 (継承元 Control) |
| GettingFocus |
UIElement がフォーカスを受け取る前に発生します。 このイベントは、イベントのバブル中にフォーカスが移動されないように同期的に発生します。 (継承元 UIElement) |
| GotFocus |
UIElement がフォーカスを受け取ったときに発生します。 このイベントは非同期的に発生するため、バブルが完了する前にフォーカスを再び移動できます。 (継承元 UIElement) |
| Holding |
この要素のヒット テスト領域で、それ以外の場合はハンドルされない Hold の相互作用が発生したときに発生します。 (継承元 UIElement) |
| IsEnabledChanged |
IsEnabled プロパティが変更されたときに発生します。 (継承元 Control) |
| KeyDown |
UIElement にフォーカスがあるときにキーボード キーが押されたときに発生します。 (継承元 UIElement) |
| KeyUp |
UIElement にフォーカスがあるときにキーボード キーが離されたときに発生します。 (継承元 UIElement) |
| LayoutUpdated |
レイアウト関連のプロパティが値を変更したり、レイアウトを更新するその他のアクションが原因で、ビジュアル ツリーのレイアウトが変更されたときに発生します。 (継承元 FrameworkElement) |
| Loaded |
FrameworkElement が構築され、オブジェクト ツリーに追加され、操作の準備ができたときに発生します。 (継承元 FrameworkElement) |
| Loading |
FrameworkElement の読み込みが開始されたときに発生します。 (継承元 FrameworkElement) |
| LosingFocus |
UIElement がフォーカスを失う前に発生します。 このイベントは、イベントのバブル中にフォーカスが移動されないように同期的に発生します。 (継承元 UIElement) |
| LostFocus |
UIElement がフォーカスを失ったときに発生します。 このイベントは非同期的に発生するため、バブルが完了する前にフォーカスを再び移動できます。 (継承元 UIElement) |
| ManipulationCompleted |
UIElement の操作が完了したときに発生します。 (継承元 UIElement) |
| ManipulationDelta |
操作中に入力デバイスの位置が変更されたときに発生します。 (継承元 UIElement) |
| ManipulationInertiaStarting |
操作中に入力デバイスが UIElement オブジェクトとの接触を失い、慣性が開始されたときに発生します。 (継承元 UIElement) |
| ManipulationStarted |
入力デバイスが UIElementで操作を開始したときに発生します。 (継承元 UIElement) |
| ManipulationStarting |
操作プロセッサが最初に作成されたときに発生します。 (継承元 UIElement) |
| NoFocusCandidateFound |
ユーザーが (タブまたは方向矢印を使用して) フォーカスを移動しようとしたが、移動方向にフォーカス候補が見つからないため、フォーカスが移動しない場合に発生します。 (継承元 UIElement) |
| PointerCanceled |
接触したポインターが異常に接触を失ったときに発生します。 (継承元 UIElement) |
| PointerCaptureLost |
この要素によって以前に保持されていたポインター キャプチャが別の要素または別の場所に移動したときに発生します。 (継承元 UIElement) |
| PointerEntered |
ポインターがこの要素のヒット テスト領域に入ったときに発生します。 (継承元 UIElement) |
| PointerExited |
ポインターがこの要素のヒット テスト領域から離れると発生します。 (継承元 UIElement) |
| PointerMoved |
ポインターがこの要素のヒット テスト領域内に残っている間にポインターが移動したときに発生します。 (継承元 UIElement) |
| PointerPressed |
ポインター デバイスがこの要素内で Press アクションを開始したときに発生します。 (継承元 UIElement) |
| PointerReleased |
以前に Press アクションを開始したポインター デバイスが、この要素内で解放されたときに発生します。 Press アクションの終了が PointerReleased イベントを発生させる保証はありません。その他のイベントが発生する可能性があります。 詳細については、「解説」を参照してください。 (継承元 UIElement) |
| PointerWheelChanged |
ポインター ホイールのデルタ値が変更されたときに発生します。 (継承元 UIElement) |
| PreviewKeyDown |
UIElement にフォーカスがあるときにキーボード キーが押されたときに発生します。 (継承元 UIElement) |
| PreviewKeyUp |
UIElement にフォーカスがあるときにキーボード キーが離されたときに発生します。 (継承元 UIElement) |
| ProcessKeyboardAccelerators |
キーボード ショートカット (またはアクセラレータ) が押されたときに発生します。 (継承元 UIElement) |
| RightTapped |
ポインターが要素の上にある間に右タップ入力刺激が発生したときに発生します。 (継承元 UIElement) |
| SizeChanged |
ActualHeight または ActualWidth プロパティが、FrameworkElementの値を変更したときに発生します。 (継承元 FrameworkElement) |
| Tapped |
それ以外の場合は、この要素のヒット テスト領域で Tap 操作が発生 |
| Unloaded |
このオブジェクトがメイン オブジェクト ツリーに接続されなくなったときに発生します。 (継承元 FrameworkElement) |
適用対象
こちらもご覧ください
フィードバック
以下は間もなく提供いたします。2024 年を通じて、コンテンツのフィードバック メカニズムとして GitHub の issue を段階的に廃止し、新しいフィードバック システムに置き換えます。 詳細については、「https://aka.ms/ContentUserFeedback」を参照してください。
フィードバックの送信と表示